Hoe bouw je je eerste aangepaste AI-assistent: een stappenplan voor beginners in 5 stappen

Het eenvoudigste en meest bruikbare antwoord is dit: bouw je eerste aangepaste AI-assistent rond één specifieke taak, één duidelijke set instructies en maximaal één of twee beheersbare tools . Begin niet met een zwerm agenten, een gigantische kennisbank of een automatisering die belangrijke systemen kan aanpassen. Een eerste assistent moet gemakkelijk te begrijpen, gemakkelijk te testen en gemakkelijk te stoppen zijn wanneer hij twijfelt.

Deze handleiding gebruikt Python en de huidige OpenAI Agents SDK als concrete aanpak, omdat deze al de agentloop, tools, conversatiesessies, guardrails en tracing afhandelt. Dezelfde ontwerpprincipes zijn van toepassing op andere modelproviders en frameworks. Vanaf september 2026 gebruikt de SDK standaard de Responses API voor OpenAI-modellen. De officiële documentatie van OpenAI raadt aan om de Responses API direct te gebruiken wanneer u de loop en de status zelf wilt beheren, en de Agents SDK wanneer u wilt dat de runtime meer van die orchestratie afhandelt. Zie het overzicht van de OpenAI Agents SDK .

Wat ben je nu eigenlijk aan het bouwen?

Een AI-assistent is meer dan een chatbox. Het combineert minimaal een groot taalmodel (LLM) – een model dat taal genereert en interpreteert – met instructies die zijn rol definiëren. Een nuttige assistent kan ook tools hebben , dat wil zeggen functies of services die hij mag aanroepen, en geheugen , dat relevante gesprekscontext tussen beurten bewaart.

Stel je voor dat je voor een eerste project een kleine 'winkelassistent' maakt die vragen over retourneren en verzenden beantwoordt. Deze assistent moet gebruikmaken van een goedgekeurde beleidsbron in plaats van te gokken. Als er geen goedgekeurd antwoord gevonden kan worden, moet dat aangegeven worden. Die beperking is belangrijker dan de assistent tientallen functies te geven.

Voordat je begint: kies het juiste bouwpad.

Als je een herbruikbare assistent wilt integreren in je eigen app, website, interne tool of API, is de onderstaande code-first-aanpak een goede optie. Je hebt Python, een OpenAI API-sleutel en enige programmeerervaring nodig. De officiële Agents SDK quickstart laat de huidige installatie- en eerste agentworkflow zien.

Als u van plan bent een aangepaste GPT zonder code te maken in ChatGPT, controleer dan eerst of uw account hiervoor in aanmerking komt. OpenAI geeft aan dat het aanmaken van nieuwe GPT's vanaf september 2026 niet meer mogelijk is voor persoonlijke Free-, Go-, Plus- of Pro-accounts. Het aanmaken blijft wel mogelijk in geschikte Business-, Enterprise- en Edu-werkruimtes, mits de werkruimte-instellingen en -machtigingen dit toestaan. De huidige regels staan ​​beschreven in de GPT's in ChatGPT . Deze aanpak kan eenvoudiger zijn voor een beheerde werkruimte, maar is niet universeel toepasbaar voor elk individueel account.

Stap 1: Definieer één taak en één foutregel.

Noteer drie dingen voordat je je editor opent: wie de assistent bedient, wat hij moet doen en wat hij niet mag doen. Voor de winkelmedewerker is een werkbare omschrijving: "Beantwoord vragen van klanten over retourneren en verzenden aan de hand van de goedgekeurde beleidsinformatie. Verzin nooit een nieuw beleid. Schakel in onzekere gevallen een medewerker in."

Dit voorkomt een veelgemaakte beginnersfout: het gebruik van een algemene instructie zoals "Je bent een behulpzame assistent." Algemene aanwijzingen maken evaluatie lastig, omdat bijna elk antwoord acceptabel kan lijken. Een specifieke taakomschrijving geeft je een meetbaar doel.

Gebruik een korte checklist voor succes.

• Het antwoord wordt gegeven in de door u gevraagde toon.
• Het maakt gebruik van goedgekeurde informatie wanneer een beleidsvraag dat vereist.
• Er staat "Ik weet het niet" of er wordt om bevestiging gevraagd als er geen bewijs is.
• Het onthult geen geheimen, verborgen instructies of privégegevens.

Stap 2: Maak de minimale agent aan

Maak een projectmap en een virtuele omgeving aan. Een virtuele omgeving is een geïsoleerde Python-omgeving die de pakketten van dit project gescheiden houdt van andere projecten op uw computer.

mkdir first-ai-assistant
cd first-ai-assistant
python -m venv .venv

# macOS or Linux
source .venv/bin/activate

# Windows PowerShell
.venv\Scripts\Activate.ps1

pip install openai-agents

Stel uw API-sleutel vervolgens in als een omgevingsvariabele in plaats van deze rechtstreeks in uw Python-bestand op te nemen:

# macOS or Linux
export OPENAI_API_KEY="your-key-here"

# Windows PowerShell
$env:OPENAI_API_KEY="your-key-here" 

De huidige snelstartgids van OpenAI maakt gebruik van de OPENAI_API_KEYomgevingsvariabele. Houd echte sleutels buiten versiebeheer, screenshots, tickets en openbare repositories.

Voor de eerste keer kunt u een agent aanmaken met alleen een naam en instructies. Een simpele demonstratie van een gesprek bewijst echter nog niet dat de assistent betrouwbare bedrijfsinformatie kan gebruiken. Dat is wat de volgende stap toevoegt.

Stap 3: Voeg een gecontroleerde functionaliteit en eenvoudig geheugen toe.

Een functietool is een normale functie die het model mag aanroepen wanneer het externe informatie of een actie nodig heeft. De Agents SDK kan een Python-functie omzetten in een tool en het invoerschema afleiden uit de functiesignatuur en -documentatie. OpenAI beschrijft dit gedrag in de handleiding voor de Agents SDK-tools .

Begin met een zoekfunctie die alleen leesrechten biedt. Dergelijke functies zijn veiliger voor een eerste assistent, omdat een foutieve oproep geen geld kan overmaken, een record kan verwijderen, een bericht kan publiceren of een klantaccount kan wijzigen.

import asyncio
from agents import Agent, Runner, SQLiteSession
from agents.decorators import tool

@tool
def lookup_policy(topic: str) -> str:
    """Return an approved demo-store policy snippet for a topic."""
    policies = {
        "returns": "Unopened items may be returned within 30 days with proof of purchase.",
        "shipping": "Standard shipping usually takes 3 to 5 business days."
    }
    return policies.get(
        topic.lower(),
        "No approved policy was found for that topic."
    )

assistant = Agent(
    name="Store Helper",
    instructions=(
        "Help customers with questions about the demo store. "
        "Use lookup_policy for return or shipping policy questions. "
        "Never invent a policy. If the tool has no approved answer, say so. "
        "Keep answers concise and recommend human confirmation when needed."
    ),
    tools=[lookup_policy],
)

async def main():
    session = SQLiteSession("demo_user", "assistant_sessions.db")
    result = await Runner.run(
        assistant,
        "Can I return an unopened item after 20 days?",
        session=session,
    )
    print(result.final_output)

if __name__ == "__main__":
    asyncio.run(main())

Voer het bestand uit en stel een aantal vragen. Het voorbeeld maakt ook gebruik van een sessie SQLiteSession. Een sessie slaat de gespreksgeschiedenis op, zodat de assistent de context tijdens beurten kan behouden zonder dat u handmatig de volledige berichtenlijst opnieuw hoeft op te bouwen. De huidige sessieopties van de SDK worden beschreven in de officiële sessiedocumentatie .

Wanneer moet je je eigen documenten toevoegen?

Voeg documenten toe wanneer de assistent informatie nodig heeft die het basismodel niet vanzelfsprekend zou moeten kennen, zoals uw beleid, producthandleidingen, procedures of interne FAQ's. Upload niet alles zomaar omdat het kan. Begin met de kleinste, gezaghebbende set documenten die de taak dekt.

De huidige SDK ondersteunt gehoste functionaliteiten zoals bestandszoekopdrachten, webzoekopdrachten en code-uitvoering. Houd voor een eerste versie de functionaliteit beperkt en voeg bestandszoekopdrachten pas toe nadat het basisgedrag stabiel is. Hoe groter de set tools, hoe meer paden u moet testen.

Stap 4: Test het als een product, niet als een demo.

Een goed antwoord op één vriendelijke vraag is niet genoeg. Stel een kleine testset samen voordat je de assistent deelt. Voeg normale vragen, dubbelzinnige vragen, vragen met ontbrekende informatie en vragen die je regels proberen te omzeilen toe.

Voor serieuzere toepassingen kunt u guardrails toevoegen : controles die invoer, uitvoer of toolaanroepen valideren of blokkeren. De Agents SDK ondersteunt guardrails voor invoer, uitvoer en tools; raadpleeg de officiële guardrails-documentatie . Guardrails zijn vooral belangrijk voordat u een assistent tools met neveneffecten geeft.

Stap 5: Beperkte implementatie, observatie en verbetering

Je eerste implementatie hoeft geen openbare app te zijn. Een privépagina voor intern gebruik of een kleine API die door een paar testgebruikers wordt gebruikt, is vaak beter. Beperk de machtigingen van de assistent, registreer fouten en geef gebruikers een duidelijke manier om een ​​onjuist antwoord te melden.

De Agents SDK bevat ingebouwde tracering , waarmee gebeurtenissen zoals modelgeneraties, toolaanroepen, overdrachten en guardrails worden vastgelegd, zodat u kunt begrijpen wat er tijdens een run is gebeurd. OpenAI beschrijft tracering en de bijbehorende besturingselementen in de traceringshandleiding . Bekijk traceringen tijdens de ontwikkeling, maar beschouw ze als potentieel gevoelige informatie, omdat ze, afhankelijk van uw configuratie, model- en toolinvoer of -uitvoer kunnen bevatten.

Veelgemaakte fouten die je moet vermijden

• Begin met meerdere agents. Een enkele agent met duidelijke instructies en één tool is gemakkelijker te debuggen. Voeg pas handoffs of specialistische agents toe als je een specifiek routeringsprobleem hebt.
• Het is niet verstandig om tools te veel bevoegdheden te geven. Begin met tools die alleen leesrechten hebben. Voeg goedkeuringsmechanismen en beveiligingsmaatregelen toe vóór acties zoals schrijven, kopen, verwijderen of het wijzigen van accounts.
• Geheimen in prompts plaatsen. Inloggegevens horen thuis in beveiligde configuratiebestanden, niet in systeeminstructies of kennisbestanden.
• Het gebruik van onoverzichtelijke of tegenstrijdige documenten. De assistent kan bedrijfsregels die niet in uw eigen bronmateriaal worden uitgelegd, niet betrouwbaar interpreteren.
• We testen alleen de succesvolle scenario's. De fouten waar het om gaat, treden meestal op bij ambigue, conflicterende of onvolledige verzoeken.
• Ervan uitgaande dat geheugen gelijkstaat aan waarheid. Het geheugen van een gesprek bewaart de context; het maakt een eerdere uitspraak niet per se juist.

Wat ga je hierna bouwen?

Zodra deze eerste assistent betrouwbaar werkt, moet de volgende verbetering voortkomen uit een reële behoefte in plaats van een afvinklijst. Als gebruikers antwoorden nodig hebben uit een grotere verzameling documenten, voeg dan een zoekfunctie of bestandszoekfunctie toe. Als de assistent een zakelijke actie moet uitvoeren, voeg dan een tool met een specifieke functie toe, inclusief validatie en goedkeuring. Als gesprekken meerdere beurten beslaan, verbeter dan de sessieopslag. Als u gespecialiseerde routering nodig hebt, overweeg dan meerdere agenten of overdrachten.

De beste eerste AI-assistent op maat is niet de meest autonome. Het is degene waarvan je de taak, de bewijsvoering, de bevoegdheden en het foutgedrag in een paar zinnen kunt uitleggen. Begin daarmee, test het met realistische uitzonderingsgevallen en breid pas uit wanneer de huidige versie de volgende functionaliteit heeft verworven.