> ## 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 specialized tools from the Evo AI library to extend your agents capabilities

## Overview

The **Evo AI Tools Library** offers a curated set of specialized tools that can be integrated into your agents. These tools provide advanced functionalities for:

* **Audio processing** with text-to-speech and speech-to-text conversion
* **Web data extraction** with intelligent web scraping
* **Multimedia processing** for different types of content
* **Integration with specialized APIs** maintained by Evo AI

<Note>
  **Evo AI Library**: All tools are provided and maintained by Evo AI.
  You only need to configure the necessary parameters and your API credentials.
</Note>

## How to Configure a Tool

### Step 1: Access Agent Settings

<AccordionGroup>
  <Accordion icon="gear" title="Navigate to settings">
    1. Go to the **agents screen** in the dashboard
    2. Locate the agent you want to configure
    3. Click on the **"Settings"** icon (⚙️) on the agent card and then on **"Edit"**
    4. You will be directed to the agent settings screen
  </Accordion>

  <Accordion icon="wrench" title="Access Tools">
    1. In the settings screen, locate the **"Tools"** section
    2. Click on **"Add"** to add a new tool

    <Info>
      Each agent can have multiple tools configured simultaneously for maximum functionality.
    </Info>
  </Accordion>
</AccordionGroup>

### Step 2: Select Tool

<AccordionGroup>
  <Accordion icon="list" title="Choose from Evo AI library">
    1. A **tools library** maintained by Evo AI will be displayed
    2. Browse through categories and select the tool that meets your needs
    3. Each tool has a detailed description of the functionalities offered
    4. **All tools are pre-tested** and optimized by the Evo AI team

    <Info>
      **Curated Library**: All tools are selected, tested and maintained by Evo AI to ensure quality and performance.
    </Info>
  </Accordion>
</AccordionGroup>

### Step 3: Configure Parameters

<AccordionGroup>
  <Accordion icon="gear" title="Configure tool parameters">
    1. After selecting the tool, you will see the **configuration screen**
    2. Fill in the **required fields** (such as API keys, specific settings)
    3. Configure **optional parameters** as needed
    4. Evo AI provides **optimized default values** to facilitate configuration

    <Tip>
      Default values are optimized by Evo AI. Only change them if you have specific needs.
    </Tip>
  </Accordion>

  <Accordion icon="check" title="Test and save">
    1. **Test the tool** before saving (when available)
    2. **Review all settings** carefully
    3. Click on **"Save"** to apply the settings
    4. The tool will be **immediately available** for the agent

    <Info>
      Tools from the Evo AI library are maintained automatically, ensuring always the best performance.
    </Info>
  </Accordion>
</AccordionGroup>

## Evo AI Tools Library

### Available Tools

<AccordionGroup>
  <Accordion icon="volume-high" title="Audio Tools">
    **Text to Speech** - Converts text to speech using ElevenLabs. Ideal for creating video narrations, generating audio for accessibility and producing podcast content.

    *Main settings:*

    * ElevenLabs API Token
    * Voice ID for voice selection
    * Stability and similarity control
    * Multi-language support

    **Speech to Text** - Converts speech from audio to text using AI transcription. Perfect for transcribing meeting recordings, converting podcast audio to text and creating subtitles.

    *Main settings:*

    * Provider (OpenAI, Groq, Google)
    * Specific API key
    * Automatic language detection
    * Support for multiple audio formats
  </Accordion>

  <Accordion icon="globe" title="Web Tools">
    **Web Scraper** - Intelligently extracts content from web pages. Useful for extracting article content, obtaining product information and monitoring website changes.

    *Features:*

    * Automatic content extraction
    * Support for different output formats
    * Intelligent HTML processing
    * Compatibility with modern sites
  </Accordion>
</AccordionGroup>

### Technical Tool Details

<AccordionGroup>
  <Accordion icon="microphone" title="Text to Speech - Detailed Configuration">
    **Required Fields:**

    * `eleven_labs_token`: ElevenLabs authentication token
    * `voice_id`: ID of the voice to be used

    **Optional Fields with Default Values:**

    * `model_id`: "eleven\_multilingual\_v2" (default model)
    * `stability`: 0.5 (voice stability control)
    * `similarity_boost`: 0.75 (similarity enhancement)
    * `style`: 0.0 (style control)
    * `use_speaker_boost`: true (quality optimization)
    * `speed`: 1.0 (playback speed)

    **Input Formats:** Plain text
    **Output Formats:** MP3, WAV, MPEG
    **Text Limit:** 5,000 characters
  </Accordion>

  <Accordion icon="waveform" title="Speech to Text - Detailed Configuration">
    **Required Fields:**

    * `provider`: Transcription provider (openai, groq, google)
    * `api_key_id`: API key ID for the selected provider

    **Optional Fields:**

    * `model`: "auto" (automatic model selection)
    * `language`: "auto" (automatic language detection)

    **Supported Languages:**
    Auto, English, Portuguese, Spanish, French, German, Italian, Japanese, Korean, Chinese

    **Input Formats:** MP3, WAV, M4A, OGG, WebM
    **Output Formats:** Plain text, structured JSON
  </Accordion>

  <Accordion icon="spider" title="Web Scraper - Features">
    **Characteristics:**

    * No specific configuration required
    * Automatic content processing
    * Intelligent structured data extraction

    **Input:** Web page URLs
    **Output:** HTML, plain text or structured JSON

    **Use Cases:**

    * Price monitoring
    * Article and news extraction
    * Product data collection
    * Web content analysis
  </Accordion>
</AccordionGroup>

## Practical Use Cases

### Audio Workflows

<AccordionGroup>
  <Accordion icon="podcast" title="Audio content production">
    **Scenario:** Agent that creates podcasts automatically

    **Tools used:**

    * **Speech to Text**: To transcribe interviews or research material
    * **Text to Speech**: To generate final narration

    **Flow:**

    1. Transcribes research material with Speech to Text
    2. Processes and organizes content
    3. Generates final narration with Text to Speech
    4. Produces professional audio content
  </Accordion>
</AccordionGroup>

### Web Scraping Workflows

<AccordionGroup>
  <Accordion icon="chart-line" title="Web monitoring and analysis">
    **Scenario:** Agent that monitors competition and trends

    **Tools used:**

    * **Web Scraper**: To extract data from specific sites

    **Flow:**

    1. Extracts information from competitor sites
    2. Analyzes prices and product features
    3. Identifies market trends
    4. Generates automated reports
  </Accordion>
</AccordionGroup>

## Evo AI Library Advantages

<AccordionGroup>
  <Accordion icon="rocket" title="Optimized performance">
    **Benefits:**

    * 🚀 **Instant setup** - Tools ready to use
    * ⚡ **Optimized performance** - Settings tuned by Evo AI
    * 🔧 **Minimal configuration** - Only essential parameters
    * 📚 **Integrated documentation** - Detailed guides in the platform

    <Info>
      Each tool is optimized specifically to work better within the Evo AI platform.
    </Info>
  </Accordion>

  <Accordion icon="shield" title="Guaranteed reliability">
    **Assured quality:**

    * 🔒 **Validated security** - All tools are audited
    * 🔄 **Automatic updates** - Always on the latest version
    * 📊 **24/7 monitoring** - Guaranteed availability
    * 🛠️ **Technical support** - Specialized team available

    <Tip>
      The library is constantly expanded with new tools based on user needs.
    </Tip>
  </Accordion>
</AccordionGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion icon="triangle-exclamation" title="Common issues">
    **Tool not working:**

    * Check if API credentials are correct
    * Confirm you have sufficient balance/credits with the provider
    * Test connectivity with the external service
    * Check error logs in the dashboard

    **Poor audio quality (Text to Speech):**

    * Adjust stability and similarity\_boost parameters
    * Test different voice\_ids
    * Check if text is well formatted
    * Consider using a different voice model

    **Inaccurate transcription (Speech to Text):**

    * Check input audio quality
    * Test different providers
    * Set language manually if necessary
    * Use audio files with less noise

    **Web Scraper returns incomplete data:**

    * Check if the site allows scraping (robots.txt)
    * Test specific URLs individually
    * Consider waiting a few seconds between requests
    * Confirm the site hasn't changed its structure
  </Accordion>
</AccordionGroup>

***

🔧 **Configuration complete!** Your agents now have access to specialized tools from the Evo AI library for advanced audio and web functionalities!