Feilsøke Ledetekstbygger
Løs vanlige problemer med ledetekstmaler.
Nødvendige utgaver
| Tilgjengelig i Lightning Experience |
| Tilgjengelig i Enterprise, Performance og Ubegrenset Edition med Einstein for Platform, eller Einstein eller Agentforce for Sales eller Service-tillegget eller Agentforce Agent Foundation |
Min forhåndsvisning eller test mislykkes med en feil.
Hvis du klikker på Forhåndsvis og det vises en feil, for eksempel Internal Server Error, kontrollerer du disse elementene før du kontakter Salesforces kundestøtte.
- Kontroller at Ledetekstbygger er inkludert i Salesforce-utgaven og tilleggene. Versjoner som støttes, vises øverst på denne siden.
- Kontroller at Einstein er slått på. Skriv inn Einstein-oppsett i Hurtigsøk-feltet i Oppsett, og velg deretter Einstein-oppsett. Lær mer om aktivering av Ledetekstbygger.
- Kontroller at du er tildelt tillatelsessettet Promptmalbehandling eller tillatelsessettet Promptmalbruker, og at tillatelsessettet inkluderer Utfør ledetekstmaler. Lær mer om aktivering av Ledetekstbygger.
- Hvis du har bekreftet Einstein, lisenser og tillatelser og feilen fortsetter, venter du noen minutter og prøver på nytt. Problemet er ofte et midlertidig tjenesteavbrudd. Sjekk Salesforce Trust før du oppretter en kundestøttesak.
Ledetekstmalen min fungerer i Forhåndsvisning, men mislykkes når den brukes i en agent.
En ledetekstmal kan generere et svar i Ledetekstbygger og mislykkes likevel når den samme malen kalles opp fra Agentforce Builder eller kjører i en agentdiskusjon. Agenten kan overføre andre inndataverdier enn de du valgte i Forhåndsvisning.
- Hvis malen bruker en retriever, kontrollerer du at retrieverens datakilde er aktiv og at retrieveren returnerer resultater alene. Lær mer om individuelle retriever.
- Hvis du lander malen med et Agentforce eller ustrukturerte filer, kontrollerer du at indekseringen er fullført. Lær mer om feilsøking av Agentforce Data Library.
- Forhåndsvis malen på nytt med de samme inndataverdiene som agenten overfører ved kjøretid. Lær mer om forhåndsvisning av et generert svar.
Mitt strukturerte svar har manglende eller tomme felt når Einstein Trust er på.
Når Einstein Trust-laget er aktivert og du bruker strukturerte utdata til å generere et JSON-svar, kan enkelte felt bli tomme eller null. Einstein Trust Layer maskerer personlig informasjon, som navn eller e-postadresser, før den sender meldingen til AI-modellen. Hvis et felt ikke gjenopprettes etter at svaret har blitt returnert, kan det være tomt.
I Svar-delen åpner du Maskeringsdetaljer og noterer deg hvilke felt som ble maskerte, og om de inneholder personlig identifiserbar informasjon. Maskerte personopplysninger er den vanligste årsaken. Lær mer om strukturerte utdata. Se Einstein Trust Layer Settings for å se gjennom maskeringsinnstillinger.
Min ledetekstmal bruker ikke den kjørende brukerens datatilgang.
Hvis en mal returnerer data som en bruker ikke skal se, eller utelater data som brukeren skal se, legger du til en Apex eller flythandling som filtrerer poster før disse dataene legges til grunn i ledetekstmalen. Lær mer om å legge til en handling.
Filen min er for stor til å brukes til jording.
Filer som brukes til jording, er begrenset til 15 MB per forespørsel, og de fleste modellene støtter minst én filtype. Hvis filen overskrider grensen, deler du den opp i mindre filer eller oppsummerer innholdet før du laster den opp som en jordingskilde. Filer som ikke støttes, ekskluderes fra forespørselen og vises i Løsning-panelet. Lær mer om Grenser for Ledetekstbygger. Lær mer om jording med filinndata.
Objekt-feltet mangler.
Om du ser Objekt-feltet avhenger av typen ledetekstmal.
- For en Feltgenerering-mal velger du et objekt og et objektfelt når du oppretter malen, før du åpner arbeidsområdet. Lær mer om hvordan du oppretter en feltgenereringsmeldingsmal.
- For en Flex-mal er objektressurser valgfrie. Legg dem til senere fra fanen Ressurser. Objekt-feltet vises ikke på den første oppsettskjermen. Lær mer om hvordan du oppretter en Flex-meldingemal.
Hvis du forventer å se Objekt umiddelbart og ikke gjør det, kontrollerer du hvilken maltype du oppretter.
Jeg får inkonsekvente resultater fra samme ledetekstmal.
Ledetekstmaler bruker en stor språkmodell (LLM). AI-modeller returnerer ikke alltid det samme svaret for de samme inndataene, så resultatet kan variere på tvers av kjøringer. Maler som bruker henter til klassifiseringsstiloppgaver, kan også mislykkes i å analysere et svar som gyldig JSON.
- Forhåndsvis de samme inndataene flere ganger for å se om problemet er midlertidig. Lær mer om forhåndsvisning av et generert svar.
- Gjør instruksjoner spesifikke, og legg til eksplisitt håndtering av tomme eller uventede verdier. Lær mer om forbedring av en ledetekstmal.
- Ikke gjenta det samme flettefeltet flere ganger. Gjentagende flettefelt kan føre til inkonsekvente resultater. Lær mer om organisering av komplekse ledetekster.
- Hvis feil er hyppige, for eksempel ca. én av to kjøringer, oppretter du en kundestøttesak og inkluderer eksempelinndata.
Jeg får en feil når jeg løser dataleverandører.
Hvis du får en feil som Error occurred while resolving data providers; cannot
describe data provider, mangler en handling i Ressurser-fanen, er den feilkonfigurert eller ikke tilgjengelig. I Ledetekstbygger kalles disse ressursene handlinger. De inkluderer flythandlinger, Apex og retrieverhandlinger.
- Åpne fanen Ressurser, og se gjennom hver handling. Kontroller at flyten, Apex eller henteren det refereres til, fremdeles finnes, og at du har tilgang til den. Lær mer om å legge til en handling.
- Hvis du nylig har gitt nytt navn til, slettet eller deaktivert en flyt eller klasse, oppdaterer eller erstatter du handlingen i ledetekstmalen og lagrer og forhåndsviser på nytt.
Jeg kan ikke slette inndata.
Du kan ikke slette inndata som det fremdeles refereres til av en handling. I fanen Ressurser fjerner eller oppdaterer du flythandlingen, Apex eller henterhandlingen som bruker inndataene. Slett deretter inndataene. Lær mer om å legge til inndata.
Mine ressurser eller flyter mangler etter at jeg har lagret og aktivert.
Når du har lagret og aktivert, kontrollerer du at du viser versjonen som inneholder ressursene. Aktivering av en malversjon gjør denne versjonen uforanderlig, så den kan ikke redigeres.
- Oppdater siden, og bruk deretter rullegardinlisten for versjoner øverst i arbeidsområdet for ledetekstmaler til å åpne versjonen du nettopp aktiverte. Lær mer om bruk av flere versjoner.
- Kontroller at ressursene ble lagret i versjonen som nå er aktiv. Hvis du har lagt til en flyt eller Apex etter aktivering, lagrer du arbeidet som en ny versjon og aktiverer den versjonen. Lær mer om aktivering og deaktivering av ledetekstmaler.
Min ledetekstmal kan ikke lagres.
Tidslagringsvalidering mislykkes når et flettefelt, en handling eller nødvendige inndata ikke er gyldige.
- Kontroller flettefeltsyntaks. Bruk for eksempel
{!$Input:Account.Id}i stedet for Winter ’24-syntaksens{!$account.Id}. Lær mer om ressursflettefeltsyntaks. - Kontroller at alle nødvendige inndata har en verdi og at hver handling i Ressurser fremdeles løses. Lær mer om å legge til inndata.
- Hvis malen bruker en flyt eller Apex fra Ledetekstbygger, oppretter du disse ressursene på nytt for den gjeldende syntaksen. Lær mer om flytendringer etter pilotprosessen. Lær mer om Apex-klassers endringer etter pilotprosessen.
Svaret mitt maskeres, flagges for skadelig innhold eller kuttes av.
Einstein Trust skanner meldingsmalsvar etter giftig språk. Når giftig språk oppdages, vises det skadelige innholdsmerket i Svar-delen med et antall advarsler. Revider ledetekstmalen og forhåndsvis på nytt til advarselsantallet går tilbake til 0. Lær mer om varsler om skadelig innhold.
Hvis svaret er avkuttet, kan den løste ledeteksten overskride det AI-modellen godtar. Når en ledetekst er for stor, kan Ledetekstbygger generere et sammendrag i Løsning-panelet. Bruk den oppsummerte ledeteksten, eller forkorte malen. Lær mer om hvordan du arbeider med store ledetekster.
Maskerte verdier i svaret forventes når Einstein Trust erstatter sensitive data med plassholdere og deretter gjenoppretter dem. Åpne Maskeringsdetaljer i Svar-delen for å inspisere tilordningen. Lær mer om Data Trust og maskering.
Jeg må dokumentere og feilsøke ledetekstmalene.
Ledetekstbygger støtter ikke innebygde kommentarer i malteksten. Bruk versjoner til å sammenligne endringer, og hold en kort oversikt over hva du har endret i hver versjon.
- Klikk på Lagre som | Lagre som en ny versjon før en betydelig redigering slik at du kan sammenligne svar side ved side. Lær mer om bruk av flere versjoner.
- Forhåndsvis med den samme testposten hver gang, og noter deg hvilken instruksjon eller ressurs du har endret.
- For kompleks logikk tester du instruksjonsteksten i Forhåndsvisning alene, og deretter legger du til ressurser og forhåndsviser på nytt. Lær mer om organisering av komplekse ledetekster.
