Exemplo de Agente + Toolkit + QC
Este guia demonstra como integrar um Toolkit com Quick Commands e Agentes na StackSpot AI para listar raças de cães utilizando a DogAPI.
Pré-requisitos
Siga os passos a seguir:
1. Criar um Toolkit
Um Toolkit permite conectar APIs externas e usá-las como Ferramentas dentro da StackSpot AI. Siga os passos a seguir:
Passo 1. Acesse o Portal da StackSpot AI e vá para a seção Toolkit;
Passo 2. Clique no botão ‘Criar Toolkit’. Preencha os seguintes campos:
- Nome: DogAPI
- Descrição: Lista e descreve raças de cães.
Clique no botão ‘Criar’.
Passo 3. Clique no botão ‘Adicionar Ferramenta’ para incluir uma Ferramenta que acesse a DogAPI para listar fatos, raças, etc.
Clique em ‘Adicionar manualmente’ e preencha as informações da ferramenta consultando a documentação da DogAPI.
Exemplo:
- Nome da ferramenta: Listar fatos
- Método: GET
- Descrição da ferramenta: Retorna uma lista de fatos interessantes sobre cães.
- URL de invocação: https://dogapi.dog/api/v2/facts
- Parâmetros:
[
{
"name": "id",
"in": "path",
"required": true,
"schema": {
"type": "string"
}
}
]
Adicione as outras Ferramentas seguindo o mesmo exemplo. Para mais detalhes, confira o Swagger JSON com os endpoints e parâmetros disponíveis.
2. Criar um Agente
Crie um Agente capaz de responder perguntas sobre raças de cães.
Passo 1. Acesse ‘Conteúdos > Agentes’ e clique no botão ‘Criar Agente’;
Passo 2. Preencha os dados do Agente:
- Nome: Agente Cães
- Prompt do sistema: Você é um especialista em cães e raças.
- Ferramentas: Adicione as Ferramentas criadas anteriormente.
Passo 3. Clique no botão ‘Salvar’;
Passo 4. Teste seu Agente Cães:
- Pergunte ao Agente: Liste as raças.
- O Agente mostrará uma lista de raças de cães.
- Clique no modo detalhado para ver mais informações sobre a requisição na API.
Passo 5. Para finalizar, clique no botão ‘Concluir’.
3. Criar um Quick Command
Passo 1. Acesse o Portal da StackSpot AI;
Passo 2. Clique em ‘Conteúdos > Quick Command’. Em seguida, clique no botão ‘Criar Quick Command’;
Passo 3. Selecione a opção Remote e adicione as seguintes informações:
- Nome do Quick Command: dog-qc
- Descrição: Comando para listar raças de cães.
Passo 4. Selecione o template ‘Hello World’. Depois, clique na caixa do prompt e atualize o texto do prompt para:
Execute {{input_data}}
- Na aba ‘Agentes’, selecione o Agente Cães.
Clique em ‘Ok’ para confirmar.
Passo 5. Clique no botão ‘Salvar e Testar’;
Passo 6. Na página Executar, escreva:
List breeds
Clique no botão 'Executar'.