Problemen opsporen in Aanwijzingensamensteller

Mijn voorbeeld of test mislukt met een fout.

Als u op Voorbeeld klikt en er een fout wordt weergegeven, zoals Internal Server Error, controleert u deze items voordat u contact opneemt met Klantenondersteuning van Salesforce.

• Controleer of Aanwijzingensamensteller is inbegrepen bij uw Salesforce edition en uitbreidingen. Ondersteunde editions worden boven aan deze pagina weergegeven.
• Bevestig dat Einstein is ingeschakeld. Geef vanuit Set-up, in het vak Snel zoeken, Einstein Set-up op en selecteer vervolgens Einstein Set-up. Meer informatie over het inschakelen van Aanwijzingensamensteller.
• Controleer of de machtigingenset Sjabloonbeheer voor aanwijzing of Gebruiker van aanwijzingssjabloon aan u is toegewezen en of de machtigingenset Sjablonen voor aanwijzing uitvoeren omvat. Meer informatie over het inschakelen van Aanwijzingensamensteller.
• Als u Einstein, licenties en machtigingen hebt geverifieerd en de fout blijft optreden, wacht u enkele minuten en probeert u het opnieuw. Het probleem is vaak een tijdelijke serviceonderbreking. Controleer Salesforce Trust voordat u een ondersteuningscase maakt.

Mijn aanwijzingssjabloon werkt in Voorbeeld, maar mislukt bij gebruik in een agent.

Een aanwijzingssjabloon kan een respons genereren in Aanwijzingensamensteller en toch mislukken wanneer dezelfde sjabloon wordt aangeroepen vanuit Agentforce Builder of wordt uitgevoerd in een agentgesprek. De agent kan andere invoerwaarden doorgeven dan die welke u hebt geselecteerd in Voorbeeld.

• Als de sjabloon een retriever gebruikt, controleert u of de gegevensbron van de retriever actief is en of de retriever zelf resultaten retourneert. Meer informatie over individuele retrievers.
• Als u de sjabloon baseert op een Agentforce gegevensbibliotheek of ongestructureerde bestanden, controleert u of de indexering is voltooid. Meer informatie over het oplossen van problemen met Agentforce Data Library.
• Bekijk opnieuw een voorbeeld van de sjabloon met dezelfde invoerwaarden die de agent doorgeeft tijdens run-time. Meer informatie over een voorbeeld van een gegenereerde respons.

Mijn gestructureerde reactie heeft ontbrekende of lege velden wanneer Einstein Trust Layer is ingeschakeld.

Wanneer Einstein Trust Layer is ingeschakeld en u Gestructureerde uitvoer gebruikt om een JSON-respons te genereren, kunnen sommige velden leeg of null terugkomen. De Einstein Trust Layer maskeert persoonlijke informatie, zoals namen of e-mailadressen, voordat de aanwijzing naar het AI-model wordt verzonden. Als een veld niet wordt hersteld nadat de respons is geretourneerd, kan het leeg worden weergegeven.

Open in de sectie Reactie Details van maskeren en noteer welke velden zijn gemaskerd en of ze persoonsgegevens bevatten. Gemaskerde persoonsgegevens zijn de meest voorkomende oorzaak. Meer informatie over gestructureerde uitvoer. Zie Einstein Trust Layer Settings (Instellingen voor maskeren) als u instellingen wilt controleren.

Mijn aanwijzingssjabloon gebruikt niet de gegevenstoegang van de huidige gebruiker.

Als een sjabloon gegevens retourneert die een gebruiker niet zou moeten zien, of gegevens weglaat die hij wel zou moeten zien, voegt u een Apex of stroomactie toe die records filtert voordat die gegevens worden gefundeerd in de aanwijzingssjabloon. Meer informatie over het toevoegen van een actie.

Mijn bestand is te groot om te gebruiken voor aarding.

Bestanden die voor aarding worden gebruikt, zijn beperkt tot 15 MB per verzoek en de meeste modellen ondersteunen minstens één bestandstype. Als uw bestand de limiet overschrijdt, splitst u het op in kleinere bestanden of vat u de inhoud samen voordat u het uploadt als een bron voor aarding. Niet-ondersteunde bestanden worden uitgesloten van de aanvraag en vermeld in het deelvenster Resolutie. Meer informatie over limieten van Aanwijzingensamensteller. Meer informatie over aarding met bestandsinvoer.

Het veld Object ontbreekt.

Of u het veld Object ziet, is afhankelijk van het type aanwijzingssjabloon.

• Selecteer voor een veldgeneratiesjabloon een object en een objectveld wanneer u de sjabloon maakt, voordat u de werkruimte opent. Meer informatie over het maken van een aanwijzingssjabloon voor Veldgeneratie.
• Voor een Flex-sjabloon zijn objectresources optioneel. Voeg ze later toe vanaf het tabblad Resources. Het veld Object wordt niet weergegeven in het scherm voor de eerste set-up. Meer informatie over het maken van een Flex-aanwijzingssjabloon.

Als u verwachtte dat u Object onmiddellijk zou zien, maar dat niet doet, bevestigt u welk sjabloontype u maakt.

Ik krijg inconsistente resultaten van dezelfde aanwijzingssjabloon.

Aanwijzingssjablonen gebruiken een groot taalmodel (LLM). AI-modellen retourneren niet altijd dezelfde respons voor dezelfde invoer, waardoor de resultaten per uitvoering kunnen verschillen. Sjablonen die retrievers gebruiken voor taken in classificatiestijl, kunnen er ook niet in slagen om een respons als geldige JSON te parseren.

• Bekijk dezelfde invoer meer dan eens om te zien of het probleem intermitterend is. Meer informatie over een voorbeeld van een gegenereerde respons.
• Maak instructies specifiek en voeg expliciete afhandeling toe voor lege of onverwachte waarden. Meer informatie over het verfijnen van een aanwijzingssjabloon.
• Herhaal hetzelfde samenvoegveld niet meerdere malen. Herhaalde samenvoegvelden kunnen leiden tot inconsistente resultaten. Meer informatie over het ordenen van complexe aanwijzingen.
• Als er vaak fouten optreden, bijvoorbeeld bij één op de twee uitvoeringen, maakt u een ondersteuningscase en neemt u voorbeeldinvoer op.

Ik krijg een foutmelding tijdens het oplossen van gegevensleveranciers.

Als u een fout zoals Error occurred while resolving data providers; cannot describe data provider ziet, ontbreekt een actie op het tabblad Resources, is deze niet goed geconfigureerd of is deze niet beschikbaar. In Aanwijzingensamensteller worden deze resources acties genoemd. Ze omvatten stroom-, Apex en retriever-acties.

• Open het tabblad Resources en controleer elke actie. Controleer of de stroom, Apex klasse of retriever waarnaar wordt verwezen nog steeds bestaat en of u er toegang toe hebt. Meer informatie over het toevoegen van een actie.
• Als u een stroom of klasse onlangs hebt hernoemd, verwijderd of gedeactiveerd, werkt u de actie in de aanwijzingssjabloon bij of vervangt u deze en slaat u deze op en bekijkt u het voorbeeld opnieuw.

Ik kan een invoer niet verwijderen.

U kunt geen invoer verwijderen waarnaar nog steeds wordt verwezen door een actie. Verwijder op het tabblad Resources de stroom, Apex of retriever-actie die de invoer gebruikt, of werk deze bij. Verwijder vervolgens de invoer. Meer informatie over het toevoegen van een invoer.

Mijn resources of stromen ontbreken nadat ik heb opgeslagen en geactiveerd.

Nadat u hebt opgeslagen en geactiveerd, bevestigt u dat u de versie weergeeft die uw resources bevat. Het activeren van een sjabloonversie maakt die versie onveranderbaar, waardoor deze niet kan worden bewerkt.

• Vernieuw de pagina en gebruik vervolgens de vervolgkeuzelijst met versies boven aan de werkruimte Sjabloon voor aanwijzing om de versie te openen die u zojuist hebt geactiveerd. Meer informatie over het gebruik van meerdere versies.
• Bevestig dat de resources zijn opgeslagen in de versie die nu actief is. Als u een stroom of Apex actie hebt toegevoegd na activering, slaat u het werk op als een nieuwe versie en activeert u die versie. Meer informatie over het activeren en deactiveren van aanwijzingssjablonen.

Mijn aanwijzingssjabloon kan niet worden opgeslagen.

Validatie van bespaartijd mislukt wanneer een samenvoegveld, actie of verplichte invoer niet geldig is.

• Syntaxis van samenvoegvelden controleren. Gebruik bijvoorbeeld {!$Input:Account.Id} in plaats van de syntaxis {!$account.Id} Winter '24. Meer informatie over syntaxis van resourcesamenvoegvelden.
• Controleer of elke vereiste invoer een waarde heeft en of elke actie in Resources nog steeds wordt opgelost. Meer informatie over het toevoegen van een invoer.
• Als de sjabloon een stroom of Apex klasse uit de Aanwijzingensamensteller proef gebruikt, maakt u die resources opnieuw voor de huidige syntaxis. Lees meer over stroomwijzigingen na de proef. Meer informatie over Apex klasse wijzigingen na de pilot.

Mijn reactie wordt gemaskeerd, gesignaleerd voor schadelijke inhoud of afgebroken.

De Einstein Trust Layer scant prompte sjabloonreacties op giftige taal. Wanneer giftige taal wordt gedetecteerd, wordt de badge voor schadelijke inhoud weergegeven in de sectie Reactie met een waarschuwingstelling. Wijzig de aanwijzingssjabloon en bekijk opnieuw een voorbeeld totdat het aantal waarschuwingen weer 0 is. Meer informatie over kennisgevingen van schadelijke inhoud.

Als de respons wordt afgebroken, kan de opgeloste aanwijzing overschrijden wat het AI-model accepteert. Wanneer een aanwijzing te groot is, kan Aanwijzingensamensteller een samenvatting genereren in het deelvenster Oplossing. Gebruik de samengevatte aanwijzing of verkort de sjabloon. Meer informatie over het werken met grote aanwijzingen.

Gemaskeerde waarden in de respons worden verwacht wanneer de Einstein Trust Layer gevoelige gegevens vervangt door plaatshouders en deze vervolgens herstelt. Open Details van maskeren in de sectie Reactie om de toewijzing te inspecteren. Meer informatie over Data Trust en maskeren.

Ik moet mijn aanwijzingssjablonen documenteren en fouten opsporen.

Aanwijzingensamensteller ondersteunt geen inline opmerkingen in de hoofdtekst van de sjabloon. Gebruik versies om wijzigingen te vergelijken en houd kort bij wat u in elke versie hebt gewijzigd.

• Klik op Opslaan als | Opslaan als een nieuwe versie vóór een belangrijke bewerking zodat u responsen naast elkaar kunt vergelijken. Meer informatie over het gebruik van meerdere versies.
• Bekijk een voorbeeld met telkens dezelfde testrecord en noteer welke instructie of resource u hebt gewijzigd.
• Voor complexe logica test u de instructietekst in Voorbeeld op zichzelf, voegt u vervolgens resources toe en bekijkt u het voorbeeld opnieuw. Meer informatie over het ordenen van complexe aanwijzingen.