Criar uma ação de agente do Apex
Objetivos de aprendizagem
Após concluir esta unidade, você estará apto a:
- Criar uma ação de agente do Apex.
- Adicionar uma ação do agente a um tópico.
- Testar a ação do agente.
Nota
Deseja aprender em português (Brasil)? Comece o desafio em um Trailhead Playground de português (Brasil) e use as traduções fornecidas entre parênteses para navegar. Copie e cole somente os valores em inglês porque as validações dos desafios dependem de dados em inglês. Se você não passar no desafio em sua organização de português (Brasil), recomendamos que (1) mude o local para os Estados Unidos, (2) mude o idioma para inglês, seguindo as instruções aqui, e (3) clique novamente no botão “Validar o desafio”.
Consulte o emblema Trailhead no seu idioma para saber mais sobre como aproveitar a experiência de Trailhead em outros idiomas.
Criar uma ação de agente do Apex
Agora que o Apex está pronto, vamos adicioná-lo a uma ação. Você verá onde os parâmetros no Apex são automaticamente transferidos para a ação.
- Clique em Setup (Configuração)
e selecione Setup (Configuração).
- Em Setup (Configuração), na caixa Quick Find (Busca rápida), pesquise e selecione Agentforce Assets (Ativos do Agentforce).
- Clique na guia Actions (Ações).
- Clique em New Agent Action (Ação do novo agente).
- Em Reference Action Type (Tipo de ação de referência), selecione Apex.
- Em Reference Action Category (Categoria de ação de referência), selecione Invocable Method (Método invocável).
- Em Reference Action (Ação de referência), selecione Check Weather (Checar o tempo). Este é o método invocável.
- Em Agent Action Label (Rótulo da ação do agente), deixe o preenchimento automático, Check Weather (Checar o tempo), que foi extraído do parâmetro de rótulo do método invocável.
- Em Agent Action API Name (Nome da API da ação do agente), deixe o preenchimento automático gerado, Check_Weather.
- Clique em Avançar.
A próxima etapa é configurar a ação do agente. É aqui que você começa a perceber a vantagem de definir os parâmetros no Apex.
- Em Agent Action Instructions (Instruções de ação do agente), deixe o preenchimento automático fornecido pelo parâmetro de descrição do método invocável do Apex.
- Desmarque Show loading text for this action (Mostrar texto carregando para essa ação).
- Em Input (Entrada), observe que dateToCheck já está preenchido.
- Em Instructions (Instruções), observe que ele já vem preenchido com o parâmetro de descrição da variável invocável do Apex. Você também pode atualizar ou complementar as instruções, conforme necessário.
- Data Type (Tipo de dados) está preenchido automaticamente com o tipo de dados do Apex.
- Required input (Entrada obrigatória) está marcado por padrão a partir do parâmetro obrigatório definido como verdadeiro.
- Selecione Collect data from user (Coletar dados do usuário).
- Em Outputs (Saídas), há três que foram extraídas das variáveis invocáveis do Apex: maxTemperature, minTemperature e temperatureDescription. As instruções para cada uma são preenchidas automaticamente a partir dos parâmetros de descrição e do tipo de dados correspondentes.
- Para a terceira saída, temperatureDescription, selecione Show in conversation (Mostrar na conversa).
- Clique em Concluir.
Excelente! A ação está concluída. Agora você sabe o que é necessário para adicionar seu Apex às ações. E você tem uma melhor compreensão de como os parâmetros do Apex funcionam para ajudar a criar a ação. Vamos adicionar a ação do agente Check Weather (Checar o tempo) a um tópico e testá-la.
Atualizar o tópico
- Clique em Setup (Configuração)
e selecione Setup (Configuração).
- Em Setup (Configuração), na caixa Quick Find (Busca rápida), pesquise e selecione Agentforce Agents (Agentes do Agentforce).
- Selecione Einstein Copilot ou Agentforce (Default) (Agentforce (Padrão)).
- Clique em Open in Builder (Abrir no criador).
- Confirme que o agente esteja desativado.
- Selecione MigrationDefaultTopic.
- Clique em This Topic’s Actions (Ações desse tópico).
- Clique em New (Novo) e selecione Add from Asset Library (Adicionar a partir da biblioteca de arquivos).
- Marque a caixa da ação Check Weather (Checar o tempo) e clique em Finish (Concluir).
- Atualize a janela do navegador e selecione MigrationDefaultTopic.
- Clique em This Topic’s Actions (Ações desse tópico) e confirme que a ação Check Weather (Checar o tempo) ainda está na lista. Se não estiver, repita as etapas 8 a 11. Às vezes, em nossos ambientes de prática, uma ação adicionada não permanece associada ao tópico na primeira vez em que ele é salvo.
- Clique em Ativar. Nota: se o pop-up Configuration Issues Detected (Problemas de configuração detectados) aparecer, clique em Ignore & Activate (Ignorar e ativar).
Vamos checar o tempo
- Ainda no Criador do Agentforce, insira
Check the weather for tomorrow(Checar o tempo para amanhã) na janela Conversation Preview (Visualização da conversa).
- Observe as etapas seguidas pelo agente e repare que ele selecionou a ação Check Weather (Checar o tempo) para atender à solicitação.
- Quer saber a previsão do tempo para a próxima semana? Insira
Check the weather for next week(Checar o tempo para a próxima semana).
- Dê uma olhada nas etapas novamente. O agente enviou a data de cada dia da semana para criar a resposta.
Muito bem! Você deu um grande passo para usar todas as funcionalidades do Apex que sua organização já possui e disponibilizá-las para uso pelos agentes de IA. Você aprendeu algumas práticas recomendadas e como definir parâmetros para obter o máximo de seus agentes.