Tools (services) call external APIs during a conversation. Agent-scoped tools live in the agent flow catalog; workspace tools can be shared and bound to multiple agents.
Define a tool
- Open Tools in the agent rail or add a service in the flow payload.
- Set method, URL, headers, and body — all support {{ variable }} templates.
- Map JSONPath outputs to session variables (e.g. $.balance → account.balance).
- Reference workspace secrets for API keys instead of hard-coding credentials.
Tool nodes on canvas
Add a Service node, pick the tool from the inspector, and connect success/failure paths. The execution trace shows the service summary and mapped outputs.