Agentes Generativos

Assistentes generativos são agentes de IA baseados em Large Language Models (LLMs) que processam mensagens em linguagem natural, consultam bases de conhecimento e executam ações via gatilhos. Diferente dos flows determinísticos, os assistentes decidem dinamicamente como responder.

Assistente vs. Chatbot

Configuração do Prompt

`Prompt` — Instruções Principais

O campo principal de instruções do assistente. Define personalidade, objetivo, limitações e comportamento.

• Máximo: 4.000 caracteres
• Mínimo: 10 caracteres

Você é a Sofia, assistente de vendas da Empresa X.
Seu objetivo é qualificar leads e agendar demonstrações do produto.

PERSONALIDADE:
- Tom profissional mas descontraído
- Empático e orientado a solução
- Sempre usa o nome do cliente quando disponível

LIMITAÇÕES:
- Nunca mencione concorrentes
- Não discuta preços sem antes qualificar o lead
- Se não souber responder, ofereça falar com um humano

PROCESSO DE QUALIFICAÇÃO:
1. Entender o problema/necessidade
2. Identificar o porte da empresa
3. Perguntar sobre orçamento disponível
4. Oferecer demonstração gratuita

`CustomPrompt` — Template Avançado

Quando IsCustomPrompt está ativado, o CustomPrompt substitui a forma como o contexto de conhecimento é injetado. Use a variável ${{conhecimento}} para controlar onde os dados do RAG aparecem:

Você é um assistente especializado em suporte técnico.
Responda APENAS com base nas informações abaixo:

=== BASE DE CONHECIMENTO ===
${{conhecimento}}
=== FIM DA BASE ===

Referência temporal: ${{horario}}

Se a resposta não estiver na base de conhecimento acima,
responda: "Não encontrei essa informação na documentação.
Posso conectar você com nossa equipe técnica?"

`RestrictedByContext`

Quando ativado, o assistente adiciona automaticamente ao prompt a instrução:

"Quando o assunto fugir do contexto fornecido, informe a não capacidade de responder."

Ideal para assistentes especializados que devem se limitar a um domínio específico.

Idioma

Força o idioma das respostas do assistente:

Base de Conhecimento (RAG)

O sistema de Retrieval-Augmented Generation permite que o assistente responda com base em documentos específicos da sua empresa.

Como funciona

Mensagem do usuário
        ↓
Busca vetorial por similaridade
        ↓
Trechos mais relevantes recuperados
        ↓
Inseridos no contexto do LLM
        ↓
LLM responde com base nos trechos

Adicionando documentos

Acesse Assistente → Base de Conhecimento → Adicionar Arquivo. Formatos aceitos:

• PDF, DOCX, TXT
• URLs de páginas web
• Dados estruturados (JSON, CSV)

`${{conhecimento}}` no CustomPrompt

A variável ${{conhecimento}} recebe automaticamente os trechos mais relevantes recuperados pelo RAG. Use no CustomPrompt para posicioná-los exatamente onde quiser no prompt.

Se não usar CustomPrompt, os trechos são inseridos automaticamente após o prompt principal.

Transcrição de Áudio

O assistente transcreve automaticamente mensagens de voz enviadas pelo usuário antes de processá-las. A transcrição é retornada no campo transcriptions da resposta da API.

Copilot

O Copilot é um segundo agente que opera em modo interno, usado para auxiliar atendentes humanos ou sistemas de automação.

Configuração

Modo Copilot vs. Modo Normal

O copilot é ativado enviando "copilot": true no body da request de atualização de sessão.