Skip to main content
Tools allow your voice agents to interact with external systems, fetch data, and perform actions beyond conversation. By connecting your agents to APIs and services, you can create powerful workflows that integrate with your existing business systems—from looking up customer data in your CRM to checking appointment availability and processing orders.

​
Getting Started

Choose your implementation path based on how you want to work with tools:

Configure in Dashboard

Create and manage tools using the web interface. Perfect for configuring tools visually, testing API integrations, and setting up reusable templates.

Integrate via API

Build tools programmatically using the Hamsa API. Ideal for automated deployments, infrastructure as code, and dynamic tool generation.

​
What are Tools?

Two Tool Types Available:
  • API Request: Make HTTP requests to external APIs
  • MCP Server: Connect to Model Context Protocol servers for standardized AI integrations
Tool Templates vs Instances
  • Template: Reusable tool definition stored in your tool library
  • Instance: Reference to a template with optional agent-specific overrides
  • Use the same tool across multiple agents with different configurations
Tool Versioning
  • Tools use semantic versioning to manage updates
  • Version changes when breaking modifications occur
  • Sync agents to latest versions or pin to specific versions
Web Tools
  • Special execution mode for browser-based deployments
  • Render as interactive forms in web chat interfaces
  • Execute client-side when using the Hamsa SDK

​
Common Use Cases

Customer Data Integration
  • Look up customer information from your CRM
  • Retrieve account status and history
  • Verify customer identity
Business Operations
  • Check appointment availability
  • Process orders and payments
  • Update database records
  • Submit form data
External Services
  • Check weather conditions
  • Retrieve shipping status
  • Validate addresses
  • Send notifications

​
Learn More

Tool Nodes

Use tools in Flow Agent workflows

Web Tool Nodes

Create browser-based tool interactions

Single Prompt Tools

Configure tools for Single Prompt Agents

API Reference

Complete Tools API documentation

​
Best Practices

Tool Design
  • Write clear, comprehensive descriptions that help the AI understand when to use each tool
  • Use descriptive parameter names and provide helpful descriptions
  • Set sensible default values for optional parameters
Security
  • Never hardcode API keys or sensitive tokens in tool configurations
  • Use HTTPS endpoints only
  • Validate all inputs with strict parameter schemas
  • Store credentials securely using environment variables
Performance
  • Set appropriate timeouts based on API response times
  • Use async mode for operations taking longer than 5 seconds
  • Test tools thoroughly before deploying to production
  • Monitor tool execution times and success rates