# agents-cli | Google | Knowledge Base | Instagit

The CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.

GitHub Stars: 4.6k

Repository: https://github.com/google/agents-cli

---

## Articles

### [How to Build Multi-Agent Systems Using ADK's SequentialAgent, ParallelAgent, and LoopAgent with agents-cli](/google/agents-cli/how-to-build-multi-agent-systems-using-adk-agents)

Learn to build multi-agent systems with agents-cli and ADK's SequentialAgent, ParallelAgent, and LoopAgent. Discover deterministic workflows and seamless state passing for powerful agent compositions.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Upgrade Existing Projects Using agents-cli scaffold upgrade](/google/agents-cli/how-to-upgrade-existing-projects-with-scaffold-upgrade)

Safely upgrade your existing projects with agents-cli scaffold upgrade. This command merges template updates with your code, preserving customizations.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Troubleshoot Common agents-cli Deployment Failures (Cloud Run, GKE, Agent Runtime)](/google/agents-cli/how-to-troubleshoot-common-agents-cli-deployment-failures)

Troubleshoot common agents-cli deployment failures on Cloud Run and GKE. Learn to fix Dockerfile issues, ignore-file conflicts, environment variable conflicts, and IAM permission gaps quickly.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Synthesize Multi-Turn Evaluation Scenarios with agents-cli eval dataset synthesize](/google/agents-cli/how-to-synthesize-multi-turn-evaluation-scenarios-with-eval-dataset-synthesize)

Synthesize multi-turn evaluation scenarios for your ADK agent using agents-cli eval dataset synthesize. Generate test conversations and grade them with agents-cli eval grade for comprehensive testing.

- Tags: how-to-guide
- Published: 2026-07-02

### [How to Implement RAG with agents-cli: A Complete Guide to Retrieval-Augmented Generation](/google/agents-cli/how-to-implement-rag-with-agents-cli)

Learn to implement RAG with agents-cli by scaffolding a project and using adk-samples. Get a complete guide to Retrieval-Augmented Generation with this workflow.

- Tags: how-to-guide
- Published: 2026-07-01

### [How to Manage Secrets and Environment Variables for Different Agents-CLI Deployment Targets](/google/agents-cli/how-to-manage-secrets-and-env-vars-for-deployment-targets)

Master secrets and environment variables for agents-cli deployments. Learn a layered approach using .env files, Terraform, CI/CD, and runtime helpers for secure and efficient management across development and production.

- Tags: how-to-guide
- Published: 2026-07-01

### [How to Optimize Agent Prompts Using the GEPA Framework with agents-cli eval optimize](/google/agents-cli/how-to-optimize-agent-prompts-using-gepa-framework-with-eval-optimize)

Optimize agent prompts using the GEPA framework with agents-cli eval optimize. Iteratively rewrite your agent's system instruction against evaluation metrics for better performance.

- Tags: how-to-guide
- Published: 2026-07-01

### [How to Create and Register Custom Evaluation Metrics for agents-cli](/google/agents-cli/how-to-create-and-register-custom-evaluation-metrics)

Learn how to create and register custom evaluation metrics for agents cli. Define them in eval_config.yaml and run them with flags for seamless integration.

- Tags: how-to-guide
- Published: 2026-07-01

### [How to Implement Observability with Cloud Trace and Logging in agents-cli](/google/agents-cli/how-to-implement-observability-with-cloud-trace-and-logging-integrations)

Implement observability in agents-cli with Cloud Trace and logging. Automatically wire OpenTelemetry and send logs to GCS/BigQuery using environment variables.

- Tags: how-to-guide
- Published: 2026-07-01

### [How to Set Up CI/CD Pipelines with agents-cli infra cicd: Complete Guide](/google/agents-cli/how-to-set-up-ci-cd-pipelines-with-agents-cli-infra-cicd)

Easily set up CI/CD pipelines with agents-cli infra cicd. Provision GitHub repos, Terraform backends, and build runners like GitHub Actions or Cloud Build in one go.

- Tags: how-to-guide
- Published: 2026-07-01

### [How to Configure Deployment Targets (Agent Runtime, Cloud Run, GKE) in agents-cli-manifest.yaml](/google/agents-cli/how-to-configure-deployment-targets-in-agents-cli-manifest-yaml)

Configure deployment targets like agent runtime, Cloud Run, or GKE in agents-cli-manifest.yaml. Learn how to set the deployment_target field for your agent deployments.

- Tags: how-to-guide
- Published: 2026-07-01

### [How Lazy Command Loading Works in agents-cli's Click-Based Architecture](/google/agents-cli/how-does-lazy-command-loading-work-in-agents-cli-click-based-architecture)

Discover how lazy command loading in agents-cli defers heavy module imports until command invocation optimizing performance through its Click-based architecture.

- Tags: internals
- Published: 2026-07-01