\r \r

Dialogflow CX Agents\r

\r Manage Google Dialogflow CX agents via REST API.\r \r

Prerequisites\r

\r

• Google Cloud project with Dialogflow CX API enabled\r
• Service account or OAuth credentials with Dialogflow API access\r
• gcloud CLI authenticated OR bearer token\r \r

Authentication\r

\r

Option 1: gcloud CLI (recommended)\r

gcloud auth application-default login\r
TOKEN=$(gcloud auth print-access-token)\r
```\r
\r
### Option 2: Service Account\r
```bash\r
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"\r
TOKEN=$(gcloud auth application-default print-access-token)\r
```\r
\r
## API Base URL\r
\r
```\r
https://dialogflow.googleapis.com/v3beta1\r
```\r
\r
Regional endpoints available:\r
- `https://{region}-dialogflow.googleapis.com` (e.g., `us-central1`, `europe-west1`)\r
\r
## Common Operations\r
\r
### List Agents\r
```bash\r
curl -X GET \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents" \\r
  -H "Authorization: Bearer ${TOKEN}"\r
```\r
\r
### Create Agent\r
```bash\r
curl -X POST \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents" \\r
  -H "Authorization: Bearer ${TOKEN}" \\r
  -H "Content-Type: application/json" \\r
  -d '{\r
    "displayName": "My Agent",\r
    "defaultLanguageCode": "en",\r
    "timeZone": "Asia/Kolkata"\r
  }'\r
```\r
\r
### Get Agent\r
```bash\r
curl -X GET \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents/${AGENT_ID}" \\r
  -H "Authorization: Bearer ${TOKEN}"\r
```\r
\r
### Update Agent\r
```bash\r
curl -X PATCH \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents/${AGENT_ID}" \\r
  -H "Authorization: Bearer ${TOKEN}" \\r
  -H "Content-Type: application/json" \\r
  -d '{\r
    "displayName": "Updated Agent Name"\r
  }'\r
```\r
\r
### Delete Agent\r
```bash\r
curl -X DELETE \\r
  "https://dialogflow.googleapis.com/v3beta1/projects/${PROJECT_ID}/locations/${LOCATION}/agents/${AGENT_ID}" \\r
  -H "Authorization: Bearer ${TOKEN}"\r
```\r
\r
## Key Resources\r
\r
| Resource | Description |\r
|----------|-------------|\r
| **Agents** | Top-level container for flows, intents, entity types |\r
\r
## Quick Reference\r
\r
For detailed API reference:\r
- **Agents**: See [references/agents.md](references/agents.md)\r
\r
## Scripts\r
\r
- `scripts/agents.py` — CLI wrapper for agent management operations\r
\r
### Usage\r
```bash\r
python scripts/agents.py list --project PROJECT_ID --location LOCATION\r
python scripts/agents.py create --project PROJECT_ID --location LOCATION --name "My Agent"\r
python scripts/agents.py get --project PROJECT_ID --location LOCATION --agent AGENT_ID\r
python scripts/agents.py update --agent AGENT_NAME --name "New Name"\r
python scripts/agents.py delete --agent AGENT_NAME\r
```\r
\r
## Tips\r
\r
- Use `locations/global` for multi-region agents\r
- Agent IDs are generated automatically on creation