Kehotteiden rakentajan vianmääritys

Esikatseluni tai testini epäonnistuu virheellä.

Jos napsautat Esikatselu ja näet virheen, kuten Internal Server Error, tarkasta nämä kohteet ennen kuin otat yhteyttä Salesforce-asiakastukeen.

• Varmista, että Kehotteiden rakentaja sisältyy Salesforce-versioon ja lisäosat. Tuetut versiot näytetään tämän sivun ylälaidassa.
• Varmista, että Einstein on käytössä. Kirjoita Määritykset-valikon Pikahaku-kenttään Einstein-määritykset ja valitse Einstein-määritykset. Lisätietoja Kehotteiden rakentajan ottamisesta käyttöön.
• Varmista, että sinulla on Prompt Template Manager- tai Prompt Template User -käyttöoikeusjoukko ja että käyttöoikeusjoukko sisältää Suorita kehotteiden mallit. Lisätietoja Kehotteiden rakentajan ottamisesta käyttöön.
• Jos vahvistit Einsteinin, lisenssit ja käyttöoikeudet ja virhe jatkuu, odota muutaman minuutin ja yritä uudelleen. Ongelma on usein väliaikainen palvelun keskeytys. Tarkasta Salesforce Trust ennen kuin luot tukitapauksen.

Oma kehotemalli toimii esikatselussa, mutta epäonnistuu, kun sitä käytetään agentissa.

Kehotteen malli voi luoda vastauksen Kehotteiden rakentajassa ja epäonnistua, kun sama malli kutsutaan Agentforce Builderista tai suoritetaan agenttikeskustelussa. Agentti voi välittää muita syöttöarvoja kuin mitä valitsit esikatselussa.

• Jos malli käyttää noudettajaa, varmista, että sen tietolähde on aktiivinen ja että se palauttaa tuloksia itse. Lisätietoja yksittäisistä noutojista.
• Jos perustit mallin Agentforce tai jäsentämättömillä tiedostoilla, varmista, että indeksointi on suoritettu. Lisätietoja Agentforce-tietokirjaston vianmäärityksestä.
• Esikatsele mallia uudelleen samoilla input-arvoilla, jotka agentti välittää suorituksen aikana. Lisätietoja luodun vastauksen esikatselusta.

Rakenteellisessa vastauksessani puuttuu kenttiä tai ne ovat tyhjiä, kun Einstein Trust Layer on käytössä.

Kun Einstein Trust Layer on käytössä ja käytät rakenteellisia tuloksia luodaksesi JSON-vastauksen, jotkin kentät saattavat palata tyhjiksi tai null. Einstein Trust Layer peittää henkilökohtaiset tiedot, kuten nimet tai sähköpostiosoitteet, ennen kuin se lähettää kehotteen tekoälymalliin. Jos kenttää ei palauteta vastauksen palauttamisen jälkeen, se saattaa näkyä tyhjänä.

Avaa Vastaus-osiosta Peittämisen lisätiedot ja huomioi, mitkä kentät peitettiin ja sisältävätkö ne henkilötietoja. Peitetty henkilökohtainen tieto on yleisin syy. Lisätietoja rakenteellisista tuloksista. Lisätietoja peittämisen asetuksista on kohdassa Einstein Trust Layer Settings.

Kehotemalli ei käytä suorittavan käyttäjän tietojen käyttöoikeuksia.

Jos malli palauttaa tietoja, joita käyttäjän ei tulisi nähdä, tai jättää pois tietoja, joita hänen tulisi nähdä, lisää Apex- tai kulkutoiminto, joka suodattaa tietueita ennen kuin kyseinen data perustetaan kehotteen malliin. Lisätietoja toiminnon lisäämisestä.

Tiedostoni on liian suuri käytettäväksi maadoituksessa.

Maadoitukseen käytetyt tiedostot voivat olla enintään 15 Mt per pyyntö, ja useimmat mallit tukevat vähintään yhtä tiedostotyyppiä. Jos tiedostosi ylittää rajoituksen, jaa se pienempiin tiedostoihin tai tee yhteenveto sisällöstä ennen kuin lataat sen palvelimelle perustana olevaksi lähteeksi. Ei-tuetut tiedostot jätetään pois pyynnöstä ja näytetään Ratkaisu-paneelissa. Lisätietoja Kehotteiden rakentajan rajoituksista. Lisätietoja maadoituksesta syötetyillä tiedostoilla.

Objekti-kenttä puuttuu.

Näetkö Objekti-kentän riippuen kehotteen mallin tyypistä.

• Valitse kenttien luonnin mallille objekti ja objektikenttä, kun luot mallin, ennen kuin avaat työtilan. Lisätietoja Kentän luonti -kehotteen mallin luomisesta.
• Objektien resurssit ovat valinnaisia Flex-mallille. Lisää ne myöhemmin Resurssit-välilehdestä. Objekti-kenttää ei näytetä alustavassa määritysruudussa. Lue lisää Flex-kehotteiden mallin luomisesta.

Jos odotit näkeväsi Objektin välittömästi, mutta et, tarkasta luomasi mallityyppi.

Saat epäjohdonmukaisia tuloksia samasta kehotteen mallista.

Kehotteiden mallit käyttävät suurta kielimalliä (LLM). AI-mallit eivät aina palauta samaa vastausta samoille syötteille, joten tulokset saattavat vaihdella suorituskertojen mukaan. Mallien, jotka käyttävät hakuohjelmia luokittelutyyppisille tehtäville, ei myöskään voi jäsentää vastausta kelvollisena JSON-tiedostona.

• Esikatsele samoja syötettyjä tietoja useammin kuin kerran nähdäksesi, onko ongelma väliaikainen. Lisätietoja luodun vastauksen esikatselusta.
• Tee ohjeista tarkempia ja käytä tyhjiä tai odottamattomia arvoja tarkasti. Lisätietoja kehotteiden mallin hienosäätämisestä.
• Älä toista samaa yhdistämiskenttää useita kertoja. Toistuvat yhdistämiskentät voivat johtaa epäjohdonmukaisiin tuloksiin. Lisätietoja monimutkaisten kehotteiden organisoinnista.
• Jos virheet ovat yleisiä, esimerkiksi noin yksi kahdesta suorituskerrasta, luo tukitapaus ja lisää esimerkkien syötteet.

Näen virheen, kun ratkaisen datan tarjoajia.

Jos näet virheen, kuten Error occurred while resolving data providers; cannot describe data provider, Resurssit-välilehdessä oleva toiminto puuttuu, on määritetty väärin tai ei ole käytettävissä. Kehotteiden rakentajassa näitä resursseja kutsutaan toiminnoiksi. Ne sisältävät kulun, Apexin ja noutotoiminnot.

• Avaa Resurssit-välilehti ja tarkasta jokainen toiminto. Varmista, että viitattu kulku, Apex tai noutolaite on edelleen olemassa ja että sinulla on sen käyttöoikeus. Lisätietoja toiminnon lisäämisestä.
• Jos nimetit kulun tai luokan äskettäin uudelleen, poistit sen tai kumoit sen aktivoinnin, päivitä tai korvaa kehotemallissa oleva toiminto ja tallenna ja esikatsele sitä uudelleen.

En voi poistaa syötettyä tietoja.

Et voi poistaa input-arvoa, johon toiminto viittaa edelleen. Poista tai päivitä Resurssit-välilehdestä kulku, Apex tai noutotoiminto, joka käyttää input-arvoa. Poista sitten syötetty tieto. Lisätietoja syötteen lisäämisestä.

Resurssini tai kulut puuttuvat, kun tallennan ja aktivoin.

Kun olet tallentanut ja aktivoinut, varmista, että tarkastelet resurssisi sisältävää versiota. Mallin version aktivoiminen tekee siitä muuttumattoman, joten sitä ei voi muokata.

• Päivitä sivu ja käytä Kehotteen mallin työtilan ylälaidassa olevaa version alasvetovalikkoa avataksesi juuri aktivoimasi version. Lisätietoja useiden versioiden käyttämisestä.
• Varmista, että resurssit tallennettiin nyt aktiiviseen versioon. Jos lisäsit kulun tai Apex aktivoinnin jälkeen, tallenna työ uutena versiona ja aktivoi kyseinen versio. Lisätietoja kehotteiden mallien aktivoinnista ja aktivoinnin kumoamisesta.

Kehotteen mallini tallentaminen epäonnistuu.

Tallennuksen aikainen vahvistus epäonnistuu, kun yhdistämiskenttä, toiminto tai vaadittu input ei ole käypä.

• Tarkasta yhdistämiskenttien syntaksi. Käytä esimerkiksi {!$Input:Account.Id}-operaattoria Winter ’24 -syntaksin {!$account.Id}-operaattorin sijaan. Lisätietoja resurssien yhdistämiskenttien syntaksista.
• Varmista, että jokaisella pakollisella input-arvolla on arvo ja että jokainen Resurssit-ominaisuuden toiminto ratkaistaan edelleen. Lisätietoja syötteen lisäämisestä.
• Jos malli käyttää kulkua tai Apex Kehotteiden rakentaja -pilotista, luo resurssit uudelleen tämänhetkiselle syntaksille. Lisätietoja kulkujen muutoksista pilotin jälkeen. Lisätietoja Apex-luokkien muutoksista pilottiprosessin jälkeen.

Vastaukseni peitetään tai merkitään haitalliseksi sisällölle tai se katkaistaan.

Einstein Trust Layer skannaa kehotteiden mallien vastaukset toksisen kielen varalta. Kun toksinen kieli havaitaan, haitallisen sisällön kunniamerkki näytetään Vastaus-osiossa varoitusmäärällä. Muuta kehotemallia ja esikatsele sitä uudelleen, kunnes varoitusten määrä palautuu 0:een. Lisätietoja haitallisen sisällön ilmoituksista.

Jos vastaus katkaistaan, ratkaistu kehote voi ylittää tekoälymallin hyväksymät arvot. Kun kehote on liian suuri, Kehotteiden rakentaja voi luoda yhteenvedon Ratkaisu-paneelista. Käytä yhteenvetokehotetta tai lyhennä mallia. Lisätietoja suurten kehotteiden käyttämisestä.

Vastauksen peitettyjä arvoja odotetaan, kun Einstein Trust Layer korvaa luottamukselliset tiedot paikanpitäjillä ja palauttaa ne. Avaa Vastaus-osiosta Peittämisen lisätiedot tarkastaaksesi kartoituksen. Lisätietoja datan Trust-ominaisuudesta ja peittämisestä.

Minun täytyy dokumentoida kehotteeni ja korjata niiden virheet.

Kehotteiden rakentaja ei tue upotettuja kommentteja mallin tekstiosassa. Käytä versioita verrataksesi muutoksia ja pidä lyhyt tietue kussakin versiossa tekemistäsi muutoksista.

• Napsauta Tallenna nimellä | Tallenna uutena versiona ennen merkittävää muokkausta, jotta voit vertailla vastauksia vierekkäin. Lisätietoja useiden versioiden käyttämisestä.
• Esikatsele samaa testitietuetta joka kerta ja huomioi muutamasi ohje tai resurssi.
• Jos käytät monimutkaista logiikkaa, testaa ohjeen tekstiä itse esikatselussa, lisää sitten resursseja ja esikatsele uudelleen. Lisätietoja monimutkaisten kehotteiden organisoinnista.