Tool Executor
Category: Agent
Node id: tool-executor
Executes registered tools/functions on behalf of agents via HTTP or builtin handlers
What it does
- HTTP-based external tool invocation with auth support
- Built-in tool library (get_current_time, calculate, format_json)
- Tool call ID tracking for agent loop integration
- Graceful error handling with status reporting
- Configurable tool registry with per-tool endpoint and auth
Use cases
- Executing tool calls from agent reasoning loops
- Integrating external APIs as tools in agentic workflows
- Running built-in utility functions within pipelines
Runtime
- Performance tier:
variable
Input ports
| Name | Type | Required | Description |
|---|---|---|---|
tool_name | text | Yes | Name of the tool to execute |
tool_args | json | No | Arguments to pass to the tool |
tool_call_id | text | No | Tool call ID for tracking |
Output ports
| Name | Type | Required | Description |
|---|---|---|---|
tool_name | text | No | Name of the executed tool |
tool_call_id | text | No | Tool call ID |
result | any | No | Tool execution result |
status | text | No | Execution status (success or error) |
http_status | number | No | HTTP status code (for HTTP tools) |
error | text | No | Error message if execution failed |
Settings
Basic
| Setting | Name | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|---|
| Execution Mode | execution_mode | enum | No | http | http, builtin | How to execute the tool |
| Tool Registry | tool_registry | json | No | Registry of tool configurations (endpoint, method, auth_token per tool) |
Errors
| Code | Description |
|---|---|
TOOL_NAME_REQUIRED | No tool_name input was provided |
TOOL_NOT_FOUND | Tool name not found in the configured registry |
ENDPOINT_MISSING | No endpoint configured for the requested tool |
UNSUPPORTED_MODE | execution_mode must be http or builtin |
Runtime notes
- On HTTP tool failure, returns status='error' with the error message instead of failing the node
- http_status output is only present for HTTP execution mode, not builtin tools
- Builtin tools: get_current_time, calculate, format_json — unknown builtins return status='error'
- tool_registry config maps tool names to {endpoint, method, auth_token} for HTTP mode
See Build any workflow for how to put nodes together and Ports, types and data flow for how port types connect.
Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..