Sweep 22 Sep 2026 · 17:19Z Build v2.1.280 501 read Stable v2.1.267 Latest v2.1.280 Next v2.1.280 Feeds RSS JSON llms.txt Unofficial
One change · api

agent-setup changed

managed-agents/agent-setup

Nearest release: v2.1.260, published an hour before this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.

Recorded here
Lines+26added
Lines−21removed
From line 54 where the diff opens
First seen 14 Aug 2026 this site's first read of the page
Recorded edits9to this page, all time

The whole hunk

from line 54, old and new numbered
/
lines
from line 54
5454 
5555 <MultiFileExample language="cli" label="CLI">
5656 ```bash CLI
57 agent=$(ant beta:agents create --format json < coding-assistant.agent.yaml)
58 
59 AGENT_ID=$(jq -r '.id' <<< "$agent")
57 ant apply coding-assistant.md
6058 ```
6159 
62 <File filename="coding-assistant.agent.yaml">
63 ```yaml
60 <File filename="coding-assistant.md">
61 ```markdown
62 ---
6463 name: Coding Assistant
65 model:
66 id: claude-opus-5
67 system: You are a helpful coding agent.
64 model: claude-opus-5
6865 tools:
6966 - type: agent_toolset_20260401
67 ---
68 
69 You are a helpful coding agent.
7070 ```
7171 </File>
7272 </MultiFileExample>
from line 210
210210 
211211Like `speed` and `effort`, `inference_geo` is set through the object form of `model`: pass `model` as an object and set `inference_geo` alongside `id`. The field accepts `"us"` or `"global"`. When it's unset, each model request follows the workspace's default inference geo at the time it's served. See [Data residency](https://platform.claude.com/docs/en/manage-claude/data-residency) for the workspace-level geo controls and pricing.
212212 
213The following example pins an agent to US inference and prints the `inference_geo` value echoed in the response's `model` object:
213The following example pins an agent to US inference and prints the `inference_geo` value from the agent's `model` object:
214214 
215215<CodeGroup defaultLanguage="CLI">
216216 ```bash cURL
from line 230
230230 
231231 <MultiFileExample language="cli" label="CLI">
232232 ```bash CLI
233 agent=$(ant beta:agents create --format json < geo-pinned.agent.yaml)
234 
235 echo "Inference geo: $(jq -r '.model.inference_geo' <<< "$agent")"
233 ant apply geo-pinned-assistant.md
236234 ```
237235 
238 <File filename="geo-pinned.agent.yaml">
239 ```yaml
236 <File filename="geo-pinned-assistant.md">
237 ```markdown
238 ---
240239 name: Geo-pinned assistant
241240 model:
242241 id: claude-opus-5
243242 inference_geo: us
244 system: You are a helpful assistant.
243 ---
244 
245 You are a helpful assistant.
245246 ```
246247 </File>
247248 </MultiFileExample>
from line 350
349350 
350351Updating an agent generates a new version when the configuration changes. The `version` field is optional: supply it for optimistic concurrency (a mismatch returns a 409), or omit it to apply the update unconditionally (last write wins). Updates to archived agents are rejected.
351352 
353With the CLI, edit the agent's file and run `ant apply` again; apply supplies `version` for you.
354 
352355<CodeGroup defaultLanguage="CLI">
353356 ```bash cURL
354357 updated_agent=$(curl -fsSL "https://api.anthropic.com/v1/agents/$AGENT_ID" \
from line 372
369372 
370373 <MultiFileExample language="cli" label="CLI">
371374 ```bash CLI
372 ant beta:agents update --agent-id "$AGENT_ID" < coding-assistant.agent.yaml
375 ant apply coding-assistant.md
373376 ```
374377 
375 <File filename="coding-assistant.agent.yaml">
376 ```yaml
378 <File filename="coding-assistant.md">
379 ```markdown
380 ---
377381 name: Coding Assistant
378 model:
379 id: claude-opus-5
380 system: You are a helpful coding agent. Always write tests.
382 model: claude-opus-5
381383 tools:
382384 - type: agent_toolset_20260401
385 ---
386 
387 You are a helpful coding agent. Always write tests.
383388 ```
384389 </File>
385390 </MultiFileExample>