ai-python-subagents
Use for the subagent-as-a-tool pattern.
Source facts
- Repository
- vercel-labs/seal
- Last source activity
- July 17, 2026 at 17:25
- Detected SKILL.md language
- English
- Stars
- 8
- Forks
- 3
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- ai-python-subagents
- description
- Use for the subagent-as-a-tool pattern.
- metadata
- {"sdk-version":"0.2.1"}
# ai-python-subagents
Use a subagent tool when the parent model should choose when to call another
agent.
```python
@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`:
```python
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`.
View on GitHub