> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/operacao-uso-do-sistema/configuracoes/copilot-ia.md). # Copilot IA ### Finalidade O **Copilot IA** é o assistente de **IA do atendente**. Em um ticket específico, o operador ativa um agente (tipo suporte, comercial, etc.); a IA lê o histórico e pode sugerir/enviar respostas e, no **modo agente**, executar ações no ticket (fila, tags, Kanban, nota, encerrar, etc.). Não confundir com: | Recurso | Papel | | --------------------------- | --------------------------------------- | | **Copilot IA** (este guia) | Assistente do atendente, por ticket | | **Inteligência Artificial** | Auto-resposta do **canal** (sem humano) | | **Robô de Atendimento** | Fluxo visual (menus) no canal | Se o canal já tem **Prompt IA** (`promptId`), o Copilot **não** processa automaticamente aquele ticket (anti-dupla-resposta). \[\[FOTO]] *** ### Caminho / permissão / licença | Item | Valor | | ---------------------- | ------------------------------------------------------------------------ | | **Menu** | Configurações → **Copilot IA** | | **URL** | `/configuracoes/copilot-ia` | | **Licença do card** | **PREMIUM** | | **Módulo `activeia`** | **Não** exige (é independente do Prompt IA) | | **Uso no atendimento** | Admin/super **ou** usuário com `hasCopilotAccess`, e sistema configurado | \[\[FOTO]] *** ### Visão geral da tela Duas áreas principais: 1. **Toggle + Configurações Gerais** — liga o Copilot no tenant e define token/URL da API. 2. **Agentes de IA** — cadastro dos assistentes (AbacusConfigs) com prompt e permissões. \[\[FOTO]] *** ### Toggle global e Configurações Gerais | Campo | Para que serve | | ------------------------------ | ---------------------------------------------------------- | | **Copilot** (enabled/disabled) | Liga/desliga o recurso no tenant | | **Token da API** | Credencial do provedor (Bearer) | | **URL da API** | Origem **sem** `/v1` no final (o backend acrescenta `/v1`) | **Provedores compatíveis (exemplos na UI):** Abacus RouteLLM, OpenAI, Azure OpenAI, Groq, Together, Mistral, Fireworks, OpenRouter, DeepSeek, xAI, Cerebras, DeepInfra, Perplexity, NVIDIA NIM, Ollama, LiteLLM/proxy. **Ações:** Salvar · Testar conexão · Copiar token. **Regras:** * Não salva como **enabled** sem token e URL. * URL com `/v1` no final pode gerar path duplicado (`…/v1/v1/...`). * O botão **Testar conexão** na UI é **simulado** (não valida de fato o provedor) — valide com uma mensagem real no atendimento. URL padrão de referência: `https://routellm.abacus.ai`. \[\[FOTO]] *** ### Agentes de IA Lista com visualizar, editar, ativar/desativar e excluir. Botão **Novo assistente**. #### Tipos de agente `suporte`, `administrativo`, `juridico`, `financeiro`, `saude`, `comercial`. #### Campos básicos do modal | Campo | Obrigatório | Para que serve | Padrão típico | | ----------------------------------- | ----------- | -------------------------------------------- | ---------------- | | **Nome** | Sim | Identificação | — | | **Tipo** | Sim | Qual agente o atendente escolhe no FAB | — | | **Modelo** | — | Modelo no provedor | `route-llm` | | **Prompt do sistema** | Sim | Instruções do agente | — | | **Temperatura** | — | Criatividade | 0.7 | | **Max tokens** | — | Tamanho da resposta | 4000 | | **Histórico** | — | Quantas mensagens enviar | 10 | | **Streaming** | — | Resposta em stream | off | | **Resposta automática** | — | Envia reply sozinho (crítico no modo agente) | off | | **Aceitar áudio / vídeo / imagens** | — | Tipos de mídia processáveis | áudio/imagens on | | **Ativo** | — | Agente disponível para ativação | on | \[\[FOTO]] #### Modo Agente (ações no ticket) Quando **modo agente** está ligado, a IA pode decidir ações além do texto. | Permissão | Efeito | | ---------------- | ------------------------------------------------------------------------------- | | Responder | Envia mensagem ao cliente (só se resposta automática estiver on no modo agente) | | Transferir fila | Move o ticket de fila | | Add/Remove tag | Etiquetas | | Mover Kanban | Move card | | Nota interna | Cria nota | | Encerrar | Fecha o ticket | | Prioridade | Altera prioridade | | Analisar imagens | Vision/análise | **Recursos adicionais:** ações permitidas, etiquetas/kanbans/filas permitidos, máximo de ações por mensagem, tools HTTP em JSON, mensagens de fallback e handoff. \[\[FOTO]] *** ### Como usar no Atendimento 1. Admin: habilita Copilot + token/URL + cria pelo menos **um agente ativo**. 2. Atendente com acesso vê o FAB **robô** no atendimento. 3. Clica → escolhe o **tipo** do agente → **Ativar** (ou Atualizar / Desativar). 4. Sistema cria sessão do Copilot no ticket. 5. Nova mensagem do **cliente** pode disparar o processamento em background. #### Quando o Copilot responde (gates) Em geral só processa se: * Ticket **sem** fila (`queueId`) * Status `pending` ou `bot` * **Sem** robô de fluxo ativo no ticket (`chatFlowId` / webhook bot) * Canal **sem** Prompt IA (`promptId`) * Sessão Copilot **ativa** no ticket #### Modo simples vs modo agente | Modo | Comportamento | | --------------- | -------------------------------------------------------------------------------- | | Sem modo agente | Processa e envia reply se sucesso | | Com modo agente | Executa ações permitidas; reply automático só com **Resposta automática** ligada | #### Feedback na UI * Badge verde = sessão ativa * Spinner = processando * Banner no chat = Copilot ligado * Eventos em tempo real (ativado / desativado / processando / processado / erro) \[\[FOTO]] *** ### Erros comuns | Sintoma | Causa provável | | ------------------------- | ----------------------------------------------------------- | | FAB não aparece | Sem PREMIUM / sem acesso / Copilot desligado / sem agente | | 403 ao ativar | Toggle ou token ausente | | 404 no tipo | Agente inexistente ou inativo | | Não responde sozinho | Canal com Prompt IA; ticket com fila/humano; sessão inativa | | Modo agente sem texto | `autoResponse` desligado | | URL inválida | `/v1` duplicado na base | | Teste “ok” mas falha real | Teste da tela é simulado | \[\[FOTO]] *** ### Dicas * Configure primeiro **Gerais** (token/URL), depois os agentes. * Use tipos diferentes (suporte vs comercial) com prompts distintos. * No modo agente, restrinja filas/tags/Kanban e o máximo de ações. * Para só sugerir sem enviar, mantenha resposta automática off (e use o fluxo operacional da equipe). * Não vincule Prompt IA no mesmo canal se quiser Copilot automático no ticket. * Valide com mensagem real após salvar — não confie só no “Testar conexão”.