wehub-resource-sync
9201ef759e
Harness Compat / harness compat (push) Failing after 0s
CI / test on 3.12 (standard) (push) Has been cancelled
CI / test on 3.13 (standard) (push) Has been cancelled
CI / test on 3.14 (standard) (push) Has been cancelled
CI / test on 3.10 (all-extras) (push) Has been cancelled
CI / test on 3.11 (all-extras) (push) Has been cancelled
CI / test on 3.12 (all-extras) (push) Has been cancelled
CI / test on 3.14 (pydantic-ai-slim) (push) Has been cancelled
CI / test on 3.10 (pydantic-evals) (push) Has been cancelled
CI / test on 3.11 (pydantic-evals) (push) Has been cancelled
CI / test on 3.12 (pydantic-evals) (push) Has been cancelled
CI / deploy-docs-preview (push) Has been cancelled
CI / build release artifacts (push) Has been cancelled
CI / publish to PyPI (push) Has been cancelled
CI / Send tweet (push) Has been cancelled
CI / lint (push) Has been cancelled
CI / mypy (push) Has been cancelled
CI / docs (push) Has been cancelled
CI / test on 3.10 (standard) (push) Has been cancelled
CI / test on 3.11 (standard) (push) Has been cancelled
CI / test on 3.13 (all-extras) (push) Has been cancelled
CI / test on 3.14 (all-extras) (push) Has been cancelled
CI / test on 3.10 (pydantic-ai-slim) (push) Has been cancelled
CI / test on 3.11 (pydantic-ai-slim) (push) Has been cancelled
CI / test on 3.12 (pydantic-ai-slim) (push) Has been cancelled
CI / test on 3.13 (pydantic-ai-slim) (push) Has been cancelled
CI / test on 3.13 (pydantic-evals) (push) Has been cancelled
CI / test on 3.14 (pydantic-evals) (push) Has been cancelled
CI / test on 3.10 (lowest-versions) (push) Has been cancelled
CI / test on 3.11 (lowest-versions) (push) Has been cancelled
CI / test on 3.12 (lowest-versions) (push) Has been cancelled
CI / test on 3.13 (lowest-versions) (push) Has been cancelled
CI / test on 3.14 (lowest-versions) (push) Has been cancelled
CI / test examples on 3.11 (push) Has been cancelled
CI / test examples on 3.12 (push) Has been cancelled
CI / test examples on 3.13 (push) Has been cancelled
CI / test examples on 3.14 (push) Has been cancelled
CI / coverage (push) Has been cancelled
CI / check (push) Has been cancelled
CI / deploy-docs (push) Has been cancelled
53 lines
2.1 KiB
Markdown
53 lines
2.1 KiB
Markdown
# Code Mode
|
|
|
|
Code mode is one of the capabilities in [**Pydantic AI Harness**](overview.md), the official capability library for Pydantic AI. The full docs live in the [harness repo](https://github.com/pydantic/pydantic-ai-harness) -- this page is a short intro.
|
|
|
|
[`CodeMode`](https://github.com/pydantic/pydantic-ai-harness/blob/main/pydantic_ai_harness/code_mode/README.md) wraps your tools into a single `run_code` tool powered by our [Monty](https://github.com/pydantic/monty) sandbox. The model writes Python that calls multiple tools with loops, conditionals, variables, and `asyncio.gather` -- all inside one tool call.
|
|
|
|
Standard tool calling requires one model round-trip per tool call. An agent that needs to fetch 10 items and process each one makes 11+ model calls -- slow, expensive, and context-heavy. Code mode collapses that into one.
|
|
|
|
## Usage
|
|
|
|
```bash
|
|
uv add "pydantic-ai-harness[code-mode]"
|
|
```
|
|
|
|
```python {test="skip" noqa="I001"}
|
|
from pydantic_ai import Agent
|
|
from pydantic_ai_harness import CodeMode
|
|
|
|
agent = Agent('anthropic:claude-sonnet-4-6', capabilities=[CodeMode()])
|
|
|
|
|
|
@agent.tool_plain
|
|
def get_weather(city: str) -> dict:
|
|
"""Get current weather for a city."""
|
|
return {'city': city, 'temp_f': 72, 'condition': 'sunny'}
|
|
|
|
|
|
@agent.tool_plain
|
|
def convert_temp(fahrenheit: float) -> float:
|
|
"""Convert Fahrenheit to Celsius."""
|
|
return round((fahrenheit - 32) * 5 / 9, 1)
|
|
|
|
|
|
result = agent.run_sync("What's the weather in Paris and Tokyo, in Celsius?")
|
|
print(result.output)
|
|
```
|
|
|
|
The model writes code like:
|
|
|
|
```python {test="skip" lint="skip"}
|
|
paris, tokyo = await asyncio.gather(
|
|
get_weather(city='Paris'),
|
|
get_weather(city='Tokyo'),
|
|
)
|
|
paris_c = await convert_temp(fahrenheit=paris['temp_f'])
|
|
tokyo_c = await convert_temp(fahrenheit=tokyo['temp_f'])
|
|
{'paris': paris_c, 'tokyo': tokyo_c}
|
|
```
|
|
|
|
## Full documentation
|
|
|
|
See the [Code Mode README](https://github.com/pydantic/pydantic-ai-harness/blob/main/pydantic_ai_harness/code_mode/README.md) in the harness repo for selective tool sandboxing, metadata-based selection, return value handling, REPL state, observability, sandbox restrictions, the full API, and agent spec usage.
|