Como utilizar o Agente de IA?

Índice: 

1. Como utilizar o Agente de IA?
2. Criação e configurações básicas do Agente de IA
3. Personalização do Agente de IA
4. Boas práticas para Orientações do Agente de IA
5. Redirecionamento

 

Como utilizar o Agente de IA?

Configure seu Agente para responder a perguntas e realizar tarefas através da criação de Habilidades, utilizando outros sistemas se necessário. Defina regras claras e saiba quando transferir o atendimento para outros bots ou para um atendente humano.

 

Saiba como criar uma habilidade de dúvida aqui.

Saiba como criar uma habilidade personalizada aqui. 

 

Criação e configurações básicas do Agente de IA

Agente de IA é a entidade que você irá configurar para interagir com a pessoa usuária, ele pode funcionar isoladamente ou conectado a um roteador ou outro chatbot.

Para usar o Agente de IA, você precisa ter o perfil de administrador de um contrato no Blip e acessar a home do contrato. A opção de criar o “Agente de IA” está na barra superior, ao lado de “criar chatbot”,  conforme imagem abaixo.

 

 

Na tela inicial do contrato, você verá a interface mostrada na imagem anterior. Ao clicar no botão “Conhecer Agente de IA”, você terá acesso a uma visão geral dos benefícios de utilizar um Agente de IA, além de poder realizar um teste rápido para experimentar seu funcionamento.

 

Conheça os benefícios de um Agente de IA

 

Ao clicar em “Criar agora” ou em “Criar Agente de IA” você irá realizar as configurações básicas do Agente,  conforme imagem abaixo.

 

Defina um nome para seu Agente

 

Configurações básicas do Agente

 

A seguir temos uma explicação de cada um dos campos de configuração do Agente:

• Nome do Agente: como o seu Agente será chamado em caso de a pessoa usuária perguntar com quem fala ou caso o Agente se apresente durante a interação. Esse campo tem preenchimento obrigatório
• Tom de voz da conversa: definição de como será a comunicação do Agente para melhor se adequar a sua marca ou produto. É possível selecionar uma de três opções: amigável, divertido ou técnico. Caso o campo não seja preenchido, será aplicada a opção amigável.
• Idioma da conversa: Definição do idioma principal a ser utilizado pelo sistema para interação com o usuário final. As opções disponíveis são português, inglês e espanhol.
• Nome da empresa ou nome do produto: o nome do produto ou da empresa que o Agente de IA está representando no contato. Esse campo tem preenchimento obrigatório.

Ao finalizar a edição das configurações básicas do seu Agente, clique no botão “criar” e o Agente de IA será criado, onde outras configurações mais específicas poderão ser realizadas.

 

Tela principal do seu Agente

 

Personalização do Agente de IA

Após a configuração inicial do seu Agente de IA, a personalização é fundamental. Nessa etapa, definem-se as orientações que guiarão o comportamento do Agente.

Na aba de “Studio”, na opção “Perfil” é possível acessar os dados já preenchidos na etapa de “configurações básicas”, bem como configurações mais específicas conforme imagem abaixo.

 

A seguir temos uma explicação de cada um dos campos complementares de personalização do Agente:

1. Orientações Para o Agente de IA: são diretrizes informadas por linguagem natural que o agente utiliza durante sua atuação. Defina os objetivos específicos, o contexto de atuação e os limites e restrições do agente para garantir que ele tenha todas as instruções necessárias para executar seu caso de uso.

2. Orientações avançadas: Agentes de IA operam de acordo com o contexto definido, processando informações e tomando decisões com base em objetivos estabelecidos. Configurações avançadas permitem personalizar esses objetivos para atender necessidades específicas. Ativar esta opção alterará significativamente a interação com o agente, e a manutenção do novo prompt será sua responsabilidade.

Limitações de busca: o agente passará a consultar não apenas os documentos e o contexto fornecidos, mas também sua base de conhecimento completa para encontrar a melhor resposta;

Respostas padronizadas: o agente não fornecerá uma resposta padrão que evite informações imprecisas ao não encontrar respostas em seus documentos;

Evitar a menção de concorrentes: o agente poderá mencionar concorrentes ou serviços similares;

Personalização da resposta: o agente não seguirá um formato específico, deixando de garantir clareza e objetividade.

Apesar de zerar o prompt, ainda existem variáveis úteis que talvez façam sentido para a aplicação. 

Atualmente o produto possui algumas variáveis que podem ser passadas ao prompt. Para passar essas variáveis ao prompt é  ecessário colocar elas entre chaves no ‘guidelines’, exemplo:

‘guidelines’: ‘Seu nome é {agent_name}, um agent da empresa {company_name}. considere os seguintes documentos para montar sua resposta: {documents}’.

 

 

3. Caso o agente não saiba responder: Frase que o agente fornecerá ao usuário final se questionado sobre um tópico desconhecido.

 

Boas práticas para Orientações do Agente de IA

• Evite sempre ser prolixo;
• O Agente usa um GenAI para entender e gerar as respostas para interações realizadas, quanto maior os textos fornecidos nas configurações e instruções, maior chance de confusão e alucinação;
• Lembre sempre de configurar a resposta padrão para os casos em que o Agente não tenha a resposta ou não consiga gerá-la;

 

Orientações para a criação de Guidelines:

• Antes de definir o estilo de comunicação ou as orientações, é importante determinar claramente o propósito do Agente como ele irá atuar;
• Seja claro sobre o estilo no qual o Agente deve se comunicar. Exemplo: “O assistente deve se comunicar de forma clara e concisa, evitando jargões técnicos e linguagem excessivamente formal. O tom deve ser amigável, acolhedor e acessível, com foco em explicar conceitos de forma simples e objetiva.”;
• Instruções específicas, concisas, claras e diretas geram melhores respostas;
• O processo de criação de Agentes é iterativo e vai necessitar de experimentação, com diferentes instruções, palavras-chave e contextos;
• Inicie com instruções simples, adicionando elementos e contexto gradualmente.
• Mantenha um controle das alterações feitas nas instruções do Agente;
• A especificidade é crucial para resultados eficazes, ou seja, se as instruções começarem a ficar grandes, pode ser necessário criar mais de um Agente para resolver o problema em questão. Contexto específico e relevante geralmente resulta em melhores resultados
• Instruções muito grandes e/ou complexas podem gerar certa confusão no modelo ao dar as respostas para o usuário;
• Use comandos específicos como "Escrever", "Classificar", "Resumir", etc.
• Deixe claro sobre quais pontos/assuntos o Agente não deve falar ou fazer comparações.

 

Exemplo de correção nas instruções (guidelines):

Case: Um Agente para tirar dúvidas e ajudar os alunos de uma pós-graduação em Inteligência Artificial. Inicialmente podemos dar as seguintes orientações/instruções:

 

“Você irá atuar como um assistente pessoal para ajudar os alunos de uma disciplina de uma pós-graduação em Inteligência Artificial. Explique sobre os temas perguntados e gere uma implementação para o aluno.”

 

Esse é um exemplo de orientação que pode ser melhorada para aprimorar as respostas do AI-Agente. Ela é genérica e pouco estruturada, o que pode gerar respostas amplas ou pouco focadas, além de não ter nenhuma limitação sobre o assunto que pode ser tratado na interação com o Agente.

 

Problemas com as orientações originais:

• Vaga e ampla: "Explique sobre os temas perguntados" e "gere uma implementação" não especificam quais temas ou o que exatamente a implementação deve fazer.
• Falta de contexto: Não menciona qual o nível de conhecimento dos alunos, os objetivos da disciplina, ou o tipo de implementação esperada.
• Instruções genéricas: O AI-Agente pode não saber como priorizar a explicação ou a implementação.

 

Orientações Refinadas

"Você será um assistente pessoal para ajudar os alunos da disciplina de Pós-Graduação em Inteligência Artificial, com foco em aprendizado supervisionado, redes neurais e deep learning. Ao responder às dúvidas, forneça explicações detalhadas sobre os conceitos teóricos de forma clara e prática, voltada para alunos com conhecimento intermediário. Além disso, gere uma implementação em Python utilizando bibliotecas como Scikit-learn, Keras ou PyTorch para resolver problemas específicos que envolvam classificação e regressão."

 

Explicação

• Mais especificidade: O foco foi definido nos temas de "aprendizado supervisionado e redes neurais", facilitando a direção da resposta.
• Contexto para o nível dos alunos: Definir que o público tem conhecimento intermediário ajuda o Agente a ajustar a profundidade da explicação.
• Implementação específica: Mencionar bibliotecas específicas como Scikit-learn, Keras e PyTorch orienta a geração de código mais prático e relevante.
• Exemplos claros de tarefas: Indicar problemas como "classificação e regressão" direciona o tipo de implementação a ser gerada, aumentando a utilidade para os alunos.

 

Redirecionamento

Existem quatro métodos principais para direcionar o usuário a um determinado serviço, conforme imagem e descrição abaixo.

 

Os desenvolvedores que desejam usar as informações do Agente de IA no builder para melhor gerenciamento do fluxo do bot devem saber que cada opção de redirecionamento tem um contrato específico que pode ser acessado ao tratar a mensagem enviada pelo agente de IA como entrada do usuário. Para coletar esses dados, sugerimos adicionar um script na ação de saída do bloco inicial do fluxo. A entrada dessa ação será a própria entrada do usuário. Veja um exemplo de como criar um script para extrair os dados enviados pelo agente de IA:

 

EXEMPLO:

function run(jsonString) {

 try {

  // Parse o JSON

   const jsonObj = JSON.parse(jsonString);

    // Extraindo os valores

   const toolCallId = jsonObj.tool_call_id;

   const actionName = jsonObj.nome;

   const parameters = jsonObj.parameters;

   const resultObject = {

      name: actionName,

      parameters: parameters,

      toolCallId: tool_call_id

   };

   // Retornando os valores em um objeto

   return resultObject;

 } catch (error) {

   console.error("Erro ao processar o JSON:", error);

   return null;

 }

}

Cada contrato gerado por uma das opções de redirecionamento padrão incluirá um ou mais dos campos a seguir:

redirect: Tipo de redirecionamento que está sendo acionado.
user_message_id: Identificador único da mensagem do usuário que gerou o redirecionamento.
tool_call_id: (Quando aplicável) Identificador único da chamada da ferramenta.
name: (Quando aplicável) Nome da ação a ser executada.
parameters: (Quando aplicável) Parâmetros necessários para a execução da ação.
agent_response: (Quando aplicável) Lista de respostas retornadas pela IA.
mimetype: (Quando aplicável) Formato da mensagem de resposta.
content: (Quando aplicável) Conteúdo da mensagem de resposta.
user_message: (Quando aplicável) Mensagem do usuário que acionou o redirecionamento.
error_code: (Quando aplicável) Código do erro ocorrido.

1. Caso o agente não consiga responder a dúvida

   Na eventualidade de o Agente não conseguir fornecer a resposta ao usuário, o comportamento de redirecionamento pode ser configurado de duas maneiras distintas:

   Reformular pergunta: após X tentativas sem sucesso, onde X é a quantidade de vezes definida pelo usuário, em responder a dúvida do cliente, o Agente de IA irá tentar outras formas de responder o usuário, sempre se guiando pela base de conhecimento que possui.
   Transferir para serviço: após X tentativas sem sucesso, onde X é a quantidade de vezes definida pelo usuário, é possível determinar para qual o serviço o Agente de IA deverá encaminhar a conversa do usuário. No campo de “Para qual serviço deseja redirecionar?” deverá ser inserido um serviço previamente registrado no roteador do contrato.

   Exemplo:

   {
   
       "redirect": "negative_redirect",
   
       "user_message_id": "0c144f8a-783c-4411-a5c3-9cbd04b10e57"
   
   }

2. Caso o agente responda a dúvida

Nessa opção, quando o Agente gerar uma resposta e enviá-la ao usuário, este será redirecionado instantaneamente a um serviço registrado no roteador do contrato, encerrando a conversa com o Agente.

Exemplo de contrato:

{

    "redirect": "positive_redirect",

    "user_message_id": "0c144f8a-783c-4411-a5c3-9cbd04b10e57"

}

3. Caso o agente fique sem resposta do cliente

Essa opção escolhe para qual serviço, cadastrado no roteador do contrato, o usuário será mandado depois de ficar 1 hora inativo.

Exemplo de contrato:

{

    "redirect": "inactive_redirect",

}

4. Caso o agente encontre um caso de exceção

   Essa opção escolhe para qual serviço, cadastrado no roteador do contrato, o usuário será mandado após acontecer um caso de exceção de qualquer natureza. Nesse caso, o redirecionamento poderá ser configurado de duas maneiras:

   Definir mensagem: No campo 'Defina a mensagem que será enviada para o cliente', indique a resposta que o agente deve fornecer ao usuário em situações de exceção.
   Transferir para um serviço: No campo "Para qual serviço deseja redirecionar?", informe um serviço já registrado no roteador do contrato para onde o Agente de IA deve direcionar o usuário em situações de exceção.

Importante: Em situações de exceção, ao executar uma das opções de redirecionamento acima, a sessão do usuário com o Agente de IA será reiniciada.

Exemplo:

{

    "redirect": "unavailability_redirect",

    "user_message_id": "0c144f8a-783c-4411-a5c3-9cbd04b10e57",

    "error_code": "error_code"

}

Customizado

A opção de redirecionamento customizado permite que o agente direcione o usuário final para um serviço específico, previamente cadastrado no roteador do contrato, a partir de palavras-chave pré-definidas.

É possível criar múltiplos redirecionamentos, cada um associado a diferentes grupos de palavras-chave. Ao identificar uma palavra-chave cadastrada em um redirecionamento, a regra correspondente é aplicada automaticamente.

Assim como as opções de redirecionamento padrão, a opção "Customizado" também disponibiliza as informações do Agente de IA para uso no Builder, seguindo as mesmas regras e definições mencionadas na seção anterior.

 

Exemplo:

{

    "redirect": "keyword_redirect",

    "user_message_id": "0c144f8a-783c-4411-a5c3-9cbd04b10e57",

    "user_message": "mensagem do usuário"

}

Atendimento humano

É possível transferir o usuário para atendimento humano por meio de uma das quatro opções citadas. Nesse contexto, os serviços registrados devem ter o  atendimento humano configurado.

 

Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal. 😃