mirror of
https://github.com/pydantic/pydantic-ai-harness.git
synced 2026-07-21 02:45:34 +00:00
Douwe MaanandGitHub
43633b0b24
Pydantic AI's docs restructure gives Capabilities a top-level section (/ai/capabilities/) with a page per built-in capability. Update all /ai/core-concepts/capabilities/ links accordingly, and make the core built-ins explicit in the 'What goes where?' breakdown — naming and linking web search, web fetch, image generation, compaction, tool search, on-demand loading, thinking, and MCP, plus the full built-in list on the Capabilities overview. Merge together with the pydantic-ai docs restructure release: the new /ai/capabilities/ URLs only exist once that release is synced to pydantic.dev.
1.6 KiB
1.6 KiB
Harness Agent Docs
Use these guides when building or reviewing pydantic-ai-harness changes.
Required Reads
For any code change:
AGENTS.md- This file
- The guide below that matches the task
- The public Pydantic AI docs for the integration points you touch
Task Routing
- New or changed capability API:
capability-authoring.md - New or changed tests:
testing-capabilities.md - Unsure whether behavior belongs in harness or Pydantic AI core:
core-boundary.md - Review, pre-PR check, or final self-check:
review-checklist.md
Exemplar
Use pydantic_ai_harness.code_mode as the current exemplar for capability
shape:
- public re-export from
pydantic_ai_harness/__init__.py - package-level re-export from
pydantic_ai_harness/code_mode/__init__.py - public capability class in
_capability.py - implementation toolset in
_toolset.py - capability README next to implementation
- mirrored tests under
tests/code_mode/
Do not copy CodeMode mechanically. Use it to understand package shape,
testing depth, docs placement, and how a harness capability composes with
Pydantic AI toolsets.
Pydantic AI References
- Capabilities: https://pydantic.dev/docs/ai/capabilities/overview/
- Hooks: https://pydantic.dev/docs/ai/core-concepts/hooks/
- Toolsets: https://pydantic.dev/docs/ai/tools-toolsets/toolsets/
- Advanced tools: https://pydantic.dev/docs/ai/tools-toolsets/tools-advanced/
- Agents: https://pydantic.dev/docs/ai/core-concepts/agent/
- Testing: https://pydantic.dev/docs/ai/guides/testing/
- Extensibility: https://pydantic.dev/docs/ai/guides/extensibility/