VoxOne Tools

Tools allow AI agents to access external functionalities, APIs, and resources from the platform itself, expanding what the agent can do during a conversation. In practice, tools work similarly to traditional agent skills: they enable fetching external information, executing specific actions, and personalizing the user experience.

How to navigate:

1. When accessing Skyone Studio, click on VoxOne.

2. Click the Tools tab.

3. On this screen, you will see:

• Custom tools created by you.

• Platform default tools (identified by a globe icon).

---

Creating a Custom Tool

Custom tools allow you to integrate the agent with external services, such as APIs. Step by step:

Main settings

1. Click Create new tool.

2. Define the tool name.

3. Write a description for the tool.

Attention! The model will see the tool name and description and will use this information to determine when to make a tool call.

Integration

1. Choose the HTTPS type.

2. Configure the API URL (it may contain dynamic parameters).

3. Select the HTTP method:

• GET

• PUT

• POST

• PATCH

1. Define the timeout to prevent the platform from becoming unresponsive if the API does not respond.

A “Pre-computable” flag will be available. This flag allows the tool to be executed simultaneously with the agent’s speech. Use it only for read-only operations, such as GET, that do not modify data.

---

Configuring Tool Parameters

Parameters allow the value sent to the API to vary with each use.

Fill in the following fields:

• Type

  • Dynamic: Always changes

  • Static: Remains fixed

  • Automatic: The agent determines whether it is dynamic or static

• Parameter name: Must match exactly the key name.

• Method:

  • Query

  • Patch

  • Header

• Schema type:

  • Text

  • Number

  • Integer

  • Boolean

  • Custom

• Write a description.

Dynamic parameters allow the agent to use different values in each interaction.

---

Advanced Settings

Define the agent’s final behavior, choosing one of the following:

• Default

• Speak

• Listen

• Speak once

There will be a “Static response” flag, where the tool will always return the same predefined response when the flag is enabled.

After saving, the settings will be ready for testing.

---

Testing the Tool

1. Click Test.

2. Send a JSON with the configured parameter.

Example:

{
  "CEP": "01000-000"
}

1. Run the test.

2. Check whether the API returns the expected information.

If the test returns correctly, the tool is ready for use.

---

Linking the Tool to an Agent

1. Access the desired agent.

2. Go to the agent’s Tools section.

3. Select the created tool.

4. Save the changes.

From that point on, the agent will be able to access the external API during the conversation.

FAQ

What are tools used for?

They allow the agent to access external APIs, execute specific actions, and personalize interactions.

What is the difference between a custom tool and a standard tool?

Custom tools are created by the user. Standard tools are preconfigured and provided by the platform.

Can I use dynamic parameters in any tool?

Yes, as long as the API supports variable parameters.

Is it mandatory to test the tool before using it in an agent?

Yes. Testing ensures that the integration is working correctly.