Element Agent maken
Gebruik een Agentforce agent om taken dynamisch in uw stroom af te handelen. Selecteer een bestaande agent of maak een agent met aangepaste instructies en acties.
Vereiste editions
Machtigingen
Als u bestaande agenten in uw stromen wilt gebruiken, hebt u de gebruikersmachtiging Set-up weergeven nodig. Als u agenten wilt maken vanuit Flow Builder, hebt u de gebruikersmachtiging Toepassing aanpassen, Einstein Copilot Builder, Einstein Agent Platform Builder of Selfservice Copilot Builder nodig. Gebruikers met het profiel Systeembeheerder kunnen agenten maken en gebruiken.
Als u geen machtigingen hebt om agenten te maken, wordt de knop Agent maken niet weergegeven in het selectiedeelvenster voor agenten. U kunt alleen bestaande agenten selecteren.
Gebruik
Voeg een element Agent maken toe aan uw stroom. Zoek en selecteer in het veld Agent een actieve agent of klik op Agent maken om een nieuwe agent samen te stellen.
Een bestaande agent selecteren
Als u een bestaande agent wilt gebruiken, zoekt u de agent op naam in het veld Agent. Alleen actieve agenten worden weergegeven in de lijst. Nadat u een agent hebt geselecteerd, configureert u de invoer en uitvoer van de agent in het deelvenster Eigenschappen.
Een nieuwe agent maken
Klik voor het maken van een agent op Agent maken. Configureer in het venster Nieuwe agent de basisgegevens van de agent.
| Veld | Beschrijving |
|---|---|
| Label | De naam van de agent. |
| API-naam | De vereiste voor uniciteit geldt alleen voor elementen binnen de huidige stroom. Twee elementen kunnen dezelfde API-naam hebben, mits ze in verschillende stromen worden gebruikt.Een API-naam kan onderstrepingstekens en alfanumerieke lettertekens zonder spaties bevatten. Deze moet met een letter beginnen en mag niet op een onderstrepingsteken eindigen. Ook kan deze niet twee opeenvolgende onderstrepingstekens bevatten. |
| Beschrijving | Een beschrijving van wat de agent doet. |
| Gebruikerstoegang | De gebruikersrecord als welke de agent wordt uitgevoerd. Selecteer een bestaande gebruiker of laat het systeem een gebruiker maken. |
| Instructies | Instructies die beschrijven wat de agent doet en de redenering ervan sturen. |
| Acties | De acties die de agent kan gebruiken. Selecteer bestaande acties uit de activumbibliotheek of maak aangepaste acties. |
Acties toevoegen aan de agent
De agent vereist minstens één actie om taken uit te voeren. Voeg acties toe voordat u op Maken en activeren klikt of in Agentforce Builder nadat u de agent hebt geactiveerd.
Klik voor het selecteren van bestaande acties op Acties selecteren. Zoek en selecteer een of meer acties in de activumbibliotheek en klik vervolgens op Toevoegen aan agent. Beschikbare acties omvatten Knowledge acties, stromen geconfigureerd als aanroepbare acties en standaardacties.
Klik voor het maken van een actie op Actie maken. Configureer de actie in het venster Actie maken.
| Veld | Beschrijving |
|---|---|
| Toollabel Agent | De naam van de actie. |
| API-naam | De vereiste voor uniciteit geldt alleen voor elementen binnen de huidige stroom. Twee elementen kunnen dezelfde API-naam hebben, mits ze in verschillende stromen worden gebruikt.Een API-naam kan onderstrepingstekens en alfanumerieke lettertekens zonder spaties bevatten. Deze moet met een letter beginnen en mag niet op een onderstrepingsteken eindigen. Ook kan deze niet twee opeenvolgende onderstrepingstekens bevatten. |
| Beschrijving | De naam van de actie. De agent gebruikt deze informatie om te bepalen hoe en wanneer deze actie moet worden gebruikt. |
| Type verwijzingsactie | Het type actie, zoals Flow of Apex. |
| Referentieactiecategorie | Het subtype van het verwijzingsactietype. Niet alle acties hebben een verwijzingsactiecategorie. |
| Verwijzingsactie | De naam van de actie waarnaar moet worden verwezen. |
Voeg voor elke invoer een beschrijving toe van wat de invoer doet. De agent gebruikt de beschrijving om te bepalen hoe de invoer moet worden gebruikt bij het aanroepen van de actie. Selecteer Invoer vereisen voor uitvoeringsactie om de invoer verplicht te maken.
Voeg voor elke uitvoer een beschrijving toe over de uitvoerretourneringen en de manier waarop het resultaat in de stroom moet worden gebruikt. Selecteer Filteren uit agentcontext om de uitvoer uit te sluiten van de redenering van de agent. Selecteer Toon in gesprek om deze uitvoer op te nemen in de reactie van de agent.
Klik op Maken en activeren om uw agent te maken en activeren.
Het element configureren
Nadat u een agent hebt geselecteerd of gemaakt, configureert u het element Agent maken in het deelvenster Eigenschappen.
| Veld | Beschrijving |
|---|---|
| Label | Het label voor de actie op het doek en in Toolboxbeheer. |
| API-naam | De vereiste voor uniciteit geldt alleen voor elementen binnen de huidige stroom. Twee elementen kunnen dezelfde API-naam hebben, mits ze in verschillende stromen worden gebruikt.Een API-naam kan onderstrepingstekens en alfanumerieke lettertekens zonder spaties bevatten. Deze moet met een letter beginnen en mag niet op een onderstrepingsteken eindigen. Ook kan deze niet twee opeenvolgende onderstrepingstekens bevatten. |
| Beschrijving | De beschrijving van het element. |
Invoerwaarden instellen
Configureer de invoer van het element Agent maken in het deelvenster Eigenschappen.
| Veld | Beschrijving |
|---|---|
| Agentverzoek | Een vraag of verzoek om naar de agent te verzenden voor deze stroomuitvoering. De agent past zijn instructies toe op dit specifieke verzoek om uitvoer te genereren. |
| Sessie-ID | Optioneel. Gebruik de sessie-ID die wordt geretourneerd door een element Agent maken dat eerder in de stroom wordt uitgevoerd. De agent behoudt zijn volledige redeneringscontext en geheugen uit dat gesprek. Als u geen sessie-ID opgeeft, start de agent een nieuw gesprek, maar u kunt altijd uitvoer van vorige elementen Agent maken opgeven als invoer. |
Gestructureerde uitvoer configureren
Als u de agent wilt configureren voor het retourneren van gestructureerde gegevens die uw stroom kan gebruiken, definieert u gestructureerde uitvoervelden. Elk veld vertegenwoordigt een stukje informatie dat de agent extraheert of genereert.
Als u gestructureerde uitvoer configureert, retourneert de agent alleen gestructureerde gegevens in het veld Reactie van gestructureerde agent. Het veld Reactie van agent retourneert null. Als u geen gestructureerde uitvoer configureert, retourneert de agent alleen ongestructureerde tekst in het veld Reactie van agent.
Klik voor het configureren van gestructureerde uitvoer op Configureren. Configureer de velden voor elk gestructureerd uitvoerveld:
| veld | Beschrijving |
|---|---|
| Veldnaam | Verplicht. De unieke alfanumerieke naam voor het gestructureerde uitvoerveld. De naam mag geen speciale tekens of spaties bevatten. |
| Beschrijving | Een korte beschrijving die bij de veldnaam wordt gebruikt om de nauwkeurigheid van het grote taalmodel (LLM) te vergroten. |
| Gegevenstype | Verplicht. Het gegevenstype van het veld. Geldige waarden: Tekenreeks, Getal, Booleaans. |
| Verplicht | Geeft aan dat de LLM een respons moet genereren voor dit uitvoerveld. Het vereisen van uitvoerrijen kan leiden tot onnauwkeurige of schadelijke reacties door de LLM. |
Uitvoerwaarden opslaan
| Veld | Beschrijving |
|---|---|
| Respons van agent | De ongestructureerde reactie van de agent. Retourneert null als gestructureerde uitvoer is geconfigureerd. |
| Sessie-ID | De ID van de gesprekssessie waarin de reactie van de agent zich bevindt. |
| Respons gestructureerde agent | De gestructureerde uitvoer van de agent. Retourneert null als er geen gestructureerde uitvoer is geconfigureerd. |
Gestructureerd uitvoergebruik
Voordat u gestructureerde uitvoer configureert, geeft u een label en API-naam op voor het element Agent maken en slaat u de stroom vervolgens op.
Wanneer u gestructureerde uitvoer configureert, definieert u minstens 1 gestructureerd uitvoerveld voordat u opslaat.
Voor elk gedefinieerd gestructureerd uitvoerveld worden twee velden gemaakt: een met de gedefinieerde naam en een gerelateerd Booleaans _set-veld. Als u bijvoorbeeld een gestructureerd uitvoerveld met de naam summary hebt gedefinieerd, wordt er ook een booleaans veld met de naam summary_set gemaakt.
| Veld | Beschrijving |
|---|---|
| True (Waar) | Het veld was wel opgenomen in de respons van de gestructureerde agent, maar had geen ingestelde waarde. |
| False (Onwaar) | Het veld is niet opgenomen in de respons van de gestructureerde agent. |
Wanneer een gedefinieerde gestructureerde uitvoer null retourneert, gebruikt u het gerelateerde veld _set verderop in de stroom om te bepalen waarom het veld null is.
Gebruiksnotities
- Test uw stroom voordat u deze activeert om er zeker van te zijn dat het element Agent maken werkt zoals verwacht.
- U kunt agenten die zijn gemaakt in Flow Builder, op elk gewenst moment vinden en bewerken in Agentforce Builder.
- Vanaf API-versie 67.0 zijn AI Agent-acties niet meer beschikbaar vanuit het element Actie. Gebruik het element Agent maken om met agenten te werken. Wanneer u een stroom opent met een element Actie dat verwijst naar een AI Agent-actie, wordt deze automatisch weergegeven als een element Agent maken. Uw oorspronkelijke configuratie blijft behouden.
