Agent Studio: Custom Values en variabelen gebruiken

Custom Values en ingebouwde variabelebronnen maken je workflows in Agent Studio dynamisch, herbruikbaar en schaalbaar. In plaats van handmatig bedrijfsgegevens of contactinformatie in elke stap te typen, kun je slimme placeholders invoegen die automatisch de juiste data ophalen wanneer je agent draait.

Deze handleiding legt uit hoe je accountgegevens, contactgegevens, realtime datum en tijd, formulierinzendingen en Custom Values gebruikt in je agents, zonder duplicatie of handmatige updates.

Wat zijn Custom Values en variabelen?

Met Custom Values en variabelen kun je echte informatie automatisch in je agent laten invullen. Een variabele is een placeholder tussen dubbele accolades, zoals {{contact.first_name}}. Tijdens het uitvoeren van de agent wordt die placeholder vervangen door de daadwerkelijke waarde.

Voorbeeld:

Hi {{contact.first_name}}

Als de contactnaam John is, wordt het bericht: Hi John.

Je kunt variabelen gebruiken op elke plek waar je tekst invoert in Agent Studio, zoals:

  • Prompts voor AI Agents
  • Text Generation nodes
  • Tool inputs
  • Message cards
  • Velden voor conditional logic

Je kunt een variabele invoegen via de dropdown in het tekstveld, of handmatig typen met {{ }}.

Agent Studio heeft vijf ingebouwde categorieën variabelen:

  • Account
  • Custom Values
  • Right Now
  • Form Data
  • Contact

Elke categorie haalt informatie op uit een andere bron binnen je systeem.

Belangrijke voordelen van variabelen in Agent Studio

Variabelen helpen je om dynamische en herbruikbare agents te bouwen.

  • Een keer bouwen, overal gebruiken: Eén agent-template kan automatisch werken in meerdere accounts.
  • Geen handmatige updates: Als bijvoorbeeld een telefoonnummer of adres wijzigt, wordt dit direct overal bijgewerkt.
  • Automatische personalisatie: Haal contactnamen en CRM-data in gesprekken op zonder extra werk.
  • Realtime context: Voeg automatisch de datum van vandaag of de huidige tijd toe.
  • Veilige uitvoering: Als een variabele geen waarde heeft, blijft de output leeg in plaats van dat je agent vastloopt.

Custom Values

Custom Values zijn herbruikbare key-value paren die je instelt via:

Settings → Custom Values (Instellingen → Custom Values)

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

Voorbeeld:

Key: support_email

Value: support@yourcompany.com

In je agent: Voor hulp, e-mail {{custom_values.support_email}}

Als je de value later wijzigt, wordt dit automatisch bijgewerkt op alle plekken waar je deze variabele gebruikt.

Account-variabelen

Account-variabelen halen bedrijfsinformatie op uit je accountinstellingen.

Gebruik deze wanneer je agent moet verwijzen naar:

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

Voorbeeld: Welkom bij {{account.name}}. Bel ons via {{account.primary_phone}}.

Deze waarden worden direct uit je accountinstellingen gehaald.

Right Now-variabelen

Right Now-variabelen voegen live datum- en tijdinformatie toe.

Voorbeelden:

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

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

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

Form Data-variabelen

Form Data-variabelen zijn beschikbaar wanneer je agent wordt gestart via een Form Submitted event.

Elk formulierveld wordt beschikbaar als variabele.

Voorbeeld: Als je formulier een veld heeft met de naam “service_type”, kun je gebruiken: Je koos {{form.service_type}}

Belangrijk: Form-variabelen worden alleen gevuld wanneer de agent is gestart door een formulierinzending.

Contact-variabelen

Contact-variabelen halen informatie rechtstreeks op uit het CRM-record. Je kunt zowel standaardvelden als custom fields gebruiken voor uitgebreide personalisatie.

Voorbeelden:

  • {{contact.first_name}}
  • {{contact.last_name}}
  • {{contact.email}}
  • Custom contactvelden

Als het contactrecord wordt bijgewerkt, gebruikt de agent bij de volgende run de nieuwste gegevens.

Contact-variabelen vs runtime-variabelen

  • Contact-variabelen halen opgeslagen CRM-data op.
  • Runtime-variabelen bewaren tijdelijke informatie die tijdens het huidige gesprek wordt verzameld.
  • Als de informatie al in het contactrecord staat voordat het gesprek start, gebruik je Contact-variabelen.
  • Als de waarde tijdens het gesprek wordt verzameld, gebruik je runtime-variabelen.

Custom Values en variabelen instellen

Volg deze stappen om variabelen te gaan gebruiken.

Stap 1: Custom Values aanmaken

  1. Ga naar Settings → Custom Values (Instellingen → Custom Values)
  2. Klik Add Custom Value (Custom Value toevoegen)
  3. Vul een Key en Value in
  4. Klik Save (Opslaan)

Stap 2: Agent Studio openen

  1. Ga naar AI Agents → Agent Studio
  2. Open een bestaande agent of maak een nieuwe aan

Stap 3: Een variabele invoegen

  1. Klik in een prompt- of message-veld
  2. Klik op de dropdown in het veld
  3. Kies een categorie:
    • Account
    • Custom Values
    • Right Now
    • Form Data
    • Contact
  4. Klik op een variabele om deze in te voegen
Let op: Sommige nodes, zoals API Call-stappen, genereren runtime-variabelen op basis van hun output. Je kunt deze variabelen later opnieuw gebruiken door ze te selecteren in de variable picker.

Stap 4: Opslaan en testen

  1. Klik Save (Opslaan)
  2. Klik Test
  3. Start een testgesprek
  4. Controleer of variabelen correct worden ingevuld

Als een waarde leeg blijft, controleer dan of de bijbehorende data bestaat in het CRM of in de accountinstellingen.

Stap 5: Publiceren

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

Veelgestelde vragen

V: Wat gebeurt er als een Custom Value wordt verwijderd?

Antwoord: De variabele geeft een lege waarde terug, zonder dat dit een fout veroorzaakt.

V: Kan ik Opportunity- of Task-velden gebruiken?

Antwoord: De bronnen die op dit moment worden ondersteund zijn Account, Custom Values, Right Now, Form Data en Contact.

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

Antwoord: Als een variabele ontbreekt of leeg is, wordt een lege waarde teruggegeven. Dit veroorzaakt geen fout en stopt de agent niet. Dit zorgt voor een veilige en betrouwbare uitvoering.

V: Houden Right Now-variabelen rekening met de tijdzone?

Antwoord: Ja. Deze variabelen gebruiken de tijdzone van het account.

V: Kunnen Form Data-variabelen overal worden gebruikt?

Antwoord: Ze worden alleen gevuld wanneer de agent is gestart door een Form Submitted event.

V: Zijn variabele placeholders hoofdlettergevoelig?

Antwoord: Ja. Gebruik exact de key-namen zoals je ze ziet in de variable picker.

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