ask_otto
Send a plain-language question to Otto and get an answer via an A2A agent or Moveworks assistant. Use it to reach ServiceNow AI assistants without writing API calls.
Instructions
Send a plain-language request to Otto and return the answer. Two routes: (1) a2a, which sends it over A2A to an AI agent on the instance: the agent argument, else NOWAIKIT_OTTO_AGENT, else the A2A-exposed agent that looks like an orchestrator or assistant. This needs an OAuth (JWT) sign-in with the a2aauthscope scope and synchronous external agent mode. (2) moveworks, the Moveworks Conversations API (EmployeeWorks assistant), used when MOVEWORKS_API_BASE, MOVEWORKS_API_TOKEN (a user bearer from /oauth/v1/token) and MOVEWORKS_ASSISTANT_NAME are set. The moveworks route is a configured route, not verified against a live tenant. route=auto picks a2a when an agent is named or NOWAIKIT_OTTO_AGENT is set, else moveworks when configured, else a2a. Agents act with their own tools, so this REQUIRES WRITE_ENABLED=true.
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": {
"message": "<message>"
},
"name": "ask_otto"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent | No | a2a: agent sys_id or name to send to | |
| route | No | Which route (default auto) | |
| message | Yes | What to ask Otto | |
| task_id | No | a2a: answer an agent that asked for more input | |
| context_id | No | a2a: continue an earlier conversation | |
| wait_seconds | No | How long to wait for the answer (default 120) | |
| conversation_id | No | moveworks: continue an earlier conversation (conv_...) |