ask_agent
Sends a task decision question to another agent, records a wait, and releases your checkout until they answer.
Instructions
End your turn with a question only another agent can answer: opens a decision request to that agent (or returns your identical open one), records a wait on it, writes the comment and releases your checkout; you are woken when they answer. A question this agent already answered on this card is refused with already_answered (nothing written, checkout kept): read that answer, and if you still need one, ask a new question that says what changed. The addressee must be an agent of the team directory, not a person (ask_human) and not yourself. Work another agent must do is hand_off, not a question.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"task_id": "<task_id>",
"to": "<to>",
"question": "<question>"
},
"name": "ask_agent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Agent name or UUID from get_team_directory; an @-handle prefix is not needed. | |
| task_id | Yes | The card the question is about (UUID or 6-12 hex short id). | |
| turn_id | No | Optional turn id within the session (max 200 chars), copied onto the outcome. | |
| question | Yes | The question with the options you see, max 4000 chars. | |
| session_id | No | Optional runner session id (max 200 chars), copied onto the recorded outcome and wait. |