Configurar evento personalizado de entrada no AI Agent Studio

1. Na página configuração do agente de IA, crie uma nova resposta no número de respostas Tab.
2. Na resposta padrão, clique em+ próximo ao canal Padrão (Web) para adicionar o canal de Voz
3. No campo Nome do evento recebido, defina o nome do evento que o agente recebe.

Invocar evento personalizado do Designer de Fluxos

1. No Webex Contact Center Designer de fluxos, configure a atividade V2 do agente virtual no fluxo.
2. Nas configurações do Evento de Estado, especifique os seguintes detalhes no Nome do evento - colunas dos Dados do evento:

   1. Digite o nome de evento personalizado que você configurou no response Tab da página de configuração de agente de IA no AI Agent Studio.

   2. Insira os dados personalizados que deseja passar do Designer de fluxos para o agente de IA de script.

Acessar dados de eventos personalizados no AI Agent Studio

Você pode acessar os dados do evento (configurados no Designer de Fluxos) na seção de resposta padrão, onde configurou seu evento de entrada. Na figura a seguir, você pode ver que o nome do evento personalizado "custom_welcome" e o "nome de loja" dos dados do evento são passados do Designer de fluxos para o Estúdio do agente de IA.

Configurar evento de saída personalizado &payload no AI Agent Studio

1. No Estúdio de agentes da IA, navegue até a página de configuração de agente de IA com script e vá para Resposta onde deseja que o controle seja passado de volta ao designer de fluxos.

2. Adicionar um evento personalizado à seção de resposta Padrão.

3. Insira no JSON o nome do evento e os dados de carga de evento que você deseja que seja retornados ao fluxo.

Neste exemplo, os slots coletados são retornados ao fluxo com o evento de saída personalizado "order_details".

Acessar dados de eventos personalizados no Designer de Fluxos

Você pode acessar o evento personalizado e a carga útil da seção Variáveis de saída da atividade virtual do Agente V2 .

O nome do evento é retornado sob a variável StateEventName e a carga de pagamento Evento é retornada como Metadados , como mostrado na figura a seguir:

Atualizar valores do sistema no AI Agent Studio

Você pode atualizar valores do sistema como contexto, intenção e slot usando um evento especial state_update e carga horária de Evento com os valores, conforme mostrado no exemplo a seguir:

{ "intent": "order_status", "slots": { "first_name": "John" } } 

No exemplo acima, a intenção do agente com script é definida para order_status, o slot 'first_name' nessa intenção é definido como 'John' e um contexto chamado 'track' é adicionado à sessão.

Esse evento é útil para casos de uso em que a conversa de agente com script deve ser controlada pela lógica de fluxo. Alguns casos de uso em que isso é especialmente útil incluem:

• Solicitar novamente ao usuário informações se a conclusão no fluxo falhar

  Considere um cenário em que o agente está reservando uma consulta para um usuário. Depois de reunir a data e a hora, essas informações são enviadas ao fluxo através de um evento personalizado, que então tenta marcar a consulta usando uma atividade de solicitação de HTTPS. Se a nomeação for rejeitada devido a um conflito de agendamento, o agente de IA precisará solicitar um intervalo de tempo alternativo. Para lidar com isso, o desenvolvedor pode usar a seguinte carga de eventos:

  { "intent": "book appointment", "slots": { "time": "" } }

  Nesse caso, o valor coletado para o tempo é limpo e o agente de IA solicita ao usuário que forneça um novo. Os desenvolvedores podem configurar respostas condicionais para permitir que os usuários saibam que o slot anterior não estava disponível e solicitar um novo horário.

• Navegue até uma intenção diferente

  Considere um cenário em que um usuário solicita verificar seu saldo, mas como um pré-requisito, o usuário deve primeiro verificar sua identidade. Como parte do processo de consulta de saldo, os desenvolvedores podem enviar uma carga de eventos para informar o fluxo se o usuário já foi verificado. Se verificado, o sistema pode continuar buscando o saldo; se não, o fluxo pode solicitar ao agente de IA que inicie o processo de verificação do usuário usando a seguinte carga de evento:

  { "intenção": "verify user", }

  Nesse mesmo exemplo, digamos que a verificação requer a data de nascimento do usuário e o código PIN. Do fluxo já tem informações sobre a data de nascimento do usuário via CJDS, que podem ser passadas como um slot e somente PIN código pode ser coletado. A carga de evento para isso será como:

  { "intenção": "verificar usuário", "slots": { "data de nascimento": "06/26/1993" } } }

• Introduzir ou redefinir o contexto em uma conversação

  Quando o contexto da conversação precisa ser atualizado, os desenvolvedores podem incluí-lo na carga de eventos para o evento state_update . Por exemplo, após o Agente de IA coletar os slots para a intenção 'verificar usuário', ele define o contexto da conversa para 'verificar'. Se a verificação falhar no fluxo, o contexto deverá ser redefinido para impedir que o usuário acesse intenção que requerem o contexto de 'verificar'. A carga de evento para este cenário seria como:

  { "intenção": "verify user", "slots": { "date of birth": "", "pincode": "" }, "context": { "verify": 0 } }