Back to catalog / Agent workflows
Pin an inference region for regulated workloads
Set inference_geo when creating an agent, constrained by the workspace allowlist, and verify session behavior.
Goal
Set a verifiable model region for a Managed Agent and handle session-specific exceptions.
Steps
- In the Managed Agents production guide, confirm geography is set on the agent model definition and that the workspace enables the required inference regions. [operate]
- Create the agent with
client.beta.agents.create(..., model={"id": MODEL, "inference_geo": "us"}); the field accepts onlyglobalorus, and the value must be included in workspaceallowed_inference_geos. [operate] - After saving the agent, create a controlled test session and run one turn. Then narrow the workspace allowlist and verify that both a new session and the next turn of an active session are refused. [operate]
- If one session needs another allowed region, use
agent_with_overridesinsessions.createfor that session without changing the shared agent; retain the configuration, approver, and test evidence. [operate]
How to verify
The model field uses only `global` or `us` within the workspace allowlist; allowed-region tests succeed and session behavior after allowlist narrowing matches the guide.
Troubleshooting
If region validation fails on agent save, session creation, or a turn, check workspace `allowed_inference_geos`; narrowing it affects new sessions and subsequent turns in active sessions.
Permissions
Prerequisites
- Python 3.11+, Anthropic API key, Managed Agents beta SDK/API, and written organizational residency requirements.
Permissions
- Use approved test data only; require compliance-owner approval and audit evidence for changes.
Limitations
For `inference_geo`, check current provider capabilities, data-region behavior, and contractual requirements with the relevant legal reviewer.
Pinned upstream source
- Repository
- anthropics/anthropic-cookbook
- File path
- managed_agents/CMA_operate_in_production.ipynb
- Pinned commit
9c1e493ddd2b82df399d2a61b9c806c539e18be6- Source checked
- 2026-10-14 · Reviewed against the pinned upstream source
Repository metrics
These values describe the upstream repository, not popularity or likes for an individual skill or playbook.
- Stars
- Not collected
- Forks
- Not collected
- Observed at
- Not collected
No metrics snapshot is available yet.
License: MIT
Main topic
Make Agent behavior safer and easier to verify