Agent Wealth HubFree public resources
中文 EN العربية

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

  1. 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]
  2. Create the agent with client.beta.agents.create(..., model={"id": MODEL, "inference_geo": "us"}); the field accepts only global or us, and the value must be included in workspace allowed_inference_geos. [operate]
  3. 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]
  4. If one session needs another allowed region, use agent_with_overrides in sessions.create for 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

Permissions

Limitations

For `inference_geo`, check current provider capabilities, data-region behavior, and contractual requirements with the relevant legal reviewer.

Pinned upstream source

https://github.com/anthropics/anthropic-cookbook/blob/9c1e493ddd2b82df399d2a61b9c806c539e18be6/managed_agents/CMA_operate_in_production.ipynb

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

Related resources