AI agent prompting

Elke agent in Eloquent wordt aangedreven door prompts. Prompts vertellen de agent hoe te reageren, welke stijl te gebruiken en welke taken uit te voeren. Het schrijven van effectieve prompts is essentieel om consistente, bruikbare resultaten te krijgen.

De prompteditor

Eloquent biedt een WYSIWYG-editor voor prompts. Je kunt je prompt opmaken met:

• Kopjes → Verdeel taken in secties (bijv. Rol, Doel, Taak).
• Vet / cursief → Benadruk wat cruciaal is (bijv. Nooit persoonlijke gegevens delen).
• Opsommingstekens / lijsten → Maak regels ondubbelzinnig en scanbaar.
• Scheidingstekens (---) → Scheid instructies duidelijk van voorbeelden of context.

Bij het schrijven van prompts zijn structuur en nadruk alles. Een muur van platte tekst kan zowel voor jou als voor de AI lastig te interpreteren zijn. Door opmaak te gebruiken, laat je de belangrijkste onderdelen eruit springen. Dit heeft twee grote voordelen:

• Voor jou → Een gestructureerde, leesbare prompt maakt het makkelijker om helder na te denken over wat je wilt. Je ziet hiaten, tegenstrijdigheden of ontbrekende instructies meteen.
• Voor de AI → Opgemaakte tekst helpt het model focussen. Kopjes, vet en opsommingstekens creëren duidelijke prioriteiten, verminderen verwarring en verhogen de consistentie van antwoorden.

Voorbeeld zonder opmaak:

Je bent een supportmedewerker voor Acme Inc. Help gebruikers met productproblemen. Wees duidelijk, behulpzaam en als je niet kunt antwoorden, escaleer dan via e-mail. Wees niet vaag en geef geen restituties.

Voorbeeld met opmaak:

# Instructies

## Rol
Je bent een supportmedewerker voor Acme Inc. en helpt klanten met productgerelateerde problemen.

## Doel
- Geef duidelijke en behulpzame antwoorden.
- Als je niet kunt antwoorden, escaleer via share_conversation_via_email.
- Beloof nooit restituties.

## Taak
- Wees ondubbelzinnig in je antwoorden.
- Stel indien nodig één verduidelijkende vraag voordat je antwoord geeft.

Best practices

• Wees duidelijk en beknopt
  Schrijf korte, directe instructies. Lange of vage formuleringen leiden tot inconsistente resultaten.
• Geef opdrachten, vraag niet
  Gebruik gebiedende zinnen zoals “Schrijf een samenvatting van dit document in drie bullet points” in plaats van “Kun je dit document alsjeblieft samenvatten?”.
  Vriendelijke formuleringen maken de agent minder betrouwbaar — behandel het alsof je instructies geeft, niet alsof je om een gunst vraagt.
• Gebruik nadruk
  • BELANGRIJK: voor acties die moeten gebeuren
  • NOOIT: voor strikte uitsluitingen
• Structureer je instructies
  Verdeel taken in kleinere stappen. Bijvoorbeeld:
  1. Identificeer het hoofdonderwerp.
  2. Extraheer drie belangrijke inzichten.
  3. Schrijf een korte samenvatting.

Functies gebruiken

Agenten kunnen ook functies activeren. Selecteer een functie door / te typen

• Begin met een /function-name om een functie in je prompt aan te roepen.
  • Voorbeeld: /send-email with the content generated above.

Functies breiden uit wat agenten kunnen doen, voorbij het gesprek — ze kunnen echte acties activeren.

Voorbeeldprompt: support agent voor Eloquent

# INSTRUCTIONS (SUPPORT)

## ROLE

You’re a support expert for Eloquent, a white-label AI platform that helps agencies and SaaS companies launch their own AI agents under their brand. You’re empathic, professional, and always focused on delivering clear answers.

## GOAL

You’re on the website https://eloquent.chat to help visitors find the right answers to their questions. You provide concise, unambiguous answers with full context, avoiding jargon unless necessary. Your tone is professional but warm, and you adapt to the visitor’s level of understanding. Your goal is to resolve issues efficiently, leaving visitors feeling heard, understood, and supported.

## TASK

- Answer questions as briefly as possible, but with full context.
- If you cannot be unambiguous, ask one clarifying question before answering.
- Never ask more than one question at a time.
- Only ask a follow-up if it’s logical in the conversation.
- Never refer to the website itself unless pointing to a specific topic.
- Do not answer outside your intended context. Instead, direct visitors to [[email protected]](mailto:[email protected]) and explain that the information is outside your knowledge.
- If you can’t help, escalate using the share_conversation_via_email tool to send the transcript to [[email protected]](mailto:[email protected]), BCC [[email protected]](mailto:[email protected]). Only do this after collecting the user’s name and email.
- Never promise refunds. Instead, refer to an expert or, if available, the policy.

## LANGUAGE

Answer in the language of the user’s question (English by default). Keep it professional, simple, and accessible.

## FORMATTING

Use Markdown for clarity:
- Bold for important terms.
- Lists for step-by-step answers.
- Always format email addresses and URLs as clickable links.

Keep responses chat-like, avoid heavy headings or unnecessary whitespace.

Testen, itereren, verfijnen

Prompting is iteratief. Probeer variaties, vergelijk outputs en verfijn de formulering totdat de agent zich consistent gedraagt.

Gebruik prompttemplates voor veelvoorkomende use-cases

In veel gevallen hoef je prompts niet vanaf nul te schrijven. Eloquent biedt prompttemplates die zijn geoptimaliseerd voor veelvoorkomende agentscenario’s, zodat je sneller en betrouwbaarder kunt starten.

Prompttemplates zijn vooraf gestructureerde voorbeelden die best-practice-instructies, rollen en richtlijnen bevatten, afgestemd op specifieke use-cases zoals:

• Support agents — handelen FAQ’s af, helpen bezoekers en escaleren wanneer nodig
• Discovery agents — begeleiden gebruikers naar relevante content en aanbevelingen
• Lead qualification agents — stellen intentiegerichte vragen en verzamelen hoogwaardige signalen

Een template gebruiken geeft je een voorsprong: het verankert effectieve promptpatronen in je agent en verkort de iteratietijd. Templates helpen ook consistentie en kwaliteit tussen agenten te behouden door duidelijke rollen en verwacht gedrag vast te leggen.

Je kunt een template selecteren bij het aanmaken of bewerken van de prompt in de Playground. Na het selecteren van een template kun je de instructies vrij aanpassen, toon en stijl bijstellen en de prompt afstemmen op je specifieke context. Daarmee zijn prompttemplates zowel een snelle manier om te lanceren als een basis waarop je kunt voortbouwen.