Ações do agente de IA
Crie uma resposta do agente de IA para a mensagem do usuário especificada. O agente deve estar ativo.
Edições obrigatórias
| Disponível em: Lightning Experience |
| Disponível em: Edições Enterprise, Performance, Unlimited e Developer. As licenças de complemento necessárias variam de acordo com o tipo de agente. |
| Exibir licenças para recursos integrados. |
No Flow Builder, adicione o elemento Executar agente ao seu fluxo. Selecione a categoria Ações do agente de IA. Em seguida, selecione o nome do agente com o qual criar uma resposta.
O nome da API para cada ação é prefixado com generateAIAgentResponse.
Definir valores de entrada
| Incluir parâmetro | Descrição |
|---|---|
| Solicitação de agente | Uma pergunta ou solicitação para enviar ao agente que gera a saída para essa ação. Esse campo está disponível na versão 1.1.0 e posteriores. |
| Mensagem do usuário | Uma pergunta ou solicitação para enviar ao agente que gera a saída para essa ação. Esse campo está disponível na versão 1.0.0 e anteriores. |
| ID da sessão | O ID da sessão da conversa na qual enviar respostas do agente. |
Configurar saída estruturada
Para configurar a saída estruturada, use a ação versão 1.1.0 e posteriores.
| Campo | Descrição |
|---|---|
| Nome do campo | Obrigatório. O nome alfanumérico exclusivo para o campo de saída estruturado. O nome não pode conter caracteres ou espaços especiais. |
| Descrição | Uma breve descrição usada com o nome do campo para aumentar a precisão do modelo de idioma grande (LLM). |
| Tipo de dados | Obrigatório. O tipo de dados do campo. Valores válidos:
|
| Obrigatório | Indica que o LLM deve gerar uma resposta para esse campo de saída. Exigir linhas de saída pode resultar em respostas imprecisas ou prejudiciais pelo LLM. |
Armazenar valores de saída
| Campo | Descrição |
|---|---|
| Resposta de agente | A resposta não estruturada do agente. Retorna null se a saída estruturada estiver configurada. |
| ID da sessão | O ID da sessão da conversa em que a resposta do agente está. |
| Resposta estruturada do agente | A saída estruturada do agente. Retorna null se nenhuma saída estruturada estiver configurada. Esse campo está disponível na versão 1.1.0 e posteriores. |
Uso
Essa ação estará disponível apenas se estes critérios forem atendidos. Caso contrário, a ação falha.
- Agentforce está habilitado.
- O usuário que executa o fluxo tem a permissão Gerenciar agentes de IA.
- O agente especificado tem uma versão ativa.
As entradas específicas da ação do agente personalizado selecionada são listadas após a seção Configurar saída estruturada.
Uso de saída estruturada
Antes de configurar a saída estruturada, insira um rótulo e um nome de API para o elemento Executar agente e salve o fluxo.
Ao configurar a saída estruturada, defina pelo menos um campo de saída estruturada antes de salvar.
Quando uma ação de agente personalizada configurou a saída estruturada, a Saída estruturada atual mostra o tipo de dados estruturado associado.
Para cada campo de saída estruturada definido, são criados dois campos: um com o nome definido e um campo _conjunto booleano relacionado. Por exemplo, se você tiver definido um campo de saída estruturado chamado summary, um campo booleano chamado summary_set também será criado.
| Valor da variável | Descrição |
|---|---|
| Verdadeiro | O campo foi incluído na resposta estruturada do agente, mas não tinha um valor definido. |
| Falso | O campo não foi incluído na resposta estruturada do agente. |
Quando uma saída estruturada definida retorna null, use seu campo _set relacionado mais adiante no fluxo para determinar por que o campo é null.
