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

# Tools

> Configure ferramentas especializadas da biblioteca Evo AI para estender as capacidades dos seus agentes

## Visão Geral

A **Biblioteca de Ferramentas** da Evo AI oferece um conjunto curado de ferramentas especializadas que podem ser integradas aos seus agentes. Essas ferramentas fornecem funcionalidades avançadas para:

* **Processamento de áudio** com conversão de texto para fala e vice-versa
* **Extração de dados web** com web scraping inteligente
* **Processamento multimídia** para diferentes tipos de conteúdo
* **Integração com APIs especializadas** mantidas pela Evo AI

<Note>
  **Biblioteca Evo AI**: Todas as ferramentas são fornecidas e mantidas pela Evo AI.
  Você só precisa configurar os parâmetros necessários e suas credenciais de API.
</Note>

## Como Configurar uma Tool

### Passo 1: Acessar Configurações do Agente

<AccordionGroup>
  <Accordion icon="gear" title="Navegar para configurações">
    1. Vá para a **tela de agentes** no dashboard
    2. Localize o agente que deseja configurar
    3. Clique no ícone de **"Configurações"** (⚙️) no card do agente e em seguida em **"Editar"**
    4. Você será direcionado para a tela de configurações do agente
  </Accordion>

  <Accordion icon="wrench" title="Acessar Tools">
    1. Na tela de configurações, localize a seção **"Tools"**
    2. Clique em **"Add"** para adicionar uma nova ferramenta

    <Info>
      Cada agente pode ter múltiplas ferramentas configuradas simultaneamente para máxima funcionalidade.
    </Info>
  </Accordion>
</AccordionGroup>

### Passo 2: Selecionar Ferramenta

<AccordionGroup>
  <Accordion icon="list" title="Escolher da biblioteca Evo AI">
    1. Uma **biblioteca de ferramentas** mantida pela Evo AI será exibida
    2. Navegue pelas categorias e selecione a ferramenta que atende às suas necessidades
    3. Cada ferramenta tem uma descrição detalhada das funcionalidades oferecidas
    4. **Todas as ferramentas são pré-testadas** e otimizadas pela equipe Evo AI

    <Info>
      **Biblioteca Curada**: Todas as ferramentas são selecionadas, testadas e mantidas pela Evo AI para garantir qualidade e performance.
    </Info>
  </Accordion>
</AccordionGroup>

### Passo 3: Configurar Parâmetros

<AccordionGroup>
  <Accordion icon="gear" title="Configurar parâmetros da ferramenta">
    1. Após selecionar a ferramenta, você verá a **tela de configuração**
    2. Preencha os **campos obrigatórios** (como API keys, configurações específicas)
    3. Configure **parâmetros opcionais** conforme necessário
    4. A Evo AI fornece **valores padrão otimizados** para facilitar a configuração

    <Tip>
      Os valores padrão são otimizados pela Evo AI. Só altere se tiver necessidades específicas.
    </Tip>
  </Accordion>

  <Accordion icon="check" title="Testar e salvar">
    1. **Teste a ferramenta** antes de salvar (quando disponível)
    2. **Revise todas as configurações** cuidadosamente
    3. Clique em **"Save"** para aplicar as configurações
    4. A ferramenta estará **imediatamente disponível** para o agente

    <Info>
      As ferramentas da biblioteca Evo AI são mantidas automaticamente, garantindo sempre a melhor performance.
    </Info>
  </Accordion>
</AccordionGroup>

## Biblioteca de Ferramentas Evo AI

### Ferramentas Disponíveis

<AccordionGroup>
  <Accordion icon="volume-high" title="Audio Tools">
    **Text to Speech** - Converte texto em fala usando ElevenLabs. Ideal para criar narrações para vídeos, gerar áudio para acessibilidade e produzir conteúdo para podcasts.

    *Configurações principais:*

    * API Token do ElevenLabs
    * Voice ID para seleção de voz
    * Controle de estabilidade e similaridade
    * Suporte a múltiplos idiomas

    **Speech to Text** - Converte fala de áudio em texto usando transcrição por IA. Perfeito para transcrever gravações de reuniões, converter áudio de podcast em texto e criar legendas.

    *Configurações principais:*

    * Provider (OpenAI, Groq, Google)
    * Chave de API específica
    * Detecção automática de idioma
    * Suporte a múltiplos formatos de áudio
  </Accordion>

  <Accordion icon="globe" title="Web Tools">
    **Web Scraper** - Extrai conteúdo de páginas web de forma inteligente. Útil para extrair conteúdo de artigos, obter informações de produtos e monitorar mudanças em websites.

    *Funcionalidades:*

    * Extração automática de conteúdo
    * Suporte a diferentes formatos de saída
    * Processamento inteligente de HTML
    * Compatibilidade com sites modernos
  </Accordion>
</AccordionGroup>

### Detalhes Técnicos das Ferramentas

<AccordionGroup>
  <Accordion icon="microphone" title="Text to Speech - Configuração Detalhada">
    **Campos Obrigatórios:**

    * `eleven_labs_token`: Token de autenticação do ElevenLabs
    * `voice_id`: ID da voz a ser utilizada

    **Campos Opcionais com Valores Padrão:**

    * `model_id`: "eleven\_multilingual\_v2" (modelo padrão)
    * `stability`: 0.5 (controle de estabilidade da voz)
    * `similarity_boost`: 0.75 (melhoria de similaridade)
    * `style`: 0.0 (controle de estilo)
    * `use_speaker_boost`: true (otimização de qualidade)
    * `speed`: 1.0 (velocidade de reprodução)

    **Formatos de Entrada:** Texto simples
    **Formatos de Saída:** MP3, WAV, MPEG
    **Limite de Texto:** 5.000 caracteres
  </Accordion>

  <Accordion icon="waveform" title="Speech to Text - Configuração Detalhada">
    **Campos Obrigatórios:**

    * `provider`: Provedor de transcrição (openai, groq, google)
    * `api_key_id`: ID da chave de API para o provedor selecionado

    **Campos Opcionais:**

    * `model`: "auto" (seleção automática do modelo)
    * `language`: "auto" (detecção automática de idioma)

    **Idiomas Suportados:**
    Auto, Inglês, Português, Espanhol, Francês, Alemão, Italiano, Japonês, Coreano, Chinês

    **Formatos de Entrada:** MP3, WAV, M4A, OGG, WebM
    **Formatos de Saída:** Texto simples, JSON estruturado
  </Accordion>

  <Accordion icon="spider" title="Web Scraper - Funcionalidades">
    **Características:**

    * Não requer configuração específica
    * Processamento automático de conteúdo
    * Extração inteligente de dados estruturados

    **Entrada:** URLs de páginas web
    **Saída:** HTML, texto simples ou JSON estruturado

    **Casos de Uso:**

    * Monitoramento de preços
    * Extração de artigos e notícias
    * Coleta de dados de produtos
    * Análise de conteúdo web
  </Accordion>
</AccordionGroup>

## Casos de Uso Práticos

### Workflows de Áudio

<AccordionGroup>
  <Accordion icon="podcast" title="Produção de conteúdo de áudio">
    **Cenário:** Agente que cria podcasts automaticamente

    **Ferramentas utilizadas:**

    * **Speech to Text**: Para transcrever entrevistas ou material de pesquisa
    * **Text to Speech**: Para gerar narração final

    **Fluxo:**

    1. Transcreve material de pesquisa com Speech to Text
    2. Processa e organiza o conteúdo
    3. Gera narração final com Text to Speech
    4. Produz conteúdo de áudio profissional
  </Accordion>
</AccordionGroup>

### Workflows de Web Scraping

<AccordionGroup>
  <Accordion icon="chart-line" title="Monitoramento e análise web">
    **Cenário:** Agente que monitora concorrência e tendências

    **Ferramentas utilizadas:**

    * **Web Scraper**: Para extrair dados de sites específicos

    **Fluxo:**

    1. Extrai informações de sites de concorrentes
    2. Analisa preços e características de produtos
    3. Identifica tendências de mercado
    4. Gera relatórios automatizados
  </Accordion>
</AccordionGroup>

## Vantagens da Biblioteca Evo AI

<AccordionGroup>
  <Accordion icon="rocket" title="Performance otimizada">
    **Benefícios:**

    * 🚀 **Setup instantâneo** - Ferramentas prontas para uso
    * ⚡ **Performance otimizada** - Configurações ajustadas pela Evo AI
    * 🔧 **Configuração mínima** - Apenas parâmetros essenciais
    * 📚 **Documentação integrada** - Guias detalhados na plataforma

    <Info>
      Cada ferramenta é otimizada especificamente para funcionar melhor dentro da plataforma Evo AI.
    </Info>
  </Accordion>

  <Accordion icon="shield" title="Confiabilidade garantida">
    **Qualidade assegurada:**

    * 🔒 **Segurança validada** - Todas as ferramentas são auditadas
    * 🔄 **Atualizações automáticas** - Sempre na versão mais recente
    * 📊 **Monitoramento 24/7** - Disponibilidade garantida
    * 🛠️ **Suporte técnico** - Equipe especializada disponível

    <Tip>
      A biblioteca é constantemente expandida com novas ferramentas baseadas nas necessidades dos usuários.
    </Tip>
  </Accordion>
</AccordionGroup>

## Solução de Problemas

<AccordionGroup>
  <Accordion icon="triangle-exclamation" title="Problemas comuns">
    **Ferramenta não funciona:**

    * Verifique se as credenciais de API estão corretas
    * Confirme se você tem saldo/créditos suficientes no provedor
    * Teste conectividade com o serviço externo
    * Verifique logs de erro no dashboard

    **Qualidade de áudio ruim (Text to Speech):**

    * Ajuste parâmetros de stability e similarity\_boost
    * Teste diferentes voice\_ids
    * Verifique se o texto está bem formatado
    * Considere usar modelo de voz diferente

    **Transcrição imprecisa (Speech to Text):**

    * Verifique qualidade do áudio de entrada
    * Teste diferentes providers
    * Configure o idioma manualmente se necessário
    * Use arquivos de áudio com menos ruído

    **Web Scraper retorna dados incompletos:**

    * Verifique se o site permite scraping (robots.txt)
    * Teste URLs específicas individualmente
    * Considere aguardar alguns segundos entre requisições
    * Confirme se o site não mudou sua estrutura
  </Accordion>
</AccordionGroup>

***

🔧 **Configuração concluída!** Seus agentes agora têm acesso às ferramentas especializadas da biblioteca Evo AI para funcionalidades avançadas de áudio e web!