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 WebSearchTool and CodeExecutionTool
• 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:

• Direct API
• A2A
• Durable Execution
• Embeddings
• Third-Party Tools
• Custom Extensibility
• Evals

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_ai and you need exact module layout
• you have no narrower offline reference available