Ferramentas

A aba Ferramentas no Agent Builder permite que você adicione ferramentas e fluxos de trabalho personalizados aos seus agentes. Diferente dos Toolkits (que são integrações pré-construídas), as Ferramentas são ferramentas e fluxos de trabalho personalizados criados pelo usuário que estendem as capacidades do seu agente com funcionalidades específicas adaptadas às suas necessidades.

​

Visão Geral

As Ferramentas permitem que você:

• Adicione Ferramentas Personalizadas: Anexe ferramentas personalizadas que você criou no seu projeto
• Adicione Fluxos de Trabalho: Inclua fluxos de trabalho/ações que executam processos de múltiplos passos
• Crie Novas Ferramentas: Construa novas ferramentas personalizadas diretamente do construtor de agentes
• Gerencie a Configuração de Ferramentas: Configure como as ferramentas são usadas pelo agente
• Navegue na Biblioteca de Ferramentas: Acesse milhares de ferramentas pré-construídas da biblioteca pública

​

Ferramentas vs. Toolkits

Entender a diferença ajuda a escolher a abordagem correta: Quando Usar Ferramentas:

• Você precisa de lógica de negócio personalizada
• Você quer criar fluxos de trabalho reutilizáveis
• Você precisa se integrar com APIs personalizadas
• Você quer combinar múltiplas operações em uma única ferramenta

Quando Usar Toolkits:

• Você precisa de integrações padrão (Gmail, Slack, etc.)
• Você quer autenticação pré-configurada
• Você precisa de operações comuns (enviar e-mail, criar tarefa, etc.)

​

Acessando a Aba de Ferramentas

1. Abra o Agent Builder
   • Navegue até Agentes na barra lateral
   • Clique em Editar em um agente existente ou Criar Agente
   • O Agent Builder será aberto
2. Navegue até a Aba de Ferramentas
   • Na barra lateral esquerda, clique em Ferramentas
   • A aba de Ferramentas será exibida com suas ferramentas selecionadas e opções para adicionar mais

​

Adicionando Ferramentas ao Seu Agente

​

Adicionando Ferramentas Personalizadas Existentes

1. Abra o Seletor de Ferramentas
   • Clique no botão + Adicionar Ferramenta na aba de Ferramentas
   • O modal do Seletor de Ferramentas será aberto
2. Navegue pelas Ferramentas Disponíveis
   • Ferramentas Personalizadas: Ferramentas que você criou no seu projeto
   • Ferramentas Públicas: Ferramentas da biblioteca pública (9.000+ disponíveis)
   • Fluxos de Trabalho: Fluxos de trabalho existentes do seu projeto
3. Pesquise e Filtre
   • Use a barra de pesquisa para encontrar ferramentas específicas
   • Filtre por categoria ou tipo
   • Navegue por popularidade ou adições recentes
4. Selecione uma Ferramenta
   • Clique em uma ferramenta para ver seus detalhes
   • Revise a descrição e as entradas da ferramenta
   • Clique em Adicionar para anexá-la ao seu agente

​

Criando uma Nova Ferramenta Personalizada

1. A partir do Seletor de Ferramentas
   • Clique em + Adicionar Ferramenta na aba de Ferramentas
   • Clique em Criar Ferramenta Personalizada no modal
   • Você será redirecionado para o Construtor de Ferramentas
2. A partir do Estado Vazio
   • Se você não tiver ferramentas, clique em Crie Sua Primeira Ferramenta
   • Isso abre o Construtor de Ferramentas para uma nova ferramenta
3. Configure Sua Ferramenta
   • Nome: Dê à sua ferramenta um nome descritivo
   • Descrição: Explique o que a ferramenta faz
   • Entradas: Defina os parâmetros de entrada
   • Passos: Configure os passos de execução da ferramenta
   • Salvar: Salve como rascunho ou publique
4. Retorne ao Agente
   • Após criar, a ferramenta estará disponível no seu projeto
   • Retorne ao construtor de agentes e adicione-a via o seletor de Ferramentas

​

Adicionando Fluxos de Trabalho

1. Abra o Seletor de Ferramentas
   • Clique em + Adicionar Ferramenta na aba de Ferramentas
   • Clique em Criar Fluxo de Trabalho no modal
2. Selecione o Gatilho do Fluxo de Trabalho
   • Escolha o tipo de gatilho:
     • Entrada de Formulário: O usuário preenche um formulário
     • Upload de Arquivo: O usuário carrega arquivos
     • Manual: Execute sob demanda
3. Configure o Fluxo de Trabalho
   • Configure os passos do fluxo de trabalho
   • Defina entradas e saídas
   • Configure as configurações do gatilho
4. Adicione ao Agente
   • Uma vez criado, o fluxo de trabalho aparece na sua lista de ferramentas
   • Ele pode ser executado pelo agente quando necessário

​

Gerenciando Ferramentas

​

Visualizando Ferramentas Adicionadas

A aba Ferramentas exibe:

• Barra Lateral: Mostra todas as ferramentas adicionadas ao agente
  • Ferramentas personalizadas
  • Fluxos de trabalho
  • Ações do seu projeto
• Área Principal: Mostra detalhes da ferramenta e opções de gerenciamento

​

Status da Ferramenta

As ferramentas podem ter diferentes status:

• Ativa: A ferramenta está pronta para uso
• Rascunho: A ferramenta está sendo editada (ainda não publicada)
• Publicada: A ferramenta foi publicada e está disponível

​

Configurando Ferramentas

1. Edite a Configuração da Ferramenta
   • Clique em Configurar em uma ferramenta adicionada
   • Ajuste as configurações específicas da ferramenta
   • Defina requisitos de aprovação (se necessário)
2. Configurações de Aprovação da Ferramenta
   • Auto-executar: A ferramenta é executada automaticamente quando acionada
   • Requerer Aprovação: O agente pede confirmação antes de executar
3. Valores Padrão de Entrada
   • Defina valores padrão para as entradas da ferramenta
   • Configure entradas obrigatórias vs. opcionais

​

Removendo Ferramentas

1. Remover do Agente
   • Clique no botão X em uma ferramenta na barra lateral
   • Ou clique em Remover nos detalhes da ferramenta
   • Confirme a remoção
2. Excluir Ferramenta Personalizada
   • Para ferramentas personalizadas, você pode excluí-las completamente
   • Clique no menu de três pontos em uma ferramenta personalizada
   • Selecione Excluir
   • Nota: Isso exclui permanentemente a ferramenta do seu projeto

​

Tipos de Ferramenta

​

Ferramentas Personalizadas

Ferramentas personalizadas são ferramentas que você cria com:

• Lógica Personalizada: Suas próprias regras e processos de negócio
• Integrações de API: Conecte-se às suas próprias APIs
• Operações de Múltiplos Passos: Combine múltiplas ações
• Processamento de Dados: Transforme e manipule dados

Criando Ferramentas Personalizadas:

1. Defina entradas (parâmetros que a ferramenta aceita)
2. Configure passos (o que a ferramenta faz)
3. Configure tratamento de erros
4. Teste a ferramenta
5. Publique quando estiver pronta

​

Fluxos de Trabalho

Fluxos de trabalho são processos de múltiplos passos que podem:

• Executar Sequências: Execute múltiplas operações em ordem
• Tratar Gatilhos: Responda a entradas de formulário ou uploads de arquivo
• Processar Dados: Transforme dados por meio de múltiplos passos
• Integrar Serviços: Conecte múltiplos serviços entre si

Gatilhos de Fluxo de Trabalho:

• Entrada de Formulário: O usuário fornece entrada por meio de um formulário
• Upload de Arquivo: O usuário carrega arquivos para processamento
• Manual: Execute sob demanda pelo agente

​

Ferramentas Públicas

A biblioteca pública de ferramentas inclui:

• 9.000+ Ferramentas: Ferramentas pré-construídas pela comunidade
• Várias Categorias: Comunicação, produtividade, dados, etc.
• Prontas para Uso: Clone e personalize conforme suas necessidades
• Atualizadas Regularmente: Novas ferramentas adicionadas frequentemente

Usando Ferramentas Públicas:

1. Navegue pela biblioteca pública
2. Encontre uma ferramenta que corresponda às suas necessidades
3. Clone-a para o seu projeto
4. Personalize se necessário
5. Adicione ao seu agente

​

Melhores Práticas

​

Organização de Ferramentas

1. Nomeie Claramente: Use nomes descritivos que expliquem o propósito da ferramenta
2. Documente Bem: Adicione descrições claras para cada ferramenta
3. Agrupe Ferramentas Relacionadas: Organize ferramentas por função ou categoria
4. Controle de Versão: Use rascunhos para testes antes de publicar

​

Seleção de Ferramentas

1. Comece Simples: Comece com ferramentas básicas e adicione complexidade gradualmente
2. Teste Cuidadosamente: Teste ferramentas antes de adicionar a agentes de produção
3. Considere o Desempenho: Muitas ferramentas podem desacelerar as respostas do agente
4. Revise Regularmente: Remova ferramentas não usadas para manter os agentes eficientes

​

Configuração de Ferramentas

1. Defina Padrões Apropriados: Configure valores padrão sensatos
2. Use Aprovação Quando Necessário: Requerer aprovação para operações sensíveis
3. Trate Erros: Garanta que as ferramentas tenham tratamento de erros adequado
4. Documente as Entradas: Documente claramente o que cada entrada faz

​

Casos de Uso

​

Agente de Suporte ao Cliente

Ferramentas Necessárias:

• Ferramenta de Criação de Ticket: Ferramenta personalizada para criar tickets de suporte
• Pesquisa na Base de Conhecimento: Ferramenta para pesquisar documentação
• Escalação de Problema: Fluxo de trabalho para escalar para um agente humano

​

Agente de Análise de Dados

Ferramentas Necessárias:

• Ferramenta de Processamento de Dados: Ferramenta personalizada para transformação de dados
• Geração de Relatórios: Fluxo de trabalho para gerar relatórios
• Exportação de Dados: Ferramenta para exportar resultados

​

Agente de Criação de Conteúdo

Ferramentas Necessárias:

• Gerador de Conteúdo: Ferramenta personalizada para criação de conteúdo
• Geração de Imagens: Ferramenta para criar imagens
• Fluxo de Trabalho de Publicação: Fluxo de trabalho para publicar conteúdo

​

Solução de Problemas

​

Ferramenta Não Aparecendo

Problema: A ferramenta não aparece no seletor Soluções:

• Verifique se a ferramenta está publicada (rascunhos podem não aparecer)
• Verifique se você está no projeto correto
• Atualize a lista de ferramentas
• Verifique as permissões da ferramenta

​

Ferramenta Não Executando

Problema: O agente não usa a ferramenta Soluções:

• Verifique se a ferramenta foi adicionada ao agente
• Verifique a configuração da ferramenta
• Revise o prompt de sistema do agente (pode ser necessário mencionar a ferramenta)
• Teste a ferramenta independentemente

​

Erros de Execução de Ferramenta

Problema: A ferramenta falha quando executada Soluções:

• Verifique se as entradas da ferramenta estão corretas
• Verifique a configuração da ferramenta
• Revise as mensagens de erro nos logs de execução da ferramenta
• Teste a ferramenta com entradas de exemplo

​

Aprovação Não Funcionando

Problema: A ferramenta executa sem aprovação quando deveria requerer Soluções:

• Verifique as configurações de aprovação na configuração da ferramenta
• Verifique se o agente tem permissão para solicitar aprovação
• Revise a configuração de aprovação da ferramenta

​

Documentação Relacionada

• Fluxos de Trabalho - Saiba mais sobre criação de fluxos de trabalho
• Toolkits - Entenda as integrações pré-construídas
• Agent Builder - Guia de configuração geral do agente