Start with a recurring handoff
Our example is routing new service requests to the responsible team and preparing them for handling. The output contains the request, sourced facts, missing information and a draft reply. The responsible person decides on commitments. This simplifies the handoff without silently changing contracts or expectations.
An agent is more useful for recurring friction than for a one-off exception. First examine how often information is missing, tasks are rerouted or the same questions recur. That evidence defines the actual assignment.
The external trigger is a separate integration
The official documentation describes a published API channel and Workspace Agent access tokens. A standard Platform API key or a token scoped only to Codex is not interchangeable. The agent, channel, workspace setting and permission must align before the integration can start a run.
Accepted, completed, correct
The trigger API acknowledges accepted work with HTTP 202. Run-status polling is documented as beta; the source currently says the agent response itself cannot be retrieved through this API. A successful run status therefore does not replace checking that the correct service request was prepared.
- Run the same test normally and with a repeated event.
- Use a stable event identifier to prevent duplicate execution on retries.
- Check the destination result and deliberately exercise a failed handoff.
Define when the agent stops
For the pilot, we propose three stop conditions: conflicting customer data, a prohibited action and an unreachable destination. Each stop creates an understandable handoff to a person. An empty response must not mean “no open cases” while an access error is also possible.
Limit connected accounts to the necessary areas. Document who maintains the agent, how credentials are replaced and which manual process continues during an outage. These operating rules belong in pilot acceptance.
From pilot to connected process
Expand the sources or allowed actions only after normal cases and exceptions are handled traceably. Multiple systems benefit from a clear integration architecture: ownership, event handling, approval and evidence of the result are planned together.
The AI System Check helps identify whether your bottleneck concerns information, handoffs or execution. An AI Automation engagement can build on that with a defined first workflow.
Keep it verifiable
Primary sources
- Workspace AgentsSource checked:
- Workspace Agent access tokensSource checked:
- Codex access tokensSource checked:
- Trigger workspace agent runsSource checked:



