Você está aqui:
Integrar procedimentos de integração com Agentforce
Para disponibilizar Procedimentos de integração como um novo tipo de ação em Ações do agente, comece selecionando o Procedimento de integração desejado. Defina seus dados de entrada e saída no formato JSON e verifique os dados. Esse processo converte automaticamente o JSON de dados do procedimento de integração em um formato compatível com Agentforce. Em seguida, crie uma Ação do agente, configure o Agente e o Tópico e ative o Procedimento de integração integrado no Agentforce. Depois de configurado, o Procedimento de integração pode ser acionado durante interações entre agentes e clientes para promover a automação em tempo real e o acesso a dados.
Antes de começar:
- Verifique se você tem as permissões do OmniStudio. Consulte Conjuntos de permissões do OmniStudio.
- Habilite os Metadados do OmniStudio em sua organização. Consulte Habilitar suporte à API de metadados do OmniStudio.
Preparar um procedimento de integração para a integração do Agentforce
Antes de usar um Procedimento de integração no Agentforce, é importante observar que o formato de dados esperado pelo Agentforce é diferente do formato padrão do Procedimento de integração. Para garantir a compatibilidade, você deve preparar o Procedimento de integração de acordo.
- Na página do modo de exibição de lista Procedimento de integração, selecione e abra o Procedimento de integração que você deseja integrar ao Agentforce.
- Clique em Visualizar.
- Clique em Configurar Agentforce.
-
Defina os dados de entrada e saída para o Procedimento de integração no formato JSON e clique em Verificar dados.
Por exemplo, insira esses dados que incluam os detalhes da renda de um usuário no formato JSON para calcular o patamar de imposto base e o adicional com base no patamar de renda.Nota
Ao definir o JSON de entrada e saída, somente caracteres alfanuméricos (A-Z, a-z, 0-9) são permitidos para a chave no par chave-valor. Nenhum caractere especial é permitido.
Input Data JSON:
{ "taxpayerId": "TAXP123456", "financialYear": "2024-2025", "totalIncome": 1800000 }Resposta JSON de saída:
{ "taxpayerId": "TAXP123456", "financialYear": "2024-2025", "baseTax": 315000, "surcharge": 0, "totalTaxPayable": 315000 }Quando você clica em Verificar dados, a estrutura de dados é atualizada automaticamente.
- Clique em Avançar.
- Clique em Salvar.
- Ative o procedimento de integração.
Criar ações do agente
As Ações do agente atuam como conectores entre o Agentforce e o Procedimento de integração.
-
Em Configuração, pesquise e abra Ativos do Agentforce, clique em Ações e, em seguida, clique em Nova ação do agente.
Nota
As classes dinâmicas do Apex podem ser geradas automaticamente antes mesmo de configurar Procedimentos de integração como Ações do agente. Essas classes do Apex não têm impacto funcional e podem ser ignoradas com segurança.
- Selecione Procedimento de integração como o tipo de ação de referência.
- Selecione o Procedimento de integração desejado como a ação de referência.
- Insira um rótulo de ação do Agente.
- Insira um nome de API de ação.
- Clique em Avançar.
-
Forneça instruções de entrada:
- Selecione Requer entrada.
- Selecione Coletar dados do usuário.
-
Forneça instruções de saída:
- Selecione Selecionar Mostrar na conversa.
- Clique em Concluir.
Configurar um agente
Crie um agente para gerenciar fluxos de conversa e executar ações do agente. Adicione um tópico e associe-o à Ação do agente. Os tópicos definem intenções ou tarefas específicas que o Agente lida com.
Para obter informações sobre como configurar um agente, consulte Configurar seu agente.

