Overview

This node acts as a webhook trigger for handling callbacks from Toolhouse agents. It listens for POST requests at a specific webhook path and processes the incoming data to determine the status of a Toolhouse agent run. The node outputs data differently based on whether the agent's status is 'completed' or not, enabling workflows to react accordingly. This is useful for automating processes that depend on asynchronous agent tasks from Toolhouse, such as monitoring task completion or handling intermediate status updates.

Use Case Examples

1. Automate follow-up actions when a Toolhouse agent completes its task by triggering downstream workflow steps.
2. Monitor ongoing agent runs and handle status updates dynamically within an n8n workflow.

Output

JSON

• run_id - Identifier of the Toolhouse agent run
• status - Current status of the agent run
• last_agent_message - Most recent message from the agent

Dependencies

• Requires a webhook endpoint accessible by Toolhouse agents to send POST callbacks.

Troubleshooting

• Ensure the webhook URL is correctly configured in the Toolhouse agent settings to receive callbacks.
• Verify that incoming POST requests contain the expected JSON body with 'run_id', 'status', and 'last_agent_message' fields.
• If no data appears in the workflow outputs, check that the webhook is receiving requests and that the status field is correctly set to 'completed' or other values as expected.

Links

• Toolhouse Webhook Documentation - Official documentation for running Toolhouse agents asynchronously and handling their callbacks via webhooks.