Create Tool

What it does

This skill, Vapiai's create-tool, allows AI agents to define and register custom tools that can be used during calls. These tools enable actions like looking up data, booking appointments, transferring calls, sending messages, and more, extending the agent’s capabilities beyond basic conversation. The tool creation process involves defining a tool type (e.g., Function Tool, Transfer Call Tool, End Call Tool) and configuring its parameters via API requests or server-side SDKs.

When to use it

• Automating call center tasks: Create tools for looking up order statuses, checking account balances, or initiating refunds.
• Integrating with backend systems: Define function tools that interact with your servers to retrieve information or perform actions based on user requests during a call.
• Routing calls intelligently: Use Transfer Call Tools to direct callers to specific departments or agents based on their needs.
• Providing self-service options: Enable users to complete tasks like booking appointments without human intervention.

Key capabilities

• Function Tool Creation: Define tools with a name, description, and parameters for data retrieval or action execution via server calls.
• Transfer Call Tool Definition: Configure call transfers to specific phone numbers or SIP endpoints with associated messages.
• End Call Tool Implementation: Allows the AI agent to terminate an active call.
• API-based tool creation: Tools can be created using a REST API endpoint.
• Server SDK Support: Tools can be created programmatically using a TypeScript server SDK.

Example prompts

• "Create a function tool called 'get_weather' that takes a location as input and retrieves the current weather."
• "Define a Transfer Call Tool to route callers with billing questions to extension +1234567890."
• "I need an End Call Tool so the assistant can conclude calls automatically."

Tips & gotchas

• VAPI_API_KEY Required: You must set the VAPI_API_KEY environment variable for authentication. Refer to the "setup-api-key" skill if needed.
• Server Implementation: Function tools require a server endpoint (url in the tool definition) to handle requests and return results. This server needs to be implemented separately.