> ## Documentation Index
> Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ferramentas

> Adicione ferramentas e fluxos de trabalho personalizados aos seus agentes

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:

| Recurso          | Ferramentas                                                           | Toolkits                          |
| ---------------- | --------------------------------------------------------------------- | --------------------------------- |
| **Tipo**         | Ferramentas e fluxos de trabalho personalizados                       | Integrações pré-construídas       |
| **Criação**      | Criadas pelo usuário ou da biblioteca                                 | Pré-configuradas pela EKB         |
| **Escopo**       | Específicas do projeto ou públicas                                    | Integrações da plataforma inteira |
| **Configuração** | Personalização total                                                  | Pré-configuradas com opções       |
| **Exemplos**     | Chamadas de API personalizadas, fluxos de trabalho, lógica de negócio | Gmail, Slack, Google Drive, etc.  |

**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](/tools/workflows-v2) - Saiba mais sobre criação de fluxos de trabalho
* [Toolkits](/agents/toolkits/overview) - Entenda as integrações pré-construídas
* [Agent Builder](/agents/agents) - Guia de configuração geral do agente