Skip to content

Add pydantic-ai capability matrix references doc to Common AI#69887

Open
gopidesupavan wants to merge 4 commits into
apache:mainfrom
gopidesupavan:add-inputgaurd-capabitlity-example
Open

Add pydantic-ai capability matrix references doc to Common AI#69887
gopidesupavan wants to merge 4 commits into
apache:mainfrom
gopidesupavan:add-inputgaurd-capabitlity-example

Conversation

@gopidesupavan

@gopidesupavan gopidesupavan commented Jul 14, 2026

Copy link
Copy Markdown
Member

Add Common AI capability references and shields example

This adds a short reference from the Common AI provider docs to the upstream
pydantic-ai-harness capability matrix, so users can discover the current set of
supported capability packages without Airflow copying and maintaining that list.

It also adds a small example Dag showing how to pass an InputGuard from
pydantic-ai-shields through AgentOperator capability parameters.


Was generative AI tooling used to co-author this PR?
  • Yes (please specify the tool below)

  • 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.

@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, mostly good

Comment on lines +132 to +133
# [START howto_operator_agent_capabilities_input_guard]
if InputGuard is not None:

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.

I feel we should mention the verison in doc and remove this if InputGuard is not None check from rendered section

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

it seems... the providers example dags are importing now in core tests and optional deps not installed..


FAILED airflow-core/tests/unit/always/test_example_dags.py::test_should_be_importable[providers/common/ai/src/airflow/providers/common/ai/example_dags/example_agent_capabilities.py] - AssertionError: import_errors={'/opt/airflow/providers/common/ai/src/airflow/providers/common/ai/example_dags/example_agent_capabilities.py': 'Traceback (most recent call last):\n  File "<frozen importlib._bootstrap>", line 241, in _call_with_frames_removed\n  File 
"/opt/airflow/providers/common/ai/src/airflow/providers/common/ai/example_dags/example_agent_capabilities.py", line 29, in <module>\n    from pydantic_ai_shields import InputGuard\nModuleNotFoundError: No module named \'pydantic_ai_shields\'\n'}
assert 1 == 0

@github-actions

Copy link
Copy Markdown
Contributor

uv.lock on main just moved via #69924 ("Support excluding files from common.ai Agent Skills discovery"), commit 663a792 and this PR currently conflicts.

Quickest fix:

git fetch upstream main && git rebase upstream/main
rm uv.lock && uv lock
git add uv.lock && git rebase --continue
git push --force-with-lease

Automated nudge — ignore if you're not ready to rebase. This comment is updated in place on future uv.lock bumps.

@gopidesupavan gopidesupavan force-pushed the add-inputgaurd-capabitlity-example branch from deb672a to 4118cb3 Compare July 15, 2026 17:35
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