Criar o protótipo do agente
Objetivos de aprendizagem
Após concluir esta unidade, você estará apto a:
- Criar um tópico personalizado para seu caso de uso do Agentforce.
- Planejar os fluxos, Apex e modelos de prompt para as ações do agente.
- Explicar algumas considerações para criar ações de referência.
Como criar um protótipo
Nora e sua equipe de projetos têm desenvolvido o agente de IA e feito experiências no ambiente de sandbox enquanto realizam atividades de planejamento para o projeto do Agentforce. Porém, como a Coral Cloud criou o protótipo do agente de IA na organização do Salesforce? Acompanhe a abordagem da equipe para que você possa iniciar a iteração da sua própria solução.
Primeiro, veja como Nora aborda a criação do tópico que a Coral Cloud criou para o caso de uso de gerenciamento de reservas.
Preparar o palco para a conversa
Os tópicos são um componente importante do Agentforce porque o tópico define o objetivo do agente de IA e apresenta o contexto e a direção necessários para atingir esse objetivo.
Quando um usuário começa a conversar com um agente de IA, o cérebro do Agentforce (seu mecanismo de raciocínio) trabalha com o modelo de linguagem grande (LLM) em segundo plano para resolver ambiguidades da conversa e estabelecer a intenção do usuário. Em seguida, ele avalia todos os tópicos disponíveis para o agente e escolhe o tópico mais adequado ao objetivo do usuário. Quando você estiver criando seus tópicos, será necessário facilitar ao máximo a escolha do tópico certo pelo mecanismo de raciocínio. Se o mecanismo não escolher o tópico certo, não terá acesso às ações certas, ou seja, não terá as ferramentas necessárias para realizar o trabalho.
Criar o tópico
O Agentforce tem ferramentas integradas para ajudar você a criar seu tópico, mas Nora também pode escolher entre tópicos prontos para uso e editar tópicos existentes. Ao analisar as diferentes partes de um tópico, Nora pode facilmente escolher um rótulo, a descrição da classificação, o escopo e as instruções.
Rótulo
O rótulo do tópico deve refletir o trabalho que deve ser feito. Para o caso de uso da Coral Cloud, o gerenciamento de reservas é identificado como um trabalho a ser feito. Portanto, o nome do novo tópico é Gerenciamento de reservas. Quando um agente tiver vários tópicos, verifique se os nomes não são muito semelhantes, para o mecanismo de raciocínio conseguir diferenciá-los.
Descrição da classificação
A descrição da classificação inclui de 1 a 3 frases que descrevem o que o tópico faz. Um agente usa essa descrição para determinar quando usar um tópico em uma conversa. A descrição da classificação deve ser semanticamente distinta dos outros tópicos do agente. Além disso, ela é mais eficaz quando reflete com precisão os tipos de consultas que devem acionar o tópico.
Veja a primeira iteração da descrição da classificação da Coral Cloud: “Responde a perguntas e atende a solicitações relacionadas à reserva do hotel, confirmação ou itinerário de viagem de um hóspede.”
Escopo
Quando o agente seleciona o tópico Gerenciamento de reservas, o escopo determina o que o agente pode ou não fazer. Ele é mais eficaz quando define com precisão o trabalho do agente.
Durante a fase de definição do caso de uso, a equipe de projetos da Coral Cloud sabiamente inicia com uma versão MVP do agente de IA que trata do gerenciamento de reservas. Em seguida, eles expandem gradualmente o escopo do agente nas duas versões seguintes. Como você pode imaginar, os limites de cada versão devem ser refletidos no escopo do tópico no Criador do Agentforce.
Veja como o escopo pode ser escrito para a versão MVP do tópico.
"Seu trabalho é apenas ajudar o usuário respondendo a perguntas sobre reservas de hotéis e dar informações aos hóspedes sobre reservas existentes. Você também pode reenviar o email de confirmação da reserva ou o itinerário. Nunca faça novas reservas, nem modifique ou cancele reservas. Nunca trate de questões não relacionadas às reservas do hotel.”
Quando a Coral Cloud expande os recursos do agente na segunda versão do tópico, a equipe de projetos pode atualizar o escopo do tópico para incluir a modificação e a criação de reservas, mas exclui cancelamentos e reembolsos.
Instruções
As instruções ajudam um agente a tomar decisões sobre como realizar o trabalho e como usar as ações atribuídas ao tópico. As instruções são escritas em linguagem natural. Um exemplo de uma instrução para o tópico da Coral Cloud poderia ser: “Sempre confirme os detalhes de uma modificação de reserva com o usuário antes de finalizar qualquer alteração.”
Considere que as instruções do tópico não são determinísticas, ou seja, não podem garantir o mesmo resultado 100% das vezes. Essa é a natureza da IA generativa. Por isso, Nora e sua equipe garantem que regras comerciais, requisitos e proteções importantes ou confidenciais sejam incorporados à funcionalidade das ações do agente, e não às instruções do tópico. Por exemplo, em vez de adicionar a instrução “Não reembolse uma reserva a menos que ela tenha sido cancelada até 2 dias após a data de check-in”, a Coral Cloud cria uma ação de agente que avalia os critérios para emitir um reembolso.
Ao criar o protótipo do seu agente, sugerimos que as instruções do tópico sejam criadas por último. Não é possível escrever instruções eficazes sem saber quanta lógica foi incorporada às ações e quantas decisões estão sendo tomadas pelo agente. Depois que a equipe da Coral Cloud cria tópicos e ações, ela pode testar o agente de IA. Em seguida, eles podem adicionar e refinar as instruções do tópico seguindo as melhores práticas na Ajuda do Salesforce e no Blog de desenvolvedores do Salesforce.
Hora de agir
Na unidade anterior, a Coral Cloud definiu os processos de negócios relacionados às reservas de hotéis. Muitos desses processos de negócios foram transformados em ações personalizadas para o tópico Gerenciamento de reservas.
A boa notícia em relação a ações personalizadas é que você não precisa criá-las do nada. Na verdade, as ações personalizadas se baseiam em tecnologias do Salesforce que você já conhece e ama. Quando você cria uma ação personalizada, ela é criada sobre uma funcionalidade existente da plataforma que você deseja disponibilizar no Agentforce, como classes Apex invocáveis, fluxos iniciados automaticamente e modelos de prompt. No Agentforce, chamamos essa funcionalidade subjacente de ação de referência. Ela oferece uma maneira incrível de aproveitar melhor os recursos da Salesforce Platform.
Considerações sobre o design para ações de referência
Qual é a abordagem da Coral Cloud para a criação de ações de referência subjacentes (Apex, fluxos e modelos de prompt) para as ações do agente? Veja a seguir alguns fatores considerados pela equipe.
Determinística ou baseada em prompt
Ao desenvolver a funcionalidade da plataforma subjacente para as ações do agente, comece analisando as tarefas e os processos de negócios relacionados ao seu caso de uso. Em seguida, decida se o processo ou tarefa deve ser determinística ou baseada em prompts.
-
Determinística: Usa uma classe invocável do Apex ou um fluxo iniciado automaticamente para gerar resultados. As ações baseadas em fluxos ou no Apex são determinísticas e usam lógica e regras comerciais para gerar um resultado consistente.
-
Baseada em prompt: Usa um ou mais modelos de prompt para gerar resultados. Uma ação baseada em prompt permite que você controle como uma resposta é escrita ou use recursos de raciocínio e geração de um LLM. Por exemplo, para gerar um resumo ou realizar uma análise de sentimento, é necessário usar um modelo de prompt como uma ação de referência. Os modelos de prompt também são usados para basear um agente em dados, como conhecimento ou dados de sistemas externos.
É importante considerar que uma ação pode combinar abordagens determinísticas e baseadas em prompts. Por exemplo, digamos que quando um hóspede cancela a reserva, uma ação baseada em fluxo é acionada para concluir o cancelamento. Em algum momento durante esse fluxo, o agente também pode seguir uma solicitação para pedir ao cliente informações sobre o motivo do cancelamento. O agente poderá até resumir a resposta do cliente e apresentar esse resumo para análise se o cliente indicar um motivo específico para o cancelamento. Com o tempo, a Coral Cloud pode usar essa abordagem combinada para entender melhor e responder aos problemas que afetam os clientes. Ela poderia chamar um modelo de prompt que envia um email de confirmação de cancelamento com ofertas personalizadas para atrair esse cliente específico a fazer uma reserva futura.
Atômica ou composta
Outro fator a ser considerado é se a ação de referência é atômica ou composta.
-
Atômica: Uma tarefa pequena e simples. Uma abordagem modular dá ao agente a liberdade de combinar ações de diferentes formas para atingir um objetivo mais sofisticado. Também tende a proporcionar mais oportunidades de reutilização de ações em diferentes tópicos.
-
Composta: Uma tarefa complexa composta por várias subtarefas. A vantagem de uma ação composta é que o usuário controla a sequência exata de etapas que o agente executa para concluir uma tarefa.
Entradas e resultados
No Agentforce, cada ação do agente deve ter pelo menos uma entrada, ou seja, o fluxo subjacente, o Apex ou o modelo de prompt também deve ter pelo menos uma entrada. Por exemplo, para procurar uma reserva de hotel, a entrada pode ser o email do hóspede ou o número da reserva. Durante uma conversa, o agente de IA tem autonomia para recolher informações e decidir se tem todos os detalhes necessários para acionar a ação e aprovar a entrada.
Cada ação também deve ter pelo menos um resultado. A forma como você cria a ação determina o resultado, como ele é usado e se e como ele é exibido aos usuários na conversa. Não tenha medo de experimentar ações de teste que não estejam totalmente implementadas. Elas podem ser uma ótima maneira de ver como suas ideias funcionam quando executadas.
Ações de referência da Coral Cloud
Depois de considerar os processos de negócios e as diferentes maneiras de criar o Apex, fluxos e modelos de prompt, a equipe de projetos da Coral Cloud propôs essas ações de referência para o tópico Gerenciamento de reservas.
-
Obter reserva por email: Um fluxo que procura uma reserva existente usando o endereço de email do hóspede.
-
Obter reserva por número: Um fluxo que procura uma reserva existente usando o número da reserva.
-
Enviar confirmação de reserva: Uma classe do Apex que envia ao hóspede um email de confirmação com os detalhes da reserva.
-
Criar ou atualizar reserva: Um fluxo que cria uma nova reserva caso não haja uma. Se a reserva existir, ele atualiza o registro.
-
Cancelar reserva: Um fluxo que cancela uma reserva existente. O fluxo chama um modelo de prompt que envia um email de confirmação de cancelamento com ofertas personalizadas para promover reservas futuras.
-
Iniciar reembolso: Um fluxo que processa um reembolso pelo cancelamento de uma reserva se determinadas condições forem atendidas.
De ações de referência a ações de agentes
A criação de todos os fluxos, o Apex ou os modelos de prompt necessários para seu caso de uso pode levar algum tempo. Porém, transformá-los em ações personalizadas de agentes é muito fácil!
Quando você cria uma ação personalizada, o rótulo da ação e o nome da API são preenchidos com o nome da ação de referência existente e o nome da API. As instruções para a ação personalizada e cada entrada e resultado também são preenchidas com as descrições da ação de referência.
As instruções da ação dizem ao agente de IA o que uma ação específica faz e quando ela deve ser acionada. Instruções bem escritas garantem que as ações sejam usadas de forma consistente e precisa. Para saber mais sobre como otimizar as instruções de ações, confira as melhores práticas para instruções de ações.
A Coral Cloud tem agora um conjunto de ações para seu caso de uso, portanto, a equipe de projetos atribui-as a um tópico. Agora eles estão prontos para testar o protótipo e refinar os blocos de construção.
Avaliar o desempenho
Depois de configurar um protótipo no Agentforce, é importante testar e observar o desempenho do agente de IA. Há duas opções para testar o agente de IA.
- Teste manual no Criador do Agentforce
- Teste em lote no Centro de testes
A equipe da Coral Cloud testa o agente de IA com perguntas e solicitações que os usuários podem fazer sobre reservas de hotéis. Em seguida, eles respondem a estas perguntas.
- O agente interpreta com precisão a entrada do usuário?
- Ele inicia as ações certas?
- Ele oferece respostas úteis e precisas?
- O agente executa corretamente os processos de negócios e cumpre as políticas e regras da empresa?
Com base nos resultados do teste, a equipe da Coral Cloud refina as instruções do tópico e continua a iterar no agente de IA. E lembre-se: se você estiver recebendo erros durante o processo de teste, verifique as permissões do seu agente de IA.
Últimos retoques
Há alguns outros itens que a equipe da Coral Cloud precisa eliminar da lista de tarefas enquanto aperfeiçoa o protótipo.
- Personalize o tópico de escalação padrão para que ele possa encaminhar as conversas para representantes de serviço em tempo real quando necessário.
- Crie uma solução de autenticação para verificar os usuários que interagem com o agente de IA.
-
Conecte o agente de IA aos canais do cliente.
Quando Nora e sua equipe chegam ao ponto em que o agente de IA funciona de forma confiável e precisa no ambiente de sandbox da Coral Cloud, eles criam o plano de implantação para lançar o agente de IA na produção. Em seguida, eles monitoram o agente e isso ajuda-os a melhorar e a iterar continuamente na criação do agente.
Uma base sólida
Agora você já sabe que o planejamento e a criação de um agente de IA envolve o estabelecimento de uma base sólida. É preciso identificar o caso de uso e os objetivos, pensar na estratégia de dados, considerar a experiência do usuário e definir os requisitos técnicos do projeto. Aborde os riscos potenciais e defina seus processos de negócios para garantir que o agente de IA esteja em conformidade com os requisitos operacionais, de segurança, legais, éticos e regulamentares da sua organização.
Não cometa o erro de adotar uma abordagem em cascata na criação de agentes. Ou seja, não é necessário desenvolver e implantar com um plano linear e em fases. À medida que você analisa sua solução do Agentforce de todos os ângulos necessários, pratique e comece a criar protótipos do agente de IA em seu ambiente de sandbox. Dessa forma, você não perderá muito tempo com um plano que poderá não funcionar no final. Ao combinar um planejamento minucioso com a experimentação contínua, você poderá implantar um agente de IA confiável capaz de gerar valores transformadores para sua organização.