Criar e configurar os agentes de IA

Para obter mais informações, consulte Configurar o agente de IA com script e configurar seções de agente autônomo de IA no guia de administração Webex AI Agent Studio.

Configurar agentes de IA em fluxo

Você pode usar um nó de agente da IA para responder a consultas específicas de um corpus ou base de conhecimento. Você também pode ativar conversações multiturn. O agente de IA pode fazer perguntas de acompanhamento, entender o contexto e fornecer respostas personalizadas.

Basta arrastar e soltar o nó do agente de IA para seu criador de fluxos visual para começar. Esse nó ajuda você a usar agentes com script e de IA autônomos configurados no Webex Estúdio do agente de IA.

Configurar variáveis de entrada e saída no nó do agente de IA

O nó Agente de IA contém dois métodos:

• Mensagem do processo: permite enviar mensagens de usuário ao agente selecionado e obter respostas do agente de volta.

• Fechar sessão: permite que você feche uma sessão do agente de IA. Em determinados cenários, pode ser necessário fechar uma sessão de agente de IA existente e iniciar uma nova. Ela pode ser feita usando um método específico no nó Agente da IA. Por exemplo, se uma sessão permanecer inativa por um período específico, o sistema fechará a sessão automaticamente para otimizar os recursos.

1. No método Processar mensagem, configure as seguintes variáveis de entrada:

   • Tipo de agente: o tipo de agente usado no fluxo, como script ou autônomo.

   • Agente: O agente que processa a mensagem do usuário e recebe uma resposta.

     Você pode ver os agentes de IA aos quais tem acesso no Webex AI Agent Studio. Para obter mais informações sobre o geranciamento de usuários e agentes no Webex AI Agent Studio, consulte Funções de usuário.

   • Mensagem: O nome da variável que contém a mensagem do cliente de entrada enviada ao agente de IA escolhido

   • Idioma: se o agente de IA escolhido for multilíngue, você poderá escolher o idioma da mensagem recebida na lista suspensa Idioma. Preenchemos a lista suspensa com base em idiomas nas configurações do agente de IA.

     Observação: desativamos essa lista suspensa para agentes com um único idioma.

   • Canal: o nome do canal do qual o sistema recebe a mensagem do cliente.

   • Identificador do usuário: forneça o identificador exclusivo do usuário para o canal escolhido.

   • Parâmetros personalizados (opcional): Você pode passar informações adicionais sobre o cliente ao Webex AI Agent Studio como um par de valores principais. Associamos essas informações ao perfil do usuário e as usamos para conversas posteriores. Por exemplo, você pode especificar se um usuário é um novo cliente ou um cliente existente.

     Chaves passadas como Parâmetros personalizados estão acessíveis como ${consumerData.extra_params.<your_key>} em respostas do agente.

     Atualmente, os parâmetros personalizados são suportados apenas para agentes de IA com script por meio de canais digitais.

   • Parâmetros de mensagem (opcional): Você pode passar informações adicionais sobre a troca atual para o Webex AI Agent Studio como um par de valores principais.

     Não armazenamos essa mensagem e ela está disponível apenas para uso na próxima resposta do agente. Chaves passadas como Parâmetros de mensagem estão acessíveis como ${extra_params.<your_key>} em respostas do agente.

2. Configure as seguintes variáveis de saída no método Mensagem de processo:

   • TextResponse: a saída de texto configurada no agente da IA; funciona somente se nenhum outro tipo de elementos ricos ou especiais estiver presente. Além disso, para diversos itens de texto na resposta, o primeiro item de texto será retornado.

   • FullResponse: a resposta completa com todos os elementos ricos e várias mensagens presentes na saída do agente.

   • Armazenamento de dados: um JSON/dict de todas as variáveis de sessões definidas pelo usuário dentro do agente

   • TransactionId: O ID de transação da solicitação no Webex AI Agent Studio

   • ID da Sessão: A sessão/ID de conversação no Webex AI Agent Studio

   • ConsumerId: O ID do cliente em Webex AI Agent Studio

   • MessageMetadata: os metadados associados à resposta atual do agente configurado

   • SessionMetadata: os metadados associados à sessão para a resposta atual do agente configurado

     Atualmente, a MessageMetadata e a SessionMetadata têm suporte apenas para agentes de IA com script por meio de canais digitais.

   • ResponsePayload: O carregamento de resposta completo do Webex AI Agent Studio

3. Configure as seguintes variáveis de entrada no método Fechar sessão:

   • Agente: o agente que processa a mensagem do usuário e recebe uma resposta.

     Você pode ver os agentes de IA aos quais tem acesso no Webex AI Agent Studio. Para obter mais informações sobre o geranciamento de usuários e agentes no Webex AI Agent Studio, consulte Funções de usuário.

   • ID da sessão: fechamos a sessão do agente de IA. O ID da sessão está disponível como uma variável de saída do método de mensagem Processo.

Resultados de Nó

Você pode ver a lista de resultados de nó possíveis para esse nó. É possível personalizar os rótulos de nó usando o ícone Editar (lápis). O nó sai por uma das bordas de nó correspondentes ao resultado do nó. Cada nó de agente da IA corresponde a um resultado de nó. Aqui está uma lista de resultados de nó.

• Erro (Vermelho): indica o seguinte:

  • onError: quando o agente não respondeu com uma mensagem.

  • onInvalidCustomerID: quando um identificador do cliente está ausente.

  • onInvalidMessage: quando o valor da mensagem está faltando.

• Êxito (Verde): indica o seguinte:

  • onSuccess: quando o agente responde com uma mensagem.

  • onAgentHandover: quando o agente levanta uma solicitação para transferência para os agentes.

• Tempo limite (Amarelo/Âmbar):: indica o seguinte:

  • onTimeOut: quando o agente não respondeu em mais de 15 segundos.