> ## Documentation Index
> Fetch the complete documentation index at: https://docs.akua.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Examples
> Concrete examples of how hosted agents can guide deployment, infrastructure choices, investigations, and reviewable changes
These examples show the intended feel of hosted agents: a user describes an outcome, the agent gathers context, uses the right tools, and turns the result into a reviewable next step. Some examples combine API resources that are available now with dashboard experiences that are still being productized.
## Deploy a repository
`Deploy github.com/acme/helpdesk to staging. It needs Postgres and should be reachable at helpdesk-staging.example.com.`
It reads the project files, detects the runtime, finds required environment variables, and identifies the database dependency.
It renders a short form for the domain, environment variables, and deployment target instead of asking you to write a manifest.
It prepares the package, deployment configuration, and install changes, then asks for approval before applying anything sensitive.
```text Conversation theme={null}
You: Deploy this repository to staging.
Agent: I found a Node app with a Postgres dependency. I can create a staging install,
generate the deployment config, and set up the database connection.
[Form: deployment target, domain, missing environment variables]
Agent: I prepared a repository change request with the package config and install values.
[Approval: Create staging install]
```
## Pick cost-efficient compute
Agents can use external data tools when the decision depends on live market data. Akua's [Hetzner Value Auctions](https://auction.akua.dev/) tool indexes dedicated server auctions, CPU benchmarks, memory, disks, locations, and price so an agent can recommend hardware before a user buys it.
```text Conversation theme={null}
You: I need a cheap worker for Postgres. At least 64 GB RAM, NVMe preferred, under 50 EUR/month.
Agent: I’ll compare current auction servers against that workload.
Agent: Best fit right now:
1. 64 GB RAM, NVMe storage, strong single-thread score, under your budget.
Good fit for Postgres and small multi-tenant workloads.
2. 128 GB RAM option, slightly more expensive.
Better if you expect large indexes or want more cache headroom.
I recommend option 1 for the current workload. Want me to add it as a worker
candidate for your cluster, or save it for later review?
[Choice: Add worker candidate] [Save recommendation] [Show details]
```
The user gets a recommendation in the same deployment flow. The agent can explain the tradeoff in plain language, or show CPU models, disk layout, datacenter, hourly cost, and benchmark scores for advanced users.
## Investigate a failing install
```text Conversation theme={null}
You: Why did the customer install fail after the last update?
Agent: I’ll compare the current install, recent change request history, deployment events,
and logs.
Agent: The install started failing after the latest values change removed
DATABASE_URL from the runtime environment. There is already a stale change request that
adds it back and updates the secret reference.
[Card: Existing change request found]
[Choice: Continue change request] [Create new change request] [Only summarize]
```
This is why agents need read access to existing repository change requests. They can avoid duplicate work, continue a previous attempt, or explain why a change request should be replaced.
## Watch production signals
Ambient agents are useful when the right time to ask for help is before a human opens the chat.
```text Ambient event theme={null}
Signal: production install failed twice in 10 minutes
Agent: I started a read-only investigation for the failed production install.
Findings:
- The new version is healthy in staging.
- Production fails only in one region.
- The failing pods cannot pull the image from the private registry.
Suggested next step:
Rotate the registry token for the affected workspace and retry the rollout.
[Approval: Create repository change request] [Open install] [Dismiss]
```
The agent is always available, but it does not need to consume expensive runtime resources while waiting. It starts work only when configured signals match policy.
## Related topics
See how the same agent adapts for beginners, advanced operators, and experts.
Connect local AI tools to Akua through Code Mode.
Define skills, policies, grants, and runtime behavior.
Understand sessions, retained runtimes, model budgets, and trigger limits.