Task Reference Map
This file exists as a compatibility index for older links into COMMON-TASKS.md.
Prefer the narrower task-family guides below so the agent loads only the material it needs:
- AGENTS-CORE.md — agent creation, output, deps, specs, models, run methods
- CAPABILITIES-AND-HOOKS.md —
Thinking,WebSearch,Hooks, custom capabilities - TOOLS-CORE.md —
@agent.tool,Tool, toolsets, MCP, common search tools - BUILTIN-TOOLS.md — provider-native tools like
WebSearchToolandCodeExecutionTool - TOOLS-ADVANCED.md — approval, retries,
ToolReturn, timeouts, validators, deferred loading - INPUT-AND-HISTORY.md — multimodal input, message history, history processors
- TESTING-AND-DEBUGGING.md —
TestModel,FunctionModel,capture_run_messages, Logfire - ORCHESTRATION-AND-INTEGRATIONS.md — multi-agent patterns, graphs, A2A, direct API, durable execution, embeddings, evals, third-party tools
Add Capabilities to an Agent
Read Add Capabilities.
Intercept Agent Lifecycle with Hooks
Read Intercept Agent Lifecycle with Hooks.
Define Agents Declaratively with Specs
Read Define Agents Declaratively with Specs.
Enable Thinking Across Providers
Read Enable Thinking Across Providers.
Use MCP Servers
Read Use MCP Servers.
Search with DuckDuckGo, Tavily, or Exa
Read Search with DuckDuckGo, Tavily, or Exa.
Require Tool Approval (Human in the Loop)
Read Require Tool Approval.
Send Images, Audio, Video, or Documents to the Model
Read Send Images, Audio, Video, or Documents to the Model.
Manage Context Size
Read Manage Context Size.
Work with Message History
Read Work with Message History.
Show Real-Time Progress
Read Run Methods and Streaming.
Handle Provider Failures
Read Handle Provider Failures.
Make an Agent Resilient with Retries
Read Make an Agent Resilient with Retries.
Debug a Failed Agent Run
Read Debug a Failed Agent Run.
Test Agent Behavior
Read Test Agent Behavior.
Coordinate Multiple Agents
Read Coordinate Multiple Agents.
Build Multi-Step Workflows with Graphs
Read Build Multi-Step Workflows with Graphs.
Debug and Validate Agent Behavior
Read Debug and Validate Agent Behavior.
Advanced and Less Common Features
Read only the relevant section in ORCHESTRATION-AND-INTEGRATIONS.md:
Working with the Installed Pydantic AI Package
Prefer the checked-out repository or these bundled references first.
Inspect local package source only as a last resort when:
- the user asks about a symbol that is not covered in this skill
- the local environment already includes
pydantic_aiand you need exact module layout - you have no narrower offline reference available