Skip to content

Document running your own Pydantic AI agent with common.ai toolsets - #73902

Merged
kaxil merged 1 commit into
commonai-native-observabilityfrom
commonai-native-docs
Sep 30, 2026
Merged

kaxil merged 1 commit into
commonai-native-observabilityfrom
commonai-native-docs

Conversation

@kaxil

@kaxil kaxil commented Sep 29, 2026 •

Copy link
Copy Markdown
Member

Teams with a Pydantic AI agent of their own had no guide: the docs covered AgentOperator and assumed the operator runs the agent. The new Pydantic AI page shows the model from PydanticAIHook.get_hook(...).get_conn(), the same vendor handling AgentOperator uses, and the provider's toolsets passed straight to the agent. It lists what AgentOperator adds on top: durable replay, human review and tool-call approval, masking for the Agent Skills toolset and your own toolsets, templated connection IDs, and tool logging with the task's identity on spans. For spans, it points to the hook's create_agent, which instruments the agent the way AgentOperator does, with prompt text off by default.

The sandbox guide now shows a Strands agent owning its sandbox's life with a with block.

This is the top of the native agent framework stack; nothing else depends on it.

The new guide as rendered:

Pydantic AI guide


  • Read the Pull Request Guidelines for more information. Note: commit author/co-author name and email in commits become permanently public when merged.
  • For fundamental code changes, an Airflow Improvement Proposal (AIP) is needed.
  • When adding dependency, check compliance with the ASF 3rd Party License Policy.
  • For significant user-facing changes create newsfragment: {pr_number}.significant.rst, in airflow-core/newsfragments. You can add this file in a follow-up commit after the PR is created so you know the PR number.

@kaxil
kaxil added this pull request to stack #73905 September 29, 2026 12:49
@kaxil kaxil closed this Sep 29, 2026
@kaxil kaxil reopened this Sep 29, 2026
@kaxil
kaxil marked this pull request as ready for review September 29, 2026 13:18
@kaxil
kaxil force-pushed the commonai-native-docs branch from 34af5c9 to 7cf132a Compare September 29, 2026 14:03
…rameworks

Add a Pydantic AI guide for teams with an agent of their own: a model
from PydanticAIHook and the provider's toolsets passed straight to it,
and what AgentOperator adds on top. The sandbox guide now shows a
Strands agent owning its sandbox's life with a with block.
@kaxil
kaxil force-pushed the commonai-native-docs branch from 90726a0 to 809a725 Compare September 30, 2026 06:01
@kaxil
kaxil merged commit 2eb11c1 into main Sep 30, 2026
63 of 75 checks passed
@kaxil
kaxil deleted the commonai-native-docs branch September 30, 2026 06:04
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