Configurar assistentes de IA
Um assistente é formado por três partes: o agente define identidade e público; a skill define como ele trabalha; e a role define quais fontes ele pode consultar e com quais limites.
Antes de começar
- É necessário ser administrador do projeto.
- Defina qual resultado o assistente deve entregar e quem realmente precisa usá-lo.
- Comece com o menor conjunto de fontes capaz de atender ao objetivo.
- Valide o assistente manualmente antes de usá-lo em uma rotina agendada.
Acesse a configuração
Acesse Configurar assistentes de IA.
Entenda agente, skill e role
| Parte | Define | Exemplo |
|---|---|---|
| Agente | Nome, ícone, skill, role, escopo, público, subagentes, áreas relacionadas e respostas rápidas. | Analista comercial disponível para gestores. |
| Skill | Objetivo, instruções, dados necessários e tipos de proposta que podem ser apresentados. | Analisar oportunidades e recomendar próximas ações. |
| Role | Fontes realmente permitidas, intensidade do trabalho e volume máximo por consulta. | CRM e BI, até 16 consultas com 25 registros cada. |
A skill não libera uma fonte sozinha. A role também precisa autorizar o recurso solicitado. Tudo que não estiver permitido permanece bloqueado.
Configure a skill
- Abra a seção Skills e crie um cadastro.
- Dê um nome orientado ao resultado e uma descrição curta.
- Nas instruções, descreva objetivo, critérios, limites e formato da resposta.
- Marque apenas os dados necessários.
- Escolha quais tipos de proposta podem ser apresentados.
- Ative e salve.
As propostas ficam aguardando revisão e aplicação manual. Entre as áreas disponíveis estão textos e e-mails, marketing, fluxos de chatbot, automações de CRM, webhooks e recomendações genéricas.
Configure a role
- Abra Roles e crie um cadastro.
- Escolha as fontes que a role pode consultar.
- Defina a intensidade máxima, de 8 a 40 consultas por execução.
- Defina o volume máximo por consulta, de 10 a 200 registros.
- Ative e salve.
Limites maiores podem ampliar custo, duração e volume analisado. Comece com Equilibrada e aumente somente quando um caso validado exigir.
Monte o agente
- Abra Agentes e clique em criar.
- Informe nome, ícone e descrição.
- Selecione a skill principal e a role de acesso.
- Escolha o escopo dos registros:
- Somente dados do executor inclui a pessoa que iniciou a execução nas consultas;
- Todos os dados já autorizados usa o escopo de projeto, empresa e equipes que essa pessoa já possui.
- Se necessário, restrinja o público por pessoas ou equipes organizacionais.
- Adicione subagentes apenas quando houver uma divisão clara de especialidades.
- Escolha as áreas em que o agente deve ser recomendado primeiro.
- Cadastre até seis respostas rápidas para pedidos recorrentes.
- Defina se o agente é exclusivo para administradores e deixe-o disponível.
- Salve e execute testes com usuários representativos.
Se pessoas e equipes autorizadas ficarem vazias, qualquer usuário que já tenha acesso ao recurso de IA poderá usar o agente. Para equipes, a verificação considera a equipe organizacional principal do usuário.
Teste antes de liberar
Valide pelo menos estes cenários:
- usuário permitido e usuário fora do público;
- registro próprio e registro fora do escopo;
- resposta com dados existentes e pedido com informação ausente;
- tentativa de consultar uma fonte não autorizada;
- proposta que exige revisão antes da aplicação;
- consumo de créditos em uma solicitação curta e em outra mais ampla.
Evite estes erros
| Erro | Risco | Correção |
|---|---|---|
| Skill ampla e role ampla sem objetivo definido | Respostas genéricas e consultas desnecessárias. | Restrinja objetivo, fontes e formato esperado. |
| Usar acesso amplo para compensar falta de configuração | Exposição desnecessária de dados autorizados. | Comece pelo escopo do executor e amplie com justificativa. |
| Liberar para toda a empresa no primeiro teste | Resultado inconsistente em perfis diferentes. | Teste primeiro com pessoas ou uma equipe controlada. |
| Criar respostas rápidas vagas | Pedidos sem período, critério ou saída clara. | Escreva a mensagem completa que será enviada ao agente. |
| Ativar rotina antes do teste manual | Erros recorrentes e consumo de créditos. | Valide o mesmo prompt na Central de IA antes de agendar. |