Solução de problemas Criador de prompts

Minha visualização ou teste falha com um erro.

Se você clicar em Visualizar e aparecer um erro, como Internal Server Error, verifique estes itens antes de entrar em contato com o Suporte ao cliente da Salesforce.

• Confirme se o Criador de prompts está incluído na edição e nos complementos do Salesforce. As edições com suporte aparecem na parte superior dessa página.
• Confirme se o Einstein está ativado. Em Configuração, insira Configuração do Einstein na caixa Busca rápida e selecione Configuração do Einstein. Saiba mais sobre a ativação do Criador de prompts.
• Confirme se você recebeu o conjunto de permissões Gerenciador de modelo de prompt ou Usuário de modelo de prompt e se o conjunto de permissões inclui Executar modelos de prompt. Saiba mais sobre a ativação do Criador de prompts.
• Se você tiver verificado o Einstein, as licenças e as permissões e o erro continuar, espere alguns minutos e tente novamente. O problema geralmente é uma interrupção temporária do serviço. Verifique o Salesforce Trust antes de criar um caso de suporte.

Meu modelo de prompt funciona na Visualização, mas falha quando usado em um agente.

Um modelo de prompt pode gerar uma resposta no Criador de prompts e ainda falhar quando o mesmo modelo é chamado do Agentforce Builder ou é executado em uma conversa do agente. O agente pode passar valores de entrada diferentes daqueles selecionados na visualização.

• Se o modelo usar um recuperador, confirme se a fonte de dados do recuperador está ativa e se o recuperador retorna resultados sozinho. Saiba mais sobre os retrievers individuais.
• Se você basear o modelo com uma Biblioteca de dados do Agentforce ou arquivos não estruturados, confirme se a indexação está concluída. Saiba mais sobre a solução de problemas da Biblioteca de dados do Agentforce.
• Visualize o modelo novamente com os mesmos valores de entrada que o agente passa no tempo de execução. Saiba mais sobre a visualização de uma resposta gerada.

Minha resposta estruturada tem campos ausentes ou em branco quando a Camada do Trust do Einstein está ativada.

Quando a Camada de confiança do Einstein está ativada e você usa Saídas estruturadas para gerar uma resposta JSON, alguns campos podem voltar vazios ou null. A Camada do Einstein Trust mascara informações pessoais, como nomes ou endereços de email, antes de enviar o aviso ao modelo de IA. Se um campo não for restaurado após a resposta retornar, ele poderá aparecer em branco.

Na seção Resposta, abra Detalhes de mascaramento e observe quais campos foram mascarados e se contêm informações de identificação pessoal. Informações pessoais mascaradas são a causa mais comum. Saiba mais sobre saídas estruturadas. Para revisar as configurações de mascaramento, consulte Configurações de camada Einstein Trust.

Meu modelo de prompt não usa o acesso a dados do usuário em execução.

Se um modelo retornar dados que um usuário não deveria ver ou omitir dados que ele deveria ver, adicione uma ação do Apex ou fluxo que filtre registros antes que esses dados sejam fundamentados no modelo de prompt. Saiba mais sobre como adicionar uma ação.

Meu arquivo é muito grande para ser usado para fundamentação.

Os arquivos usados para a fundamentação são limitados a 15 MB por solicitação, e a maioria dos modelos oferece suporte a pelo menos um tipo de arquivo. Se seu arquivo exceder o limite, divida-o em arquivos menores ou resuma o conteúdo antes de carregá-lo como uma fonte de fundamentação. Arquivos sem suporte são excluídos da solicitação e listados no painel Resolução. Saiba mais sobre os limites do Criador de prompts. Saiba mais sobre a fundamentação com entradas de arquivo.

O campo Objeto está ausente.

Se você vê o campo Objeto depende do tipo de modelo de prompt.

• Para um modelo de Geração de campo, selecione um Objeto e um Campo de objeto ao criar o modelo antes de abrir o espaço de trabalho. Saiba mais sobre como criar um modelo de prompt de Geração de campo.
• Para um modelo Flex, os recursos de objeto são opcionais. Adicione-os mais tarde na guia Recursos. O campo Objeto não aparece na tela de configuração inicial. Saiba mais sobre como criar um modelo de prompt do Flex.

Se você esperava ver o Objeto imediatamente e não está, confirme o tipo de modelo que está criando.

Eu recebo resultados inconsistentes do mesmo modelo de prompt.

Os modelos de prompt usam um grande modelo de idioma (LLM). Os modelos de IA nem sempre retornam a mesma resposta para as mesmas entradas, portanto, os resultados podem variar entre as execuções. Modelos que usam recuperadores para tarefas de estilo de classificação também podem falhar ao analisar uma resposta como JSON válido.

• Visualize as mesmas entradas mais de uma vez para ver se o problema é intermitente. Saiba mais sobre a visualização de uma resposta gerada.
• Faça instruções específicas e adicione tratamento explícito para valores vazios ou inesperados. Saiba mais sobre como refinar um modelo de prompt.
• Não repita o mesmo campo de mesclagem várias vezes. Campos de mesclagem repetidos podem levar a resultados inconsistentes. Saiba mais sobre como organizar avisos complexos.
• Se as falhas forem frequentes, por exemplo, cerca de uma em cada duas execuções, crie um caso de suporte e inclua entradas de exemplo.

Recebo um erro ao resolver provedores de dados.

Se você visualizar um erro como Error occurred while resolving data providers; cannot describe data provider, uma ação na guia Recursos estará ausente, configurada incorretamente ou indisponível. No Criador de prompts, esses recursos são chamados de ações. Eles incluem ações de fluxo, Apex e retriever.

• Abra a guia Recursos e revise cada ação. Confirme se o fluxo, a classe do Apex ou o recuperador referenciados ainda existem e se você tem acesso a eles. Saiba mais sobre como adicionar uma ação.
• Se você renomeou, excluiu ou desativou um fluxo ou classe recentemente, atualize ou substitua a ação no modelo de prompt e salve e visualize novamente.

Não consigo excluir uma entrada.

Não é possível excluir uma entrada que ainda seja referenciada por uma ação. Na guia Recursos, remova ou atualize a ação de fluxo, Apex ou retriever que usa a entrada. Em seguida, exclua a entrada. Saiba mais sobre como adicionar uma entrada.

Meus recursos ou fluxos estão ausentes depois de salvar e ativar.

Depois de salvar e ativar, confirme que você está visualizando a versão que contém seus recursos. A ativação de uma versão do modelo torna essa versão imutável, portanto, ela não pode ser editada.

• Atualize a página e use a lista suspensa de versões na parte superior do Espaço de trabalho do modelo de prompt para abrir a versão que acabou de ativar. Saiba mais sobre como usar várias versões.
• Confirme se os recursos foram salvos na versão que agora está ativa. Se você tiver adicionado um fluxo ou ação do Apex após a ativação, salve o trabalho como uma nova versão e ative essa versão. Saiba mais sobre como ativar e desativar modelos de prompt.

Não é possível salvar meu modelo de prompt.

A validação de economia de tempo falha quando um campo de mesclagem, ação ou entrada obrigatória não é válido.

• Verifique a sintaxe do campo de mesclagem. Por exemplo, use {!$Input:Account.Id} em vez da sintaxe Winter '24 {!$account.Id}. Saiba mais sobre a sintaxe do campo de mesclagem de recursos.
• Confirme que cada entrada necessária tem um valor e que cada ação em Recursos ainda é resolvida. Saiba mais sobre como adicionar uma entrada.
• Se o modelo usar um fluxo ou classe do Apex do piloto Criador de prompts, recrie esses recursos para a sintaxe atual. Saiba mais sobre as alterações de fluxo após o piloto. Saiba mais sobre as alterações de classe do Apex após o piloto.

Minha resposta é mascarada, sinalizada para conteúdo prejudicial ou cortada.

A Camada do Einstein Trust verifica as respostas do modelo de prompts quanto a linguagem tóxica. Quando a linguagem tóxica é detectada, o emblema de conteúdo prejudicial aparece na seção Resposta com uma contagem de aviso. Revise o modelo de prompt e visualize novamente até que a contagem de avisos retorne a 0. Saiba mais sobre notificações de conteúdo prejudicial.

Se a resposta for interrompida, o aviso resolvido poderá exceder o que o modelo de IA aceita. Quando um aviso é muito grande, o Criador de prompts pode gerar um resumo no painel Resolução. Use o aviso resumido ou reduza o modelo. Aprenda mais sobre como trabalhar com avisos grandes.

Os valores mascarados na resposta são esperados quando a Camada de Trust do Einstein substitui dados confidenciais por espaços reservados e os restaura. Abra Detalhes do mascaramento na seção Resposta para inspecionar o mapeamento. Saiba mais sobre data Trust e mascaramento.

Preciso documentar e depurar meus modelos de prompt.

O Criador de prompts não oferece suporte a comentários em linha no corpo do modelo. Use versões para comparar alterações e mantenha um registro curto do que você alterou em cada versão.

• Clique em Salvar como | Salvar como uma nova versão antes de uma edição significativa para poder comparar respostas lado a lado. Saiba mais sobre como usar várias versões.
• Visualize com o mesmo registro de teste sempre e observe qual instrução ou recurso você alterou.
• Para lógica complexa, teste o texto da instrução em Visualização sozinho, adicione recursos e visualize novamente. Saiba mais sobre como organizar avisos complexos.