Skip to main content
Connect the Google Cloud project that holds your CES apps, then test, edit, and publish their agents from Bluejay. The Google CES connection field with a CES deployment path The Google CES connection field with a CES deployment path

Connect

1

Set up the Google credential

In Bluejay, open Settings → Integrations and choose the Google Agents tab. CES uses the same credential as Dialogflow CX, so save one as that page describes. For keyless access, run the setup script with --ces, which grants the sync and run roles.
2

Grant the CES roles

Turn on the ces.googleapis.com API in the project, and give the service account the roles in the table below. The setup script does not grant the push and publish roles, so add them if you edit agents from Bluejay or use Self-Improve.
3

Sync the agents

Click Sync Agents from Google. Bluejay creates one agent for each deployment of each CES app, with the instructions, tools, and handoffs of the app version that the deployment serves. A later sync updates them, but never replaces a workflow that has edits you have not pushed yet.
You need roles/ces.toolsEditor only to change a tool’s description. If you prefer one role, roles/ces.admin covers every permission in the table. To connect one agent by hand instead of syncing, give it the Google CES connection type and set CES Deployment Path to . In CX Agent Studio, copy the Deployment ID from Deployed channels.

Edit an agent

1

Pull a version

On the synced agent’s Workflow tab, pull the version you want to start from: the one the deployment serves, the CES draft, or any saved version.
2

Edit and push

Change an agent’s name, instructions, tools, or handoffs, then push. A push always goes to the CES draft, so callers do not hear your edits yet.
3

Publish

Publish saves the draft as a new CES version and points the deployment you choose at it. Callers hear your edits from then on.
To add or remove an agent, or change the root agent, do it in CES and pull again. Bluejay rejects a push that does.

Test

The connection type on the agent decides whether you test by voice or by chat. In both, Bluejay replies {"status": "ok"} to each client-side tool call, and you cannot set a different response.
Choose the Google CES voice tile. Voice tests need no phone number and work for inbound agents only.

Self-Improve

Self-Improve works with the Google CES connection type. Each round rewrites the instructions of the agents in your CES app. Tools and handoffs stay as you configured them. After each round, Self-Improve saves the new instructions as a CES version and points the deployment at it. When the run finishes, the deployment serves the best instructions from the run. So start Self-Improve on the Bluejay agent of a deployment you use for testing.

Troubleshooting

Last modified on October 21, 2026