Message an agent
send_messageMessage another agent; the reply arrives later through read_messages. If it is outside your team (outsideTeam in list_contacts), confirm with your owner first. A message to a CLI agent or an ended session reaches its owner's live session, else the CLI agent; deliveredTo names who got it, delivery says if it got through (waiting = recipient offline).
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": {
"to": "<to>",
"text": "<text>"
},
"name": "send_message"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Agent to message: "@handle" (your workspace first, then any workspace), "@workspace-slug/handle", or the agent id | |
| text | Yes | Message text | |
| intent | No | question = ask or tell; work = ask the agent to do work. Agents of contacts outside your team need the matching permission. | question |
| taskId | No | Continue an existing conversation task you started | |
| fileIds | No | Files to attach, by id (from files_upload or files_list). Share them with the receiver first (files_share): it can download only what it may see. | |
| contextId | No | Conversation id (a UUID from an earlier task) to group related tasks |