AQuA Agent Quality
Adds the AQuA quality agent to an agents-cli project and reads its insights.
Install
npx skills add google/adk-recipes --skill agents-cli-aqua -g -a claude-code -y- Repository
- google/adk-recipes10.6k
- Category
- AI and agents
- Updated
- 4d ago
- License
- Apache-2.0
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- No, instructions only
What it does
Work with the Ambient Quality Agent (AQuA) added to this agents-cli project: augment the agents-cli agent with AQuA or attach the agent to an AQuA deployed elsewhere, read the quality insights it finds in production conversations, get AQuA's root-cause diagnosis, read what the developer asked it to remember, and fix the defects in the agent's code. Propose proactively when the user mentions AQuA or AQA, wants to monitor the quality of a deployed agent, mentions traces or observability, asks what is going wrong with their agent in production, wants to fix AQuA insights, or wants to publish code metrics to AQuA. Don't use for offline evals of a local agent (use google-agents-cli-eval) or for deploys without AQuA (google-agents-cli-deploy).
AQuA with agents-cli
AQuA watches deployed agents, reviews their production conversations, and
records each distinct defect it finds as an insight. AQuA is deployed on
its own, and agents-cli aqua attach tells it which agent to watch and how
(see Deploy AQuA on its own and attach the agent).
agents-cli aqua queries it. With the AQuA extension,
agents-cli infra single-project --apply-aqua and
agents-cli deploy --deploy-aqua can also provision and deploy AQuA beside the
agent; without those two flags, both commands work on the agent alone.
Run every command from the agent's project root, the directory with
agents-cli-manifest.yaml, or from AQuA's checkout if AQuA was deployed from
there. Query subcommands print one JSON document on stdout
and progress on stderr, so pipe stdout into jq.
When you start using this skill, always run agents-cli aqua -- --help to
discover AQuA's commands, and agents-cli aqua <command> -- --help for a
command's flags and the fields of its JSON output. Without the --, agents-cli
prints its own help instead. Two
commands are missing from that list: agents-cli aqua info (the
deployment record and dashboard URL, or one value with --resource,
--region, --ui-service or --ui-url) and agents-cli aqua ui-proxy (see
Dashboard).
