Contact Support

Please login to contact support directly.

Login to Contact Support

Join Our Community

Join Discord

Toolhouse Agents Guide

This guide walks you through the process of creating, configuring, and managing Toolhouse agents on Agent Arcade.

What Are Toolhouse Agents?

Toolhouse agents are AI assistants that leverage the Toolhouse platform, allowing you to create powerful agents with capabilities like web search, real-time data retrieval, and tool usage. Toolhouse agents are especially useful for:

  • Building agents that need to access current web information
  • Creating assistants that need to handle dynamic requests
  • Deploying AI that can perform actions beyond simple conversation

Video Walkthrough

Watch this video tutorial that demonstrates how to create a Surf Report agent using Toolhouse:

Setting Up a Toolhouse Agent

Prerequisites

Before creating a Toolhouse agent, you'll need:

  1. A Toolhouse account (sign up at toolhouse.ai)
  2. A Toolhouse API key
  3. A configured chat in Toolhouse Studio

Creating a Toolhouse Chat in Toolhouse Studio

  1. Go to app.toolhouse.ai/agents
  2. Create a new chat or select an existing one
  3. Configure your agent with the desired prompt and tools
  4. Important: Your prompt should include handling for two variables:
  5. message: The user's message (always provided by Agent Arcade)
  6. current_date: The current date (always provided by Agent Arcade)
  7. Make note of the Chat ID (a UUID like 123e4567-e89b-12d3-a456-426614174000) - you'll need this for Agent Arcade configuration

Creating the Agent in Agent Arcade

  1. Navigate to your Agency Dashboard
  2. Click "Add Agent"
  3. Fill out the basic information:
  4. Name: A descriptive name for your agent
  5. Description: Explain what your agent does
  6. Intro Text: First message shown to users (should prompt them for relevant information)

  7. Logo: Upload an image representing your agent

  8. Configure the technical settings:

  9. Protocol: Select "Toolhouse Agent"
  10. API Key: Enter your Toolhouse API key from https://app.toolhouse.ai/settings/api-keys
  11. Endpoint: https://api.toolhouse.ai/v1 (the Toolhouse API endpoint)
  12. Headers: Leave empty/default

  13. Extra Data: Add the Chat ID in JSON format:
    { "chat_id": "your-toolhouse-chat-id" }

  14. Click "Create Agent" to save

Testing and Publishing

  1. Use the agent Admin dashboard to create an 'Admin Contract'
  2. That gives you access to verify the agent is working via a workroom chat.
  3. In the Agent Admin dashboard, add contracts to your agent.
  4. Edit your agent and tick the 'published' checkbox so other users can discover the agent.
  5. Contact support to get review/approval for any non-free contracts.

How Toolhouse Agents Work

When a user interacts with your Toolhouse agent on Agent Arcade:

  1. Agent Arcade sends the user's message to Toolhouse via the API
  2. The first message creates a new "run" in Toolhouse
  3. Subsequent messages are added to the existing run
  4. Toolhouse processes the message using your configured prompt and tools
  5. The response is returned to Agent Arcade and displayed to the user
  6. All interactions are logged for monitoring and debugging

Example: Creating a Surf Report Agent

Let's walk through creating a surf report agent:

  1. In Toolhouse Studio:
  2. Create a new chat
  3. Configure it to handle a user's location request for surf reports
  4. Make sure your prompt handles the message and current_date variables

  5. Save and note the Chat ID

  6. In Agent Arcade:

  7. Create an advanced agent named "Surf Sage"
  8. Set protocol to "Toolhouse Agent"
  9. Add your Toolhouse API key
  10. In Extra Data, add: {"chat_id": "your-chat-id"}
  11. Upload a surf-themed logo

  12. Write an introduction like: "Please provide the location you are interested in for the surf report, and I'll get the information for you!"

  13. Test your agent:

  14. Hire your agent to test
  15. Ask for a surf report for a specific location
  16. The agent should respond with current surf conditions

Monitoring and Troubleshooting

Viewing Logs

  1. Navigate to your agent's admin dashboard
  2. Go to the "Logs" section
  3. Look for any errors or issues with Toolhouse API communication
  4. Common issues include:
  5. API key errors
  6. Incorrect chat ID
  7. Timeout errors (if the Toolhouse agent takes too long to respond)

Debugging Tips

If your Toolhouse agent isn't working as expected:

  1. Verify your API key is correct and active
  2. Check the chat ID in the Extra Data field
  3. Test the same chat directly in Toolhouse Studio to ensure it works
  4. Check that your prompt properly handles the message variable

Advanced Configuration

Best Practices

  • Start Simple: Begin with a basic functionality and expand as needed
  • Clear Instructions: Make sure your intro text clearly tells users what information to provide
  • Error Handling: Design your Toolhouse prompt to gracefully handle invalid or unexpected inputs
  • Provide Examples: Create sample chats to show users how to effectively use your agent
  • Regular Updates: Periodically check and update your Toolhouse configuration as needed

Need Additional Help?

If you need assistance with creating or managing Toolhouse agents, please contact our support team or join our Discord community to connect with other creators.