Felsök Promptbyggaren

Min förhandsvisning eller test misslyckas med ett fel.

Om du klickar på Förhandsgranska och ett fel visas, till exempel Internal Server Error, kontrollera dessa objekt innan du kontaktar Salesforces kundsupport.

• Bekräfta att Promptbyggaren ingår i din Salesforce-version och tillägg. Versioner som stöds visas högst upp på denna sida.
• Bekräfta att Einstein är påslaget. I Inställningar, i rutan Snabbsökning, skriv Einstein Inställningar och välj sedan Einstein Inställningar. Läs mer om att aktivera Promptbyggaren.
• Bekräfta att du är tilldelad behörighetsuppsättningen Uppmaningmallhanterare eller Uppmaningmallanvändare och att behörighetsuppsättningen innehåller Kör uppmaningsmallar. Läs mer om att aktivera Promptbyggaren.
• Om du har verifierat Einstein, licenser och behörigheter och felet fortsätter, vänta några minuter och försök igen. Problemet är ofta ett tillfälligt serviceavbrott. Kontrollera Salesforce Trust innan du skapar ett supportkundcase.

Min uppmaningsmall fungerar i Förhandsvisning men misslyckas vid användning i en agent.

En uppmaningsmall kan skapa ett svar i Promptbyggaren och fortfarande misslyckas när samma mall anropas från Agentforce Builder eller körs i en agentkonversation. Agenten kan skicka andra indatavärden än de du valde i Förhandsvisning.

• Om mallen använder en retriever, bekräfta att retrieverns datakälla är aktiv och att retrievern returnerar resultat på egen hand. Läs mer om individuella retrievers.
• Om du jordar mallen med ett Agentforce Data Library eller ostrukturerade filer, bekräfta att indexeringen är klar. Läs mer om felsökning av Agentforces databibliotek.
• Förhandsgranska mallen igen med samma indatavärden som agenten skickar vid körning. Läs mer om att förhandsgranska ett genererat svar.

Mitt strukturerade svar saknar eller har tomma fält när Einstein Trust Layer är på.

När Einstein Trust Layer är på och du använder Strukturerade utdata för att skapa ett JSON-svar kan vissa fält vara tomma eller null. Einstein Trust Layer maskerar personlig information, som namn eller e-postadresser, innan den skickar uppmaningen till AI-modellen. Om ett fält inte återställs efter att svaret returnerats kan det verka tomt.

I sektionen Svar, öppna Maskeringsdetaljer och notera vilka fält som var maskerade och om de innehåller personligt identifierande information. Maskerad personlig information är den vanligaste orsaken. Läs mer om strukturerade utdata. För att se maskeringsinställningar, se Einstein Trust Layer-inställningar.

Min uppmaningsmall använder inte den aktuella användarens dataåtkomst.

Om en mall returnerar data som en användare inte bör se, eller utelämnar data som de bör se, lägg till en Apex eller flödesåtgärd som filtrerar poster innan dessa data jordas i uppmaningsmallen. Läs mer om att lägga till en åtgärd.

Min fil är för stor för att användas för jordning.

Filer som används för jordning är begränsade till 15 MB per begäran och de flesta modeller har stöd för minst en filtyp. Om din fil överskrider gränsen, dela upp den i mindre filer eller sammanfatta innehållet innan du laddar upp den som en jordningskälla. Filer som inte stöds utesluts från begäran och listas i panelen Lösning. Läs mer om gränser i Promptbyggaren. Läs mer om jordning med filinmatningar.

Fältet Objekt saknas.

Om du ser fältet Objekt beror på typen av uppmaningsmall.

• För en mall för fältskapande, välj ett objekt och ett objektfält när du skapar mallen, innan du öppnar arbetsområdet. Läs mer om att skapa en uppmaningsmall för fältskapande.
• För en Flex-mall är objektresurser valfria. Lägg till dem senare från fliken Resurser. Fältet Objekt visas inte på den inledande konfigurationsskärmen. Läs mer om att skapa en mall för Flex-uppmaning.

Om du förväntade dig att se Objekt direkt och du inte gör det, bekräfta vilken malltyp du skapar.

Jag får inkonsekventa resultat från samma uppmaningsmall.

Uppmaningsmallar använder en stor språkmodell (LLM). AI-modeller returnerar inte alltid samma svar för samma indata, så resultaten kan variera mellan körningarna. Mallar som använder retrievers för klassificeringsuppgifter kan inte heller tolka ett svar som giltigt JSON.

• Förhandsgranska samma inmatningar mer än en gång för att se om problemet är intermittent. Läs mer om att förhandsgranska ett genererat svar.
• Gör instruktionerna specifika och lägg till uttrycklig hantering för tomma eller oväntade värden. Läs mer om att förfina en uppmaningsmall.
• Upprepa inte samma kopplingsfält flera gånger. Upprepade kopplingsfält kan leda till inkonsekventa resultat. Läs mer om att organisera komplexa uppmaningar.
• Om fel inträffar ofta, till exempel ungefär varannan körning, skapa ett supportkundcase och inkludera exempel på inmatningar.

Jag får ett felmeddelande när jag löser dataleverantörer.

Om du ser ett fel, till exempel Error occurred while resolving data providers; cannot describe data provider, saknas en åtgärd på fliken Resurser, är felkonfigurerad eller otillgänglig. I Promptbyggaren kallas dessa resurser åtgärder. De inkluderar åtgärder för flöde, Apex och hämtning.

• Öppna fliken Resurser och gå igenom varje åtgärd. Bekräfta att det refererade flödet, Apex klassen eller retrievern fortfarande finns och att du har åtkomst till det. Läs mer om att lägga till en åtgärd.
• Om du nyligen döpte om, tog bort eller inaktiverade ett flöde eller en klass, uppdatera eller ersätt åtgärden i uppmaningsmallen och spara och förhandsgranska igen.

Jag kan inte ta bort en inmatning.

Det går inte att ta bort en inmatning som fortfarande refereras av en åtgärd. På fliken Resurser, ta bort eller uppdatera den flödes-, Apex- eller retrieveråtgärd som använder indata. Ta sedan bort inmatningen. Läs mer om att lägga till en indata.

Mina resurser eller flöden saknas efter att jag har sparat och aktiverat.

När du har sparat och aktiverat, bekräfta att du visar den version som innehåller dina resurser. Att aktivera en mallversion gör den versionen oföränderlig, så den kan inte redigeras.

• Uppdatera sidan och använd sedan versionsmenyn högst upp i arbetsområdet Uppmaningmall för att öppna den version du just aktiverade. Läs mer om att använda flera versioner.
• Bekräfta att resurserna sparades i den version som nu är aktiv. Om du lade till ett flöde eller en Apex åtgärd efter aktiveringen, spara arbetet som en ny version och aktivera den versionen. Läs mer om att aktivera och inaktivera uppmaningsmallar.

Min uppmaningsmall kan inte sparas.

Validering av sparad tid misslyckas om ett kopplingsfält, en åtgärd eller en inmatning som krävs inte är giltig.

• Kontrollera kopplingsfältsyntax. Använd till exempel {!$Input:Account.Id} istället för Winter ’24 syntax {!$account.Id}. Läs mer om resurskopplingsfälts syntax.
• Bekräfta att varje obligatorisk inmatning har ett värde och att varje åtgärd i Resurser fortfarande löses. Läs mer om att lägga till en indata.
• Om mallen använder ett flöde eller Apex klass från piloten i Promptbyggaren, återskapa dessa resurser för den aktuella syntaxen. Läs mer om flödesändringar efter piloten. Läs mer om ändringar av Apex-klasser efter piloten.

Mitt svar är maskerat, flaggat för skadligt innehåll eller avskuret.

Einstein Trust Layer söker igenom uppmaningar till mallsvar för giftigt språk. När giftigt språk upptäcks visas märket för skadligt innehåll i sektionen Svar med en varning. Revidera uppmaningsmallen och förhandsgranska igen tills antalet varningar återgår till 0. Läs mer om notiser om skadligt innehåll.

Om svaret bryts kan den lösta uppmaningen överskrida vad AI-modellen accepterar. Om en uppmaning är för stor kan Promptbyggaren skapa en sammanfattning i panelen Lösning. Använd den sammanfattade uppmaningen eller förkorta mallen. Läs mer om att arbeta med stora uppmaningar.

Maskerade värden i svaret förväntas när Einstein Trust Layer ersätter känsliga data med platshållare och sedan återställer dem. Öppna Maskeringsdetaljer i sektionen Svar för att inspektera mappningen. Läs mer om Data Trust och maskering.

Jag behöver dokumentera och felsöka mina uppmaningsmallar.

Promptbyggaren har inte stöd för infogade kommentarer i mallens brödtext. Använd versioner för att jämföra ändringar och föra ett kort register över vad du har ändrat i varje version.

• Klicka på Spara som | Spara som en ny version innan en betydande redigering så att du kan jämföra svar bredvid varandra. Läs mer om att använda flera versioner.
• Förhandsgranska med samma testpost varje gång och notera vilken instruktion eller resurs du har ändrat.
• För komplex logik, testa instruktionstexten i Förhandsgranska på egen hand och lägg sedan till resurser och förhandsgranska igen. Läs mer om att organisera komplexa uppmaningar.