Criando um Agente no SipPulse AI

Este guia mostra o processo de criação de um novo agente inteligente usando SipPulse AI. Os agentes podem realizar uma variedade de tarefas, desde responder consultas de clientes até analisar dados e automatizar fluxos de trabalho.

Como Começar

Para criar um novo agente, navegue até a seção Agentes no menu lateral e clique no botão Criar Agente. Isso o levará à interface de criação de agentes, que inclui várias abas para configuração.

Configuração do Perfil

O primeiro passo para criar um agente é configurar seu perfil:

Nome (Obrigatório)

Digite um nome único e descritivo para seu agente. Este nome será exibido em toda a interface e ajuda a identificar o agente na plataforma.

Observação: O próprio agente não terá conhecimento desse nome, a menos que você o inclua explicitamente nas instruções.

Descrição

Forneça uma breve descrição do propósito e capacidades do seu agente. Embora não seja visível para o próprio agente, esta descrição é útil para:

• Documentar o uso pretendido do agente
• Referência em configurações com múltiplos agentes onde um agente de nível superior precisa selecionar entre agentes
• Ajudar os membros da equipe a entender a função do agente

Seleção de Modelo

Escolha o modelo de IA que alimentará seu agente entre várias categorias de provedores:

Provedores de Modelos Disponíveis:

• Qwen - Inclui qwen-max (R$ 14,30 por 1M tokens de entrada / R$ 57,00 por 1M tokens de saída)
• OpenAI - Modelos GPT
• Anthropic - Modelos Claude
• Deepseek - Modelos de raciocínio avançado
• Meta - Modelos Llama
• Google - Modelos Gemini

Modelos Anthropic Claude:

• claude-3-7-sonnet: R$ 26,70 por 1M tokens de entrada / R$ 134,00 por 1M tokens de saída
• claude-3-5-sonnet: R$ 26,70 por 1M tokens de entrada / R$ 134,00 por 1M tokens de saída
• claude-3-5-haiku: R$ 7,13 por 1M tokens de entrada / R$ 35,60 por 1M tokens de saída
• claude-3-haiku-20240307: R$ 2,23 por 1M tokens de entrada / R$ 11,10 por 1M tokens de saída

Escolha seu modelo com base em:

• Complexidade da tarefa (modelos mais avançados para raciocínio complexo)
• Requisitos de velocidade (modelos Haiku são os mais rápidos)
• Considerações orçamentárias (diferenças significativas de preço entre modelos)
• Capacidades específicas necessárias para seu caso de uso

Instruções

A aba Instruções é onde você define o comportamento, conhecimento e capacidades do seu agente:

Instruções do Sistema

Esta é a parte mais crítica da configuração do seu agente. Aqui, você fornecerá instruções detalhadas sobre:

• Propósito do agente: Quais tarefas ele deve realizar
• Personalidade: Como ele deve se comunicar (formal, casual, empático, etc.)
• Domínio de conhecimento: Quais informações específicas ele deve conhecer
• Formato de resposta: Como ele deve estruturar suas respostas
• Limitações: O que ele não deve fazer ou discutir

Dicas para instruções eficazes:

• Seja específico e detalhado
• Use exemplos quando possível
• Estruture suas instruções logicamente
• Inclua quaisquer requisitos especiais de formatação
• Defina como o agente deve lidar com perguntas incertas ou fora do escopo

Ferramentas

A aba Ferramentas permite habilitar várias capacidades para o seu agente além da conversação básica. Essas ferramentas ampliam a funcionalidade do seu agente e o ajudam a concluir tarefas específicas.

Ferramentas Habilitadas

As ferramentas que estão atualmente ativas para seu agente aparecerão no painel esquerdo com interruptores de alternância:

• Encerrar Diálogo: Permite que o agente encerre adequadamente uma conversa quando os objetivos são atingidos ou quando a conversa deve ser terminada.
• Transferir Chamada: Permite que o agente transfira uma conversa para outro agente ou para um operador humano quando necessário.

Você pode editar a configuração de cada ferramenta habilitada clicando no ícone de edição (lápis) ou remover uma ferramenta usando o ícone de exclusão (lixeira).

Adicionando Novas Ferramentas

Para adicionar mais ferramentas ao seu agente, clique no botão + Nova ferramenta. Isso permitirá que você selecione entre as categorias de ferramentas disponíveis no menu suspenso Módulo.

Módulos de Ferramentas Disponíveis

A plataforma oferece várias categorias de ferramentas que você pode adicionar ao seu agente:

Funções Internas

Use uma ou mais de nossas funções internas para estender as capacidades do seu agente:

• Calculadora: Realizar operações aritméticas básicas.
• Navegador: Pesquisar informações na web.
• Data e Hora Atuais: Acessar informações do relógio em tempo real.

Integração com API

Conecte-se a outros serviços online usando APIs. Apenas defina os detalhes necessários, e o sistema faz o resto. Isso permite que seu agente:

• Recupere dados de serviços externos
• Envie informações para outros sistemas
• Acione ações em plataformas integradas

Base de Conhecimento

O sistema usa seus próprios documentos e informações para responder a perguntas com mais precisão e contextualmente. Isso permite que seu agente:

• Acesse informações específicas da empresa
• Referencie documentos internos
• Forneça respostas baseadas em seus dados proprietários
• Mantenha consciência contextual do domínio do seu negócio

Ferramentas Manuais

Aqui, você decide quando e como executar uma tarefa. Ideal para integração com outros softwares ou quando você precisa realizar uma ação personalizada. As ferramentas manuais permitem:

• Integrações personalizadas com software existente
• Ações aprovadas por humanos
• Fluxos de trabalho de decisão complexos
• Processamento de dados especializado

SIP

Ferramentas de integração SIP para chamadas de voz. Essas ferramentas permitem que seu agente:

• Faça chamadas telefônicas de saída
• Receba chamadas de entrada
• Transfira chamadas para destinos apropriados
• Interaja com sistemas de telefonia

Melhores Práticas para Configuração de Ferramentas

• Habilite apenas ferramentas que seu agente realmente precisa
• Configure limitações apropriadas para navegação na web para evitar comportamento inesperado
• Considere implicações de segurança ao habilitar ferramentas que acessam sistemas externos
• Teste seu agente com cada nova ferramenta para garantir que as use adequadamente
• Para integrações de API, forneça documentação clara sobre entradas e saídas esperadas

Parâmetros

A aba Parâmetros permite ajustar o comportamento do agente:

Parâmetros do Modelo

• Temperatura: Controle a aleatoriedade nas respostas (0,0 para determinístico, 1,0 para criativo)
• Máximo de Tokens de Saída: Limite o comprimento das respostas
• Top P: Controle a diversidade na seleção de palavras
• Janela de Contexto: Defina quanto do histórico de conversação o agente deve considerar

Configurações de Conversação

• Gerenciamento de Memória: Configure como o agente armazena e recupera informações
• Timeouts de Conversação: Defina timeouts de inatividade para conversas

Humano no Circuito

A aba Humano no Circuito permite configurar quando e como especialistas humanos podem intervir em conversas com seu agente. Esse recurso é particularmente valioso para lidar com consultas complexas ou situações em que a expertise humana é necessária.

Escalar para Humano

Este é o principal recurso na seção Humano no Circuito:

Como funciona: Ao habilitar este recurso, quando o assistente não sabe como responder a uma pergunta, ele encaminha a consulta para um ou mais especialistas registrados. O especialista recebe um link, responde à pergunta e, assim que a resposta é enviada, o assistente tem acesso imediato a essa informação e continua a conversa com base nela. Este recurso permite que uma pessoa ou equipe intervenha e complemente o agente quando necessário.

Benefícios:

• Garante respostas de qualidade mesmo quando o assistente não possui o conhecimento necessário
• Proporciona transições suaves entre suporte de IA e humano
• Mantém a continuidade da conversa durante escalações
• Ajuda a expandir a base de conhecimento do agente ao longo do tempo

Opções de Configuração

Para configurar a funcionalidade Humano no Circuito:

1. Ativação: Alterne o interruptor "Ativo" para habilitar ou desabilitar o recurso de escalação.

2. Informações de Contato do Especialista: Adicione endereços de e-mail dos membros da equipe que devem receber consultas escaladas:

   • Use o menu suspenso para selecionar o método de contato (E-mail é mostrado na captura de tela)
   • Digite o endereço de e-mail (por exemplo, flavio@sippulse.com)
   • Use o botão "+" para adicionar especialistas adicionais
   • Use o botão "-" para remover especialistas da lista

Melhores Práticas

• Tempo de Resposta: Garanta que os especialistas estejam disponíveis para responder rapidamente às consultas escaladas
• Treinamento a partir de Escalações: Revise regularmente as perguntas escaladas para identificar padrões e melhorar as instruções do seu agente
• Rotação de Especialistas: Considere configurar uma rotação de especialistas para lidar com escalações em diferentes horários
• Diretrizes Claras: Forneça aos especialistas diretrizes claras sobre como responder às consultas escaladas
• Monitoramento: Acompanhe a frequência e natureza das escalações para identificar oportunidades de melhoria

Salvando e Testando

Depois de configurar todas as configurações necessárias, clique no botão Salvar na parte inferior da página. Seu agente será criado e listado na seção Agentes.

Antes de implantar em produção, recomendamos:

1. Testar seu agente no ambiente Playground
2. Revisar conversas para precisão e tom
3. Fazer melhorias iterativas nas instruções e parâmetros

Próximos Passos

Depois de criar seu agente, você pode:

• Configurar integrações com seus sistemas existentes

Para mais informações sobre opções de configuração específicas, consulte nossa documentação detalhada para cada recurso.