62 lines
1.8 KiB
Markdown
62 lines
1.8 KiB
Markdown
|
# 🔄 Spawn & Async Tasks
|
||
|
|
|
||
|
|
> Back to [README](../README.md)
|
||
|
|
|
||
|
|
## Quick Tasks (respond directly)
|
||
|
|
|
||
|
|
- Report current time
|
||
|
|
|
||
|
|
## Long Tasks (use spawn for async)
|
||
|
|
|
||
|
|
- Search the web for AI news and summarize
|
||
|
|
- Check email and report important messages
|
||
|
|
```
|
||
|
|
|
||
|
|
**Key behaviors:**
|
||
|
|
|
||
|
|
| Feature | Description |
|
||
|
|
| ----------------------- | --------------------------------------------------------- |
|
||
|
|
| **spawn** | Creates async subagent, doesn't block heartbeat |
|
||
|
|
| **Independent context** | Subagent has its own context, no session history |
|
||
|
|
| **message tool** | Subagent communicates with user directly via message tool |
|
||
|
|
| **Non-blocking** | After spawning, heartbeat continues to next task |
|
||
|
|
|
||
|
|
#### How Subagent Communication Works
|
||
|
|
|
||
|
|
```
|
||
|
|
Heartbeat triggers
|
||
|
|
↓
|
||
|
|
Agent reads HEARTBEAT.md
|
||
|
|
↓
|
||
|
|
For long task: spawn subagent
|
||
|
|
↓ ↓
|
||
|
|
Continue to next task Subagent works independently
|
||
|
|
↓ ↓
|
||
|
|
All tasks done Subagent uses "message" tool
|
||
|
|
↓ ↓
|
||
|
|
Respond HEARTBEAT_OK User receives result directly
|
||
|
|
```
|
||
|
|
|
||
|
|
The subagent has access to tools (message, web_search, etc.) and can communicate with the user independently without going through the main agent.
|
||
|
|
|
||
|
|
**Configuration:**
|
||
|
|
|
||
|
|
```json
|
||
|
|
{
|
||
|
|
"heartbeat": {
|
||
|
|
"enabled": true,
|
||
|
|
"interval": 30
|
||
|
|
}
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
| Option | Default | Description |
|
||
|
|
| ---------- | ------- | ---------------------------------- |
|
||
|
|
| `enabled` | `true` | Enable/disable heartbeat |
|
||
|
|
| `interval` | `30` | Check interval in minutes (min: 5) |
|
||
|
|
|
||
|
|
**Environment variables:**
|
||
|
|
|
||
|
|
* `PICOCLAW_HEARTBEAT_ENABLED=false` to disable
|
||
|
|
* `PICOCLAW_HEARTBEAT_INTERVAL=60` to change interval
|