Tools no VoxOne

As Ferramentas (Tools) permitem que os agentes de IA acessem funcionalidades externas, APIs e recursos da própria plataforma, ampliando o que o agente consegue fazer durante uma conversa.

Na prática, as tools funcionam de forma semelhante às habilidades dos agentes tradicionais: elas permitem buscar informações externas, executar ações específicas e personalizar a experiência do usuário.

Como navegar:

1. Ao acessar o Skyone Studio, clique em VoxOne.

2. Clique na aba Ferramentas (Tools).

3. Nesta tela, você verá:

• Ferramentas personalizadas criadas por você.

• Ferramentas padrão da plataforma (identificadas por um ícone de um globo terrestre).

---

Criando uma ferramenta personalizada

As ferramentas personalizadas permitem integrar o agente a serviços externos, como APIs.

Passo a passo:

Configurações principais.

1. Clique em Criar nova ferramenta.

2. Defina o nome da ferramenta.

3. Escreva uma descrição da ferramenta.

Atenção! O modelo verá o nome e a descrição da ferramenta e usará essas informações para determinar quando fazer uma chamada para a ferramenta.

Integração

1. Escolha um tipo “HTTPS”

2. Configure a URL da API (pode conter parâmetros dinâmicos).

3. Selecione o método HTTP:

• GET

• PUT

• POST

• PATCH

1. Defina o timeout, evitando que a plataforma fique travada caso a API não responda.

Estará disponível uma flag de “Pré-computável”. Ela servirá para executar a ferramenta simultaneamente à fala do agente, use ela apenas em operações de leitura, exemplo: get que não alterem os dados.

---

Configurando parâmetros da ferramenta

Os parâmetros permitem que o valor enviado para a API varie a cada uso.

Preencha os campos de:

• Tipo

  • Dinâmico: Sempre irá alterar

  • Estático: Ficara fixo

  • Automático: O Agente vai identificar se será dinâmico ou estático

• Nome do parâmetro: Escrever igual ao que está na chave

• Método:

  • Query

  • Patch

  • Header

• Tipo do Schema:

  • Texto

  • Número

  • Inteiro

  • Booleano

  • Customizado

• Escreva uma descrição

Parâmetros dinâmicos permitem que o agente utilize valores diferentes em cada interação.

Configurações Avançadas

Defina o comportamento final do agente que estarão entre:

• Padrão

• Fala

• Ouve

• Fala uma vez

Terá uma flag de “Resposta estática” onde a ferramenta sempre retornará a mesma resposta predefinida ao ativar a flag.

Após salvar as configurações estarão prontas para realizar o teste.

---

Teste a ferramenta

1. Clique na opção “Testar”.

2. Envie um JSON com o parâmetro configurado.

Exemplo:

{
"CEP": "01000-000"
}

1. Execute o teste.

2. Verifique se a API retorna as informações esperadas.

Se o teste retornar corretamente, a ferramenta está pronta para uso.

---

Vinculando a ferramenta a um agente

1. Acesse o agente desejado.

2. Vá até a seção Ferramentas (Tools) do agente.

3. Selecione a ferramenta criada.

4. Salve as alterações.

A partir desse momento, o agente poderá acessar a API externa durante a conversa.