Skip to content

Document Anthropic advisor rosters and pinned inference regions - #71464

Merged
kaxil merged 1 commit into
mainfrom
anthropic-agent-config-docs
Aug 13, 2026
Merged

Document Anthropic advisor rosters and pinned inference regions#71464
kaxil merged 1 commit into
mainfrom
anthropic-agent-config-docs

Conversation

@kaxil

@kaxil kaxil commented Aug 11, 2026

Copy link
Copy Markdown
Member

Summary

Anthropic SDK 0.121.0 adds two agent-level settings: an advisor entry for a coordinator's
multiagent roster, and inference_geo on the model config for pinning which region serves
inference. Both reach the API through AnthropicHook.create_agent's existing keyword
passthrough, so they need no provider support -- only documentation, since nothing in the
guide says they are available.

Pinning the inference region, which is what a data-residency requirement usually comes down
to:

hook.create_agent(
    name="eu-only-analyst",
    model={"id": "claude-opus-4-8", "inference_geo": "eu"},
)

Adding an advisor the coordinator may consult mid-turn:

hook.create_agent(
    name="coordinator",
    model="claude-opus-4-8",
    multiagent={
        "type": "coordinator",
        "agents": [worker_agent_id, {"type": "advisor", "model": "claude-opus-4-8"}],
    },
)

Why the shapes are verified rather than read off the types

Both payloads were exercised against the live API. That mattered: the first attempt omitted
multiagent.type: "coordinator" and was rejected with multiagent.type: Field required, so
documenting from the SDK type definitions alone would have shipped a payload that 400s.

The guide also records the constraints the API enforces (1 to 20 distinct roster entries, at
most one advisor, referenced agents may not themselves set multiagent) and that model is
whole-object replacement on update, so omitting inference_geo clears it rather than
preserving it.

One code change

create_agent's model annotation widens from str | None to accept a mapping. It already
worked at runtime, but a user type-checking their Dag would have got an error on the exact
snippet the guide tells them to write.

@kaxil
kaxil force-pushed the anthropic-agent-config-docs branch from efab84d to 47be353 Compare August 11, 2026 19:58
@kaxil
kaxil marked this pull request as ready for review August 11, 2026 19:59
@kaxil
kaxil requested a review from gopidesupavan as a code owner August 11, 2026 19:59
@kaxil
kaxil requested a review from Lee-W August 11, 2026 20:01
@kaxil
kaxil force-pushed the anthropic-agent-config-docs branch from 47be353 to 75fe6c2 Compare August 11, 2026 21:03
@kaxil
kaxil force-pushed the anthropic-agent-config-docs branch from 75fe6c2 to 0bf7ca0 Compare August 11, 2026 21:33
@kaxil
kaxil force-pushed the anthropic-agent-config-docs branch 2 times, most recently from 4e9cf5d to 7952eb3 Compare August 12, 2026 06:38
Comment thread providers/anthropic/docs/operators/anthropic.rst Outdated
Comment thread providers/anthropic/docs/operators/anthropic.rst Outdated
Comment thread providers/anthropic/docs/operators/anthropic.rst Outdated
Comment thread providers/anthropic/src/airflow/providers/anthropic/hooks/anthropic.py Outdated
@kaxil
kaxil force-pushed the anthropic-agent-config-docs branch from 7952eb3 to d53221d Compare August 12, 2026 08:38

@Lee-W Lee-W left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

one nit

Comment thread providers/anthropic/docs/operators/anthropic.rst Outdated
@kaxil
kaxil force-pushed the anthropic-agent-config-docs branch from d53221d to 687ae11 Compare August 12, 2026 11:07
@kaxil
kaxil force-pushed the anthropic-agent-config-docs branch from 687ae11 to 65ed722 Compare August 12, 2026 13:10
@kaxil
kaxil force-pushed the anthropic-agent-config-docs branch from 65ed722 to 5adb81a Compare August 12, 2026 13:46
@kaxil
kaxil force-pushed the anthropic-agent-config-docs branch from 5adb81a to 79c460d Compare August 13, 2026 08:41
@kaxil
kaxil force-pushed the anthropic-agent-config-docs branch from 79c460d to 989268f Compare August 13, 2026 09:45
@kaxil
kaxil force-pushed the anthropic-agent-config-docs branch from 989268f to 087b040 Compare August 13, 2026 12:05
@kaxil
kaxil force-pushed the anthropic-agent-config-docs branch from 087b040 to c558b5f Compare August 13, 2026 12:05
@kaxil
kaxil force-pushed the anthropic-agent-config-docs branch from c558b5f to 08156f5 Compare August 13, 2026 12:20
Base automatically changed from anthropic-session-usage-xcom to main August 13, 2026 13:45
Anthropic SDK 0.121.0 adds two agent-level settings: an ``advisor`` entry
for a coordinator's multiagent roster, and ``inference_geo`` on the model
config for pinning which region serves inference. Both reach the API
through ``AnthropicHook.create_agent``'s existing keyword passthrough, so
they need no provider code -- only documentation, since nothing in the
guide says they are available.

Both payload shapes are verified against the live API rather than read
off the SDK types. That mattered: the first attempt omitted
``multiagent.type: "coordinator"`` and was rejected with
``multiagent.type: Field required``, so documenting from the type
definitions alone would have shipped a payload that 400s.

Also records the roster constraints the API enforces (1-20 distinct
entries, at most one advisor, referenced agents may not themselves set
``multiagent``) and that ``model`` is whole-object replacement on update,
so omitting ``inference_geo`` clears it instead of preserving it.

The measured budget-overshoot range in the session-budget warning widens
to $0.32-$0.61 across four runs, now that the deferrable end-to-end run
has added a fourth data point.
@kaxil
kaxil force-pushed the anthropic-agent-config-docs branch from 08156f5 to 51a2fda Compare August 13, 2026 13:45
@kaxil
kaxil merged commit 0089bd9 into main Aug 13, 2026
4 checks passed
@kaxil
kaxil deleted the anthropic-agent-config-docs branch August 13, 2026 13:46
dabla pushed a commit to dabla/airflow that referenced this pull request Aug 14, 2026
…he#71464)

Anthropic SDK 0.121.0 adds two agent-level settings: an ``advisor`` entry
for a coordinator's multiagent roster, and ``inference_geo`` on the model
config for pinning which region serves inference. Both reach the API
through ``AnthropicHook.create_agent``'s existing keyword passthrough, so
they need no provider code -- only documentation, since nothing in the
guide says they are available.

Both payload shapes are verified against the live API rather than read
off the SDK types. That mattered: the first attempt omitted
``multiagent.type: "coordinator"`` and was rejected with
``multiagent.type: Field required``, so documenting from the type
definitions alone would have shipped a payload that 400s.

Also records the roster constraints the API enforces (1-20 distinct
entries, at most one advisor, referenced agents may not themselves set
``multiagent``) and that ``model`` is whole-object replacement on update,
so omitting ``inference_geo`` clears it instead of preserving it.

The measured budget-overshoot range in the session-budget warning widens
to $0.32-$0.61 across four runs, now that the deferrable end-to-end run
has added a fourth data point.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants