# Agents

## Wat zijn agents?

Agents zijn geïsoleerde AI-assistenten die problemen analyseren, taken uitvoeren en via meerdere platforms communiceren. Elke agent heeft zijn eigen werkruimte, sessiegeschiedenis, modelconfiguratie en kanaalverbindingen.

## Agent-isolatie

Elke agent krijgt:

- **Werkruimte**, Een speciale map voor bestanden, notities en agentspecifieke gegevens
- **Sessies**, Onafhankelijke gespreksgeschiedenis en transcripten
- **Configuratie**, Modelselectie, toolrechten, bestedingslimieten
- **Identiteit**, Een unieke persona gedefinieerd in het `AGENTS.md`-bestand van de agent
- **Auth-profielen**, Per-agent API-sleutel en authenticatieconfiguraties

## Agent-persona's

De werkruimte van elke agent bevat een `AGENTS.md`-bestand dat de persoonlijkheid, instructies en gedragsrichtlijnen definieert. Deze aanhoudende systeemprompt bepaalt hoe de agent reageert, toon, vakkennis, opmaak, toolgebruik en veiligheidsbeleid.

## Multi-agent-routering

Bij het uitvoeren van meerdere agents worden inkomende berichten automatisch gerouteerd op basis van **verbindingen**:

- **Kanaalverbinding**, Stuur alle berichten van een platform door (bijv. alle Telegram → `persoonlijke` agent)
- **Server-/werkruimteverbinding**, Stuur een specifieke Discord-server of Slack-werkruimte door naar een toegewijde agent
- **Chattype-verbinding**, Stuur privéberichten naar één agent en groepsberichten naar een andere
- **Contact-/peerverbinding**, Stuur berichten van specifieke contacten naar specifieke agents

Verbindingen worden geëvalueerd in volgorde van prioriteit. De eerste overeenkomst wint. Niet-overeenkomende berichten gaan naar de standaard agent.

## Sub-agents en delegatie

Agents kunnen sub-agents aanmaken voor gespecialiseerde taken:

- **Taakdelegatie**, Complexe taken opsplitsen en onderdelen delegeren aan gespecialiseerde sub-agents
- **Geïsoleerde uitvoering**, Sub-agents draaien in hun eigen sessiecontext
- **Ping-pong-gesprekken**, Agents kunnen heen-en-weer uitwisselingen hebben (tot 5 beurten) om samen te werken
- **Resultaataankondiging**, Resultaten van sub-agents kunnen worden teruggepost naar het oorspronkelijke kanaal

## Teams en orkestratie

Multi-agent-teams maken gecoördineerde workflows mogelijk:

- **Parallelle uitvoering**, Meerdere agents tegelijkertijd uitvoeren op verschillende aspecten van een taak
- **Sequentiële pipelines**, Agents koppelen waarbij elke agent voortbouwt op de vorige uitvoer
- **Hybride modus**, Parallelle en sequentiële uitvoering combineren
- **Taakbewaking**, Status van het werk van elke agent bijhouden (in de wachtrij, actief, klaar, fout, geannuleerd)

## Toolprofielen

Beheer wat elke agent kan doen:

| Profiel | Beschikbare tools |
|---------|------------------|
| **minimal** | Alleen sessiestatus |
| **coding** | Bestands-I/O, uitvoering, sessies, geheugen, afbeeldingen |
| **messaging** | Berichten verzenden, sessiegeschiedenis |
| **full** | Alle tools (standaard) |

Aangepaste toe- en uitsluitingslijsten kunnen per agent en per modelprovider worden ingesteld.

## Veilige modus

De veilige modus biedt een uitvoeringsomgeving met extra beveiliging:

- **Hoofdschakelaar**, Wereldwijd in- of uitschakelen
- **Per-agent-bediening**, Uitschakelen voor vertrouwde agents, aan laten voor anderen
- **Uitvoeringsgoedkeuring**, Gevoelige bewerkingen vereisen expliciete gebruikersgoedkeuring
- **Beleidssynchronisatie**, Instellingen worden in real time gesynchroniseerd over alle verbonden clients

## Agentgeheugen

Elke agent heeft toegang tot een geheugensysteem:

- **MEMORY.md**, Aanhoudende notities en belangrijke informatie over sessies heen
- **Geheugenbestanden**, Aanvullende gestructureerde kennis in `memory/`
- **Vectorzoeken**, Geheugen doorzoeken met zoekopdrachten in natuurlijke taal

Zie [Sessies en geheugen](sessions-memory.md) voor meer informatie.