Você está aqui:
Plataforma Agentforce | Registros de consulta
Localiza e recupera registros do Salesforce com base na solicitação do usuário e em condições específicas, como os valores dos campos.
Edições obrigatórias
| Disponível em: Lightning Experience |
| Disponível em: Edições Enterprise, Performance, Unlimited e Developer com Fundações, ou Edições Agentforce 1 ou Einstein 1 |
| Permissões do usuário necessárias | |
|---|---|
| Consulte Acesso de usuário comum para ações padrão do agente. | |
Detalhes da ação
| Nome da API | QueryRecords |
| Tipo de ação de referência | Acção padrão |
| Essa ação executa um ou mais modelos de prompt? | Não |
Considerações
Para considerações gerais sobre o Agentforce, consulte Agentforce Considerações
- Essa ação tem suporte apenas para o idioma inglês.
- Essa ação funciona com todos os objetos padrão pesquisáveis e consultáveis compatíveis com a API da interface de usuário e com todos os objetos personalizados pesquisáveis. Não há suporte para objetos externos.
- Não há suporte para consultas com dados de vários objetos. Por exemplo, um usuário não pode visualizar seus leads e oportunidades com uma solicitação.
- Essa ação pode filtrar os resultados da pesquisa consultando até um relacionamento entre pai e filho ou entre pai e filho. Por exemplo, um usuário pode perguntar: "Qual é a quantidade média de oportunidades fechadas que têm uma conta baseada nos Estados Unidos?"
- Consultas que recuperam dados com base em um campo de pesquisa, uma lista relacionada ou uma lista de opções nem sempre funcionam.
- O número máximo de resultados exibidos é de 50, mesmo que sejam encontrados mais de 50 resultados correspondentes.
- A normalização de campo não está disponível, portanto, a recuperação de registros com base nos valores de campo depende do formato. Por exemplo, a solicitação do usuário "Obter meu contato com o número de telefone 415-123-4567" retornará resultados apenas se o número de telefone for inserido no mesmo formato exato.
- Consultas com critérios de filtro ou classificação ambíguos são determinadas pelo LLM. Nenhuma regra de negócio específica é usada. Por exemplo, se um usuário solicitar sua oportunidade "principal", o LLM poderá interpretar "principal" como a oportunidade com o valor mais alto ou a data de fechamento mais próxima. Se você tiver dúvidas sobre os critérios usados para recuperar os resultados da pesquisa, visualize o plano no Agentforce Builder.
- Há suporte para sinônimos para objetos e campos padrão comuns. Por exemplo, se a solicitação de um usuário incluir a palavra "negócio", a ação poderá determinar que o usuário está fazendo referência a uma oportunidade. Não há suporte para personalização de sinônimos. Sinônimos para objetos ou campos personalizados nem sempre são interpretados com precisão.
- Há suporte para um conjunto limitado de campos padrão para os objetos Conta, Contato, Caso, Oportunidade e Lead. Outros campos têm suporte apenas se estiverem incluídos no layout pesquisável padrão do objeto consultado e no layout de página de registro padrão. Se o objeto tiver um grande número de campos, a ação poderá limitar o número de campos incluídos na pesquisa.
- Quando os resultados são retornados, os campos exibidos vêm de duas origens: até três campos da consulta e até 10 campos do layout de pesquisa do objeto. Esses conjuntos são mesclados e qualquer campo que aparecer em ambos é contado apenas uma vez. Como resultado, o número de campos exibidos varia e nem sempre é um total fixo de 10. Se a consulta tiver menos de três campos, somente esses campos consultados serão incluídos da consulta. Se a consulta tiver mais de três campos, apenas três serão incluídos.
- Menos de três campos de consulta: Por exemplo, se um usuário pedir para ver suas oportunidades classificadas por classificação, a consulta contribuirá com dois campos (Nome da oportunidade e Classificação) e o layout de pesquisa contribuirá com cinco campos (Nome da oportunidade, Estágio, Data de fechamento, Proprietário e Nome da conta). Como o Nome da oportunidade aparece em ambas as origens, ele é contado apenas uma vez, portanto, o usuário vê seis campos.
- Mais de três campos de consulta: Por exemplo, se um usuário pedir para ver suas contas com o nome, o setor, a receita anual e o telefone, a consulta terá quatro campos, portanto, apenas os três primeiros serão mantidos: Nome da conta, Setor e Receita anual. O telefone é removido da consulta, embora ainda possa aparecer se fizer parte do layout de pesquisa de conta.
- Os resultados são retornados apenas quando os critérios de pesquisa completos são atendidos. Não há suporte para resultados parciais. Se um usuário solicitar informações com base em dois campos, mas tiver acesso apenas a um desses campos, a consulta retornará um erro em vez de retornar resultados com base apenas em um dos campos.
- Pesquisas de campo implícitas não têm suporte total. Para recuperar registros com uma correspondência de campo específica, mencione o campo e o valor precisos na consulta. Por exemplo, para resultados mais precisos, um usuário pode inserir "Lista minhas contas que têm um Setor de tecnologia" em vez de "Lista minhas contas de tecnologia".
Este artigo resolveu seu problema?
Diga-nos para podermos melhorar!
