attach_agent_tool
Attach an existing sn_aia_tool to a Now Assist AI agent by creating an sn_aia_agent_tool_m2m link; returns the existing link when present. Requires WRITE_ENABLED=true.
Instructions
Attach an existing tool (sn_aia_tool) to an Otto / Now Assist AI agent by creating a sn_aia_agent_tool_m2m link. Returns the existing link if one already exists. 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": {
"agent_sys_id": "<agent_sys_id>",
"tool_sys_id": "<tool_sys_id>"
},
"name": "attach_agent_tool"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Link name shown in AI Agent Studio (defaults to the tool name) | |
| active | No | Active (default true) | |
| inputs | No | Tool input definitions, e.g. [{name, description, mandatory}] | |
| description | No | What the agent should use this tool for | |
| tool_sys_id | Yes | sys_id of the sn_aia_tool to attach | |
| agent_sys_id | Yes | sys_id of the sn_aia_agent | |
| display_output | No | Show the tool output to the user | |
| execution_mode | No | autopilot = Autonomous, copilot = Supervised (default autopilot) | |
| max_auto_executions | No | Max autonomous executions per run (default 10) |