Een aangepaste actie maken
U kunt een aangepaste actie maken vanuit de activumbibliotheek of vanuit een agent in Agentforce Builder. Wanneer u een actie maakt vanuit de activumbibliotheek, is deze beschikbaar om toe te voegen aan meerdere agenten en versies. Wanneer u een actie maakt vanuit een agent in Agentforce Builder, is deze alleen beschikbaar voor die agent.
Vereiste editions
| Beschikbaar in: Lightning Experience |
| Beschikbaar in: Enterprise, Performance, Unlimited en Developer Edition. Vereiste uitbreidingslicenties variëren per type agent. |
| Vereiste gebruikersmachtigingen | |
|---|---|
| Een aangepaste agentactie maken: | AI-agenten beheren EN de vereiste machtigingen voor uw agenttype |
| Aanwijzingssjablonen maken of wijzigen: | Aanwijzingssjabloonbeheer |
| Stromen maken of wijzigen: | Stroom beheren |
Een aangepaste actie maken in Agentforce Builder
Wanneer u een aangepaste actie maakt vanuit een agent in Agentforce Builder, is deze alleen beschikbaar voor die agent. Alle wijzigingen die u aanbrengt, zijn alleen van toepassing op deze agentversie. Als u een actie beschikbaar wilt maken om toe te voegen aan andere subagenten, agenten en agentversies, maakt u deze in plaats daarvan in de activumbibliotheek.
Voordat u begint:
- Bekijk de overwegingen bij aangepaste acties.
- Maak de onderliggende Salesforce-functionaliteit die u met uw agent wilt gebruiken. Wanneer u een aangepaste actie maakt, configureert u de functionaliteit voor gebruik met uw agent. U kunt een aangepaste actie maken die aanroepbare methoden en REST Apex klassen, externe services, automatisch gestarte stromen, MuleSoft API's of aanwijzingssjablonen aanroept.
Toegang tot een aangepaste agentactie is afhankelijk van het type Salesforce-functionaliteit waarnaar wordt verwezen. Als een aangepaste actie bijvoorbeeld is samengesteld met behulp van een stroom, houdt de aangepaste actie zich aan de machtigingen, beveiliging op veldniveau en instellingen voor delen die in de stroom zijn geconfigureerd. Voor het uitvoeren van de actie moet de gebruiker of Agentgebruiker minimaal de machtiging Stromen uitvoeren hebben en toegang hebben tot objecten die in de stroom worden gebruikt. Zie Gemeenschappelijke gebruikerstoegang voor standaardagentacties.
Als u wijzigingen wilt aanbrengen aan uw agent, moet deze een conceptstatus hebben. Maak een nieuw concept om wijzigingen aan te brengen in een toegewezen agent.
- Open vanuit de lijst Agenten in de Agentforce Studio-app de agent waaraan u een actie wilt toevoegen.
- Als er meerdere versies van uw agent zijn, selecteert u in de koptekst in Agentforce Builder de agentversie die u wilt bewerken.
-
Open in het deelvenster Verkenner de subagent waaraan u de actie wilt toevoegen, beweeg de muisaanwijzer over Acties en klik op
.
- Selecteer Nieuwe actie maken.
- Geef de actie een naam en klik vervolgens op Maken en Openen. Uw aangepaste actie wordt toegevoegd aan uw subagent en agent.
- Selecteer in de vervolgkeuzelijst Type verwijzingsactie het type functionaliteit dat u wilt gebruiken om uw agentactie samen te stellen, zoals een stroom- of aanwijzingssjabloon. Selecteer vervolgens de categorie, indien gevraagd, en de verwijzingsactie. De beschrijvingen van de aangepaste actie en elke invoer en uitvoer worden ingevuld met de beschrijvingen van de verwijzingsactie.
-
Breng wijzigingen aan in uw actie.
- Controleer de beschrijving van uw actie. Breng indien nodig wijzigingen aan om uw agent te helpen begrijpen wat de actie doet en wanneer en hoe deze te gebruiken.
- Controleer de beschrijving voor elke invoer en uitvoer.
-
Geef voor elke invoer eventuele toepasselijke instellingen op.
Invoerinstelling Details Gegevens van gebruiker verzamelen Vereist dat deze parameter wordt opgegeven door de gebruiker. Invoer vereisen Vereist deze parameter om de actie uit te voeren. Als deze instelling is ingeschakeld en de invoer ontbreekt, kan de actie niet worden uitgevoerd. Alle andere invoer wordt als optioneel behandeld. Als een invoer vereist is door de verwijzingsactie, is deze instelling standaard ingeschakeld en alleen-lezen. -
Geef voor elke uitvoer eventuele toepasselijke instellingen op.
Uitvoerinstelling Details Opnemen in agentcontext Wanneer u een agentactie maakt, worden alle invoer en uitvoer van de verwijzingsactie toegevoegd aan de agentactie. Wanneer deze instelling is ingeschakeld voor een uitvoer, wordt de uitvoer toegevoegd aan de gesprekshistorie van de agent en beschikbaar gemaakt voor redenering. Schakel de instelling uit voor onderliggende uitvoer van verwijzingsacties die u niet met uw agent wilt gebruiken. Minstens één uitvoer moet worden gebruikt met de agentactie. Tonen in gesprek Wanneer deze instelling is ingeschakeld, worden de uitvoer opgenomen in de reactie van de agent. Op sommige kanalen worden bepaalde uitvoer geconverteerd naar gestructureerde inhoud (het deelvenster Agentforce in Lightning Experience herkent bijvoorbeeld recordpagina's).
Wanneer deze instelling is uitgeschakeld voor alle uitvoer, gebruikt de agent de LLM om de uitvoer in natuurlijke taal samen te vatten in de reactie van de agent.
-
Geef eventuele extra instellingen voor uw actie op.
Aanvullende instelling Details Gebruikersbevestiging vereisen Wanneer een actie een wijziging aanbrengt in een record, kunt u van een agent verlangen dat deze de gebruiker vraagt de wijziging te bevestigen voordat de agent deze kan uitvoeren. Laadtekst tonen voor deze actie Toon laadtekst in het gesprek met de agent terwijl de actie op de achtergrond wordt uitgevoerd.
Voor een aangepaste actie kunt u de laadtekst voor de actie opgeven in het veld Tekst laden. Vertel uw gebruikers in 1 tot 3 woorden zonder interpunctie wat uw actie doet. Bijvoorbeeld "Uw e-mail opstellen", "Updates aanbrengen" of "Details van activiteit ophalen".
Wanneer deze instelling is uitgeschakeld of wanneer deze instelling is ingeschakeld, maar er geen laadtekst is opgegeven, wordt standaard laadtekst getoond. Bijvoorbeeld "Werken", "Vooruitgang boeken" of "Mijn notities controleren".
Voor het tonen van tekst voor laden in uitgebreide berichtenverkeerskanaalgesprekken is aanvullende configuratie vereist voor Uitgebreide chat.
- Sla uw wijzigingen op.
Uw actie is alleen beschikbaar in deze agentsubagent en -versie en is niet beschikbaar in de activumbibliotheek. Alle wijzigingen die u aanbrengt in de actie, zijn alleen van toepassing op deze subagent- en agentversie. Wijzigingen hebben geen invloed op andere subagenten of agenten.
Uw actie wordt automatisch toegevoegd aan de redeneringsacties van uw subagent (Acties beschikbaar voor redeneren), zodat de actie beschikbaar is voor uw agent om te selecteren tijdens het redeneren met een LLM. In redeneringsacties kunt u logica toevoegen aan uw agentactie, zoals filters en vervolgacties. Als u de actie deterministisch wilt uitvoeren voordat uw agent begint met redeneren, verwijst u naar de actie in de redeneerinstructies van uw subagent.
Een aangepaste actie maken vanuit de activabibliotheek
Maak een aangepaste actie in de activumbibliotheek om uw actie beschikbaar te maken voor meerdere agenten, versies en subagenten. Voeg deze vervolgens toe aan een of meer agenten.
Voordat u begint:
- Bekijk de overwegingen bij aangepaste acties.
- Maak de onderliggende Salesforce-functionaliteit die u met uw agent wilt gebruiken. Wanneer u een aangepaste actie maakt, configureert u de functionaliteit voor gebruik met uw agent. U kunt een aangepaste actie maken die aanroepbare methoden en REST Apex klassen, externe services, automatisch gestarte stromen, MuleSoft API's of aanwijzingssjablonen aanroept.
Toegang tot een aangepaste agentactie is afhankelijk van het type Salesforce-functionaliteit waarnaar wordt verwezen. Als een aangepaste actie bijvoorbeeld is samengesteld met behulp van een stroom, houdt de aangepaste actie zich aan de machtigingen, beveiliging op veldniveau en instellingen voor delen die in de stroom zijn geconfigureerd. Voor het uitvoeren van de actie moet de gebruiker of Agentgebruiker minimaal de machtiging Stromen uitvoeren hebben en toegang hebben tot objecten die in de stroom worden gebruikt. Zie Gemeenschappelijke gebruikerstoegang voor standaardagentacties.
- Geef vanuit Set-up Agentforce Activa op en selecteer vervolgens Agentforce Activa.
- Klik vanuit het tabblad Acties op Nieuwe agentactie.
-
Selecteer in de vervolgkeuzelijst Type verwijzingsactie het type functionaliteit dat u wilt gebruiken om uw agentactie samen te stellen, zoals een stroom- of aanwijzingssjabloon. Selecteer vervolgens de categorie, indien gevraagd, en de verwijzingsactie.
De beschrijvingen van de aangepaste actie en elke invoer en uitvoer worden ingevuld met de beschrijvingen van de verwijzingsactie.
-
Breng wijzigingen aan in uw actie.
- Controleer de beschrijving van uw actie. Breng indien nodig wijzigingen aan om uw agent te helpen begrijpen wat de actie doet en wanneer en hoe deze te gebruiken.
-
Geef optioneel laadtekst voor uw actie op. Schakel anders de instelling uit.
Instelling Details Laadtekst tonen voor deze actie Toon laadtekst in het gesprek met de agent terwijl de actie op de achtergrond wordt uitgevoerd.
Voor een aangepaste actie kunt u de laadtekst voor de actie opgeven in het veld Tekst laden. Vertel uw gebruikers in 1 tot 3 woorden zonder interpunctie wat uw actie doet. Bijvoorbeeld "Uw e-mail opstellen", "Updates aanbrengen" of "Details van activiteit ophalen".
Wanneer deze instelling is uitgeschakeld of wanneer deze instelling is ingeschakeld, maar er geen laadtekst is opgegeven, wordt standaard laadtekst getoond. Bijvoorbeeld "Werken", "Vooruitgang boeken" of "Mijn notities controleren".
Voor het tonen van tekst voor laden in uitgebreide berichtenverkeerskanaalgesprekken is aanvullende configuratie vereist voor Uitgebreide chat.
- Controleer de beschrijving voor elke invoer en uitvoer.
-
Geef voor elke invoer eventuele toepasselijke instellingen op.
Invoerinstelling Details Gegevens van gebruiker verzamelen Vereist dat deze parameter wordt opgegeven door de gebruiker. Invoer vereisen Vereist deze parameter om de actie uit te voeren. Als deze instelling is ingeschakeld en de invoer ontbreekt, kan de actie niet worden uitgevoerd. Alle andere invoer wordt als optioneel behandeld. Als een invoer vereist is door de verwijzingsactie, is deze instelling standaard ingeschakeld en alleen-lezen. -
Geef voor elke uitvoer eventuele toepasselijke instellingen op.
Uitvoerinstelling Details Opnemen in agentcontext Wanneer u een agentactie maakt, worden alle invoer en uitvoer van de verwijzingsactie toegevoegd aan de agentactie. Wanneer deze instelling is ingeschakeld voor een uitvoer, wordt de uitvoer toegevoegd aan de gesprekshistorie van de agent en beschikbaar gemaakt voor redenering. Schakel de instelling uit voor onderliggende uitvoer van verwijzingsacties die u niet met uw agent wilt gebruiken. Minstens één uitvoer moet worden gebruikt met de agentactie. Tonen in gesprek Wanneer deze instelling is ingeschakeld, worden de uitvoer opgenomen in de reactie van de agent. Op sommige kanalen worden bepaalde uitvoer geconverteerd naar gestructureerde inhoud (het deelvenster Agentforce in Lightning Experience herkent bijvoorbeeld recordpagina's).
Wanneer deze instelling is uitgeschakeld voor alle uitvoer, gebruikt de agent de LLM om de uitvoer in natuurlijke taal samen te vatten in de reactie van de agent.
- Klik op Voltooien.
Uw actie is beschikbaar in de activumbibliotheek. Als u uw actie wilt gebruiken, voegt u deze toe aan een agent. Zie Een actie toevoegen aan een onderwerp vanuit de Activabibliotheek.
Alle wijzigingen die u aanbrengt in de actie in de activumbibliotheek, worden niet gesynchroniseerd met kopieën van de actie die u hebt toegevoegd aan agenten. Voor het toepassen van wijzigingen aan een actie in de activumbibliotheek op een agent moet u de bijgewerkte actie toevoegen aan de agent.
