# Agente de Voz para Suporte ao Cliente

> Uma aplicação de agente de suporte ao cliente alimentada pelo SDK da OpenAI que fornece respostas por voz a perguntas sobre a sua base de conhecimento utilizando as capacidades do GPT-4o e TTS da OpenAI. O sistema navega por websites de documentação com Firecrawl, processa o conteúdo numa base de conhecimento pesquisável com Qdrant e fornece respostas em texto e voz às consultas dos utilizadores.

- Fonte: https://doutorai.pt/apps/customer-support-voice-agent
- Categoria: Agentes de Voz
- Dificuldade: Médio
- Modelos: OpenAI
- Frameworks: OpenAI Agents SDK
- Corre local?: Precisa de APIs cloud
- Chaves necessárias: OPENAI_API_KEY
- Licença: Apache-2.0
- Site: Doutor AI (https://doutorai.pt) - ferramentas de IA para pequenos negócios em português

## Tutorial completo

# 🎙️ Agente de Voz para Suporte ao Cliente

### 🎓 Tutorial Gratuito Passo a Passo
**👉 [Clica aqui para seguir o nosso tutorial completo passo a passo](https://www.theunwindai.com/p/build-a-customer-support-voice-agent) e aprende a construir isto do zero com explicações detalhadas e melhores práticas.**

Uma aplicação de agente de suporte ao cliente alimentada pelo SDK da OpenAI que fornece respostas por voz a perguntas sobre a tua base de conhecimento utilizando as capacidades do GPT-4o e TTS da OpenAI. O sistema navega por websites de documentação com o Firecrawl, processa o conteúdo numa base de conhecimento pesquisável com o Qdrant e fornece respostas em texto e voz a consultas dos utilizadores.

## Funcionalidades

- Criação de Base de Conhecimento

  - Navega por websites de documentação utilizando o Firecrawl
  - Armazena e indexa conteúdo utilizando a base de dados vetorial Qdrant
  - Gera embeddings para capacidades de pesquisa semântica utilizando o FastEmbed
- **Equipa de Agentes de IA**
  - **Processador de Documentação**: Analisa o conteúdo da documentação e gera respostas claras e concisas a consultas dos utilizadores
  - **Agente TTS**: Converte respostas em texto em fala natural com o ritmo e ênfase apropriados
  - **Personalização de Voz**: Suporta várias vozes TTS da OpenAI:
    - alloy, ash, ballad, coral, echo, fable, onyx, nova, sage, shimmer, verse

- **Interface Interativa**
  - UI limpa do Streamlit com configuração na barra lateral
  - Pesquisa de documentação em tempo real e geração de respostas
  - Reprodutor de áudio incorporado com capacidade de download
  - Indicadores de progresso para inicialização do sistema e processamento de consultas

## Como Executar

1. **Configurar Ambiente**

```bash
   # Clone the repository
   git clone https://github.com/Shubhamsaboo/awesome-llm-apps.git
   cd awesome-llm-apps/voice_ai_agents/customer_support_voice_agent
   
   # Install dependencies
   pip install -r requirements.txt
   ```

```markdown
2. **Configura as Chaves da API**
   - Obtém a chave da API OpenAI na [Plataforma OpenAI](https://platform.openai.com)
   - Obtém a chave da API Qdrant e a URL na [Qdrant Cloud](https://cloud.qdrant.io)
   - Obtém a chave da API Firecrawl para rastreamento de documentação

3. **Executa a Aplicação**
```

```bash
   streamlit run ai_voice_agent_docs.py
   ```

4. **Usa a Interface**
   - Introduz as credenciais da API na barra lateral
   - Insere a URL da documentação que desejas explorar
   - Seleciona a tua voz preferida no menu suspenso
   - Clica em "Initialize System" para processar a documentação
   - Faz perguntas e recebe respostas em texto e voz

## Funcionalidades em Detalhe

- **Criação de Base de Conhecimento**
  - Cria uma base de conhecimento pesquisável a partir da tua documentação
  - Preserva a estrutura do documento e os metadados
  - Suporta rastreamento de múltiplas páginas (limitado a 5 páginas por configuração padrão)

- **Pesquisa Vetorial**
  - Usa FastEmbed para gerar embeddings
  - Capacidades de pesquisa semântica para encontrar conteúdo relevante
  - Recuperação eficiente de documentos usando Qdrant

- **Geração de Voz**
  - Texto para fala de alta qualidade usando os modelos TTS da OpenAI
  - Múltiplas opções de voz para personalização
  - Padrões de fala naturais com o ritmo e ênfase adequados

## Poupe horas todas as semanas com IA, sem complicações

O **Doutor AI** dá-lhe 1859 prompts de IA prontos a copiar, por indústria e em português simples - mais uma biblioteca técnica completa para quem quer ir mais longe. [Ver planos →](https://doutorai.pt/precos)

---
Conteúdo de Doutor AI (https://doutorai.pt). Ao citar, indique a fonte: https://doutorai.pt/apps/customer-support-voice-agent