Testing Your Tools

Testing Your Tools Before Production

Before assigning your custom Tools to a Voice AI Agent in 008 Agent, it’s highly recommended to test them independently. This ensures the tool logic works as expected and avoids unnecessary friction during real-time calls.

---

🧪 Why Tool Testing Matters

• ✅ Validate input/output structure
• 🕒 Ensure timeout is respected
• ❌ Detect malformed JSON, HTTP errors or authentication issues
• 🧠 Speed up your development by iterating without needing live calls

---

🚀 How to Test Your Tool

008 Agent provides a dedicated Tool Testing Endpoint that allows you to simulate a call to your tool using a simple HTTP POST request.

🔐 Requirements

• Your tool must already be created and active in the 008 dashboard
• You must create an API Key from your developer console in 008

---

🔗 Endpoint

POST https://base.008agent.ai/api/v1/agents/tools/{tool_id}/run

🔧 Headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

🧳 Body Payload

{
  "ticket": {
    "comment": {
      "body": "My printer is on fire!"
    },
    "requester": { "name": "Paul", "email": "paul@example.org" },
    "priority": "urgent",
    "subject": "My printer is on fire!"
  }
}

You can replace the tool_id with any tool you’ve defined, and include the expected parameters.

---

✅ Tips

• Log every response for debugging
• Use realistic sample data for parameters
• Validate your headers and expected status codes
• Test before deploying to production agents

---

By testing Tools outside the agent environment, you’ll move faster and ensure more consistent, reliable interactions once live.