Agent Studio: Custom Values en variabelen gebruiken

Gebruik Aangepaste Waarden en ingebouwde variabelenbronnen om je Agent Studio werkprocessen dynamisch, herbruikbaar en schaalbaar te maken. In plaats van handmatig bedrijfsgegevens of contactinformatie in elke node te typen, kun je slimme placeholders invoegen die automatisch echte data ophalen wanneer je agent draait.

Deze handleiding legt uit hoe je Accountgegevens, Contactgegevens, realtime datum en tijd, formulierinvoeren en Aangepaste Waarden binnen je agents kunt gebruiken zonder duplicatie of handmatige updates.

INHOUDSOPGAVE

Wat zijn Aangepaste Waarden en Variabelen?

Aangepaste Waarden en Variabelen stellen je in staat om automatische echte informatie in je agent in te voegen. Een variabele is een placeholder die binnen dubbele accolades is geschreven, zoals {{contact.firstname}}, die wordt vervangen door echte data wanneer de agent draait.

Bijvoorbeeld:

Hallo {{contact.firstname}}

Als de naam van de contactpersoon John is, wordt het bericht: Hallo John.

Je kunt variabelen overal gebruiken waar je tekst typt binnen Agent Studio, inclusief AI Agent prompts, Tekstgeneratie nodes, toolinvoeren, berichtenkaartjes en voorwaardelijke logica velden. Klik gewoon op de dropdownpijl in het tekstveld om een variabele in te voegen of typ deze handmatig met {{ }}.

Agent Studio bevat vijf ingebouwde variabelencategorieën:

  • Account
  • Aangepaste Waarden
  • Nu
  • Formulieregegevens
  • Contact

Elke categorie haalt informatie uit een ander deel van je systeem.

Belangrijke Voordelen van het Gebruik van Variabelen in Agent Studio

Het gebruik van variabelen helpt je bij het bouwen van dynamische en herbruikbare agents.

  • Een keer bouwen, overal gebruiken:  Eén agent template kan automatisch over meerdere accounts werken.
  • Geen handmatige updates:  Als een telefoonnummer of adres verandert, wordt het overal direct bijgewerkt.
  • Automatische personalisatie:  Trek contactnamen en CRM-gegevens in gesprekken zonder extra werk.
  • Realtime bewustzijn:  Voeg automatisch de datum van vandaag of de huidige tijd in.
  • Veilige uitvoering:  Als een variabele geen waarde heeft, wordt er blanc geretourneerd in plaats van dat je agent faalt.

Aangepaste Waarden

Aangepaste Waarden zijn herbruikbare sleutel-waarde paren die je definieert in:

Instellingen → Aangepaste Waarden

Je maakt ze één keer aan en gebruikt ze overal.

Voorbeeld:

Sleutel: suppportemail

Waarde: support@yourcompany.com

Dan binnen je agent: Voor hulp, e-mail {{customvalues.supportemail}}

Als je de waarde later bijwerkt, wordt deze automatisch overal waar de variabele wordt gebruikt bijgewerkt.

Bijwerken van Aangepaste Waarden vanuit de AI Agent Actie

Werkprocessen die de AI Agent actie gebruiken, kunnen Aangepaste Waarden rechtstreeks bijwerken met de Update Aangepaste Waarde tool. Dit stelt de agent in staat contextgebaseerde waarden tijdens de uitvoering te schrijven in plaats van enkel op vaste werkstroomtakken te vertrouwen.

Voor de volledige stappen voor het instellen, raadpleeg de links onderaan het artikel.

Accountvariabelen

Accountvariabelen halen bedrijfsinformatie uit je Accountinstellingen.

Gebruik deze wanneer je agent moet verwijzen naar:

  • Bedrijfsnaam
  • Telefoonnummer
  • Adres
  • Website
  • Logo-URL

Voorbeeld: Welkom bij {{account.name}}. Bel ons op {{account.primaryphone}}.

Deze waarden worden rechtstreeks uit je Accountinstellingen gehaald.

Nu-variabelen

Nu-variabelen voegen live datum- en tijdinformatie in.

Voorbeelden zijn:

  • Volledige datum van vandaag
  • Huidige tijd
  • Dag van de week
  • Maand of jaar

Voorbeeld: Vandaag is {{rightnow.date}}.

Het systeem voegt automatisch de juiste datum in op basis van de tijdzone van het account.

Formulieregevensvariabelen

Formulieregevensvariabelen zijn beschikbaar wanneer je agent wordt geactiveerd door een Formulier Ingediend gebeurtenis.

Elk formulier veld wordt beschikbaar als een variabele.

Voorbeeld: Als je formulier een veld heeft genaamd “servicetype”, kun je gebruiken: Je selecteerde {{form.servicetype}}

Belangrijk: Formuliervariabelen vullen alleen in wanneer de agent wordt geactiveerd door een formulierinvoer.

Contactvariabelen

Contactvariabelen halen informatie rechtstreeks uit het CRM-record. Ze staan zowel standaard- als aangepaste velden voor diepe personalisatie toe.

Voorbeelden:

  • {{contact.firstname}}
  • {{contact.lastname}}
  • {{contact.email}}
  • Aangepaste contactvelden

Als het contactrecord wordt bijgewerkt, gebruikt de agent de volgende keer dat deze draait de bijgewerkte informatie.

Contact vs Runtime-variabelen

  • Contactvariabelen halen opgeslagen CRM-gegevens op.
  • Runtime-variabelen slaan tijdelijke informatie op die tijdens het huidige gesprek is verzameld.
  • Als de informatie al in het contactrecord staat voordat het gesprek begint, gebruik dan Contactvariabelen.
  • Als de waarde tijdens het gesprek wordt verzameld, gebruik dan Runtime-variabelen.

Hoe Aangepaste Waarden en Variabelen in te stellen

Volg deze stappen om te beginnen met het gebruiken van variabelen.

Step 1: Create Custom Values

  1. Ga naar Instellingen → Aangepaste Waarden en selecteer Voeg Aangepaste Waarde Toe
  2. Voer een Naam en Waarde in en klik op Aanmaken

Step 2: Open Agent Studio

Ga naar AI Agents → Agent Studio en open een bestaande agent of maak een nieuwe aan

Step 3: Insert a Variable

  1. Klik binnen een prompt of berichtveld

  2. Klik op de dropdownpijl in het veld OF typ {{ handmatig

    Kies een categorie:

    • Account
    • Aangepaste Waarden
    • Nu
    • Formulieregevens
    • Contact
  3. Klik op een variabele om deze in te voegen

Opmerking: Sommige nodes, zoals API-aanroepstappen, genereren runtime-variabelen op basis van hun output. Deze variabelen kunnen later opnieuw worden gebruikt door ze in de variabelekiezer te selecteren.

Step 4: Save and Test

  1. Klik op Opslaan
  2. Klik op Test
  3. Voer een voorbeeldgesprek uit
  4. Bevestig dat de variabelen correct worden opgelost

Als een waarde blanco verschijnt, controleer dan of de bijbehorende gegevens bestaan in de CRM- of Accountinstellingen.

Step 5: Publish

Als alles correct werkt, promoot je de agent naar Productie.

Veelgestelde Vraag

Q: Wat gebeurt er als een Aangepaste Waarde wordt verwijderd?

Het retourneert een lege waarde in plaats van een fout te veroorzaken.

Q: Kan ik verwijzen naar Opportunity- of Taakvelden?

Momenteel ondersteunde bronnen zijn Account, Aangepaste Waarden, Nu, Formulieregevens en Contact.

Q: Wat gebeurt er als een variabele geen waarde heeft?

Als een variabele ontbreekt of leeg is, retourneert het systeem een blanco waarde. Dit veroorzaakt geen fout of stopt de agent met draaien. Dit zorgt voor een veilige en betrouwbare uitvoering.

Q: Houdt Nu-variabelen rekening met tijdzone?

Ja. Ze gebruiken de tijdzone van het account.

Q: Kunnen Formulieregevensvariabelen overal worden gebruikt?

Ze vullen alleen in wanneer ze worden geactiveerd door een Formulier Ingediend gebeurtenis.

Q: Zijn variabele placeholders hoofdlettergevoelig?

Ja. Gebruik de exacte sleutel- namen die in de variabelekiezer worden weergegeven.

Heeft dit je vraag beantwoord? Bedankt voor de feedback! Er was een probleem bij het versturen van je feedback. Probeer later nog eens.

Gerelateerde artikelen