alloydb-agent-mode-quickstart

Provisions AlloyDB agent pools and deploys AI data agents or multi-agent swarms on Vertex AI Agent Engine and Gemini Enterprise. Three capabilities: (1) provision an AlloyDB agent pool over Private Service Connect (PSC) using gcloud (and AlloyDB MCP tools when configured); (2) deploy a single agent querying the pool over MCP (get_schema, execute_sql_read_only) with optional per-session writable PostgreSQL scratch databases (Cloud Run Agent Workspace); (3) deploy an agent swarm with a coordinator that fans questions across parallel worker sessions. Use when the user wants to set up an AlloyDB agent pool, or deploy, update, validate, register in Gemini Enterprise, or tear down a data agent or agent swarm on an AlloyDB database (the agent generates and manages ./<name>.alloydb-agent.yaml automatically). Don't use for standard non-agent AlloyDB administration or standalone SQL query tuning.

Version

0.1-preview

License

Apache-2.0

Compatibility

Self-contained (all scripts and assets are under scripts/ and assets/). Requires an authenticated gcloud CLI, Python 3.11+, bash, and Google Cloud network access. Uses preview GCP APIs (Agent Engine PSC interface). Step 5 additionally requires a Gemini Enterprise subscription or trial, a global-location app, and Gemini Enterprise Admin + Discovery Engine Admin roles.