Menu
Use for the subagent-as-a-tool pattern.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
| name | ai-python-subagents |
| description | Use for the subagent-as-a-tool pattern. |
| metadata | {"sdk-version":"0.2.1"} |
Use a subagent tool when the parent model should choose when to call another agent.
@ai.tool
async def research(topic: str) -> ai.SubAgentTool:
child = ai.Agent(tools=[lookup])
messages = [
ai.system_message("Research briefly."),
ai.user_message(topic),
]
async with child.run(model, messages) as stream:
async for event in stream:
yield event
The parent model sees the child agent's final assistant text as the tool
result. The caller sees child events as ai.events.PartialToolCallResult.
Render nested output from event.value:
if isinstance(event, ai.events.PartialToolCallResult):
if isinstance(event.value, ai.events.TextDelta):
print(event.value.chunk, end="", flush=True)
Do not append child messages to the parent history yourself. The tool result
stores the child transcript as a MessageBundle.
For MessageBundle, preliminary output, and streaming tool details, use
ai-python-streaming-tools.
Based on SOC occupation classification
Use when building serverless AI SDK for Python endpoints, handling hook approvals, deferring hooks, or resuming runs across requests.
Use when connecting AI SDK for Python streams to AI SDK UI useChat clients.
Use for AI SDK for Python basics. Configure a model, make messages, stream, declare tools, build a basic agent.
Use for AI SDK for Python async-generator tools, streaming tool output, subagent tools, PartialToolCallResult events, and custom tool aggregation.
Use when building custom agent loops. Modify tool dispatch, history management, hooks, control flow.
Use for implementing custom providers in AI SDK for Python.
