Delegate task
delegate_taskDelegate tasks to a real human virtual assistant when AI cannot act, including phone calls, physical-world steps, subjective QA, or manual data entry. Returns a taskId for tracking.
Instructions
Call get_balance first, then confirm with the user before sending (real hours) unless they already said to send it. Delegate a task to a real human virtual assistant when the AI cannot complete it autonomously. Use this for phone calls, owner-authorized login or captcha steps (never send passwords or OTP), physical-world actions, subjective QA, manual data entry, or anything else outside the model's reach. Returns a taskId for tracking. The job is NOT started until the customer clicks Start on Work. The receipt status is awaiting_customer_start.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | Concise directive (max 5000 chars). | |
| dueDate | No | Optional human-readable due date (e.g. EOD Friday). | |
| maxHours | No | Spend cap in hours (default 0.5). VA/AM stop and ask before exceeding. Actual tracked time is billed, not this cap. Max 8. | |
| priority | No | normal | |
| webhookUrl | No | Optional public HTTPS callback URL. | |
| description | No | Detailed context, instructions, and constraints (max 8000 chars). Never include passwords, OTP codes, recovery keys, cookies, or API keys. | |
| sourceAgent | No | Optional calling-agent label for the audit trail (e.g. grok-bot). | |
| idempotencyKey | Yes | Same value as the REST Idempotency-Key header. Required. A repeat returns the original task. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | awaiting_customer_start means the customer has not clicked Start on Work. received is a replay after start, a hold, or a sent card. | |
| taskId | No | Stable id for get_task. | |
| message | No | Human-readable result. Do not claim the VA has started unless the status says so. | |
| success | No | True when the brief was filed or replayed. |