references/COMMON-TASKS.mdBrowse 12 files

1,275 tokens

4,941 bytes
Token encoding: o200k_base
Snapshot 9e9fdc4

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
ON-DEMAND-CAPABILITIES.md — progressive disclosure, deferred capabilities, capabilities on demand, load_capability
TOOLS-CORE.md — @agent.tool, Tool, toolsets, MCP, common search tools
NATIVE-TOOLS.md — provider-native tools like WebSearchTool and CodeExecutionTool
TOOLS-ADVANCED.md — approval, retries, ToolReturn, timeouts, validators, tool search, and tool-level deferred loading
INPUT-AND-HISTORY.md — multimodal input, message history, run_id / conversation_id, 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, image generation, evals, third-party tools

Add Capabilities to an Agent

Read Add Capabilities.

Apply Progressive Disclosure

Read Capabilities on Demand.

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

Referenced from SKILL.md

SKILL.mdView in source ↗

355| Compare abstractions, output modes, decorators, or model-string patterns | [Architecture and Decision Guide](./references/ARCHITECTURE.md) |356| Follow an older link into `COMMON-TASKS.md` | [Task Reference Map](./references/COMMON-TASKS.md) |

SKILL.mdView in source ↗

407Use [Task Reference Map](./references/COMMON-TASKS.md) only for compatibility with older links or when you need a pointer from an old section name to the new file.