🌐 README-vertalingen

Français • 日本語 • 한국어 • 中文 • Español • Italiano • Nederlands • Deutsch • Polski • Türkçe • Українська • Ελληνικά • Русский • العربية

AgentDock: Onbegrensde mogelijkheden met AI-Agenten

AgentDock is een framework voor het bouwen van geavanceerde AI-agenten die complexe taken uitvoeren met configureerbaar determinisme. Het bestaat uit twee hoofdcomponenten:

1. AgentDock Core: Een open-source, backend-first framework voor het bouwen en implementeren van AI-agenten. Het is ontworpen om framework-agnostisch en provider-agnostisch te zijn, waardoor je volledige controle hebt over de implementatie van je agent.

2. Open Source Client: Een volledige Next.js-applicatie die dient als referentie-implementatie en consument van het AgentDock Core-framework. Je kunt het in actie zien op https://hub.agentdock.ai

Gebouwd met TypeScript, legt AgentDock de nadruk op eenvoud, uitbreidbaarheid en configureerbaar determinisme, waardoor het ideaal is voor het bouwen van betrouwbare, voorspelbare AI-systemen die met minimale supervisie kunnen werken.

🧠 Ontwerpprincipes

AgentDock is gebouwd op deze kernprincipes:

• Eenvoud Eerst: Minimale code vereist om functionele agenten te creëren
• Op nodes gebaseerde architectuur: Alle capaciteiten worden geïmplementeerd als nodes
• Tools als Gespecialiseerde Nodes: Tools breiden het nodesysteem uit voor agentcapaciteiten
• Configureerbaar Determinisme: Beheer de voorspelbaarheid van agentgedrag
• Typeveiligheid: Volledige TypeScript-types overal

Configureerbaar Determinisme

Configureerbaar determinisme is een hoeksteen van de ontwerpfilosofie van AgentDock, waardoor je de creatieve capaciteiten van AI kunt balanceren met voorspelbaar systeemgedrag:

• AgentNodes zijn inherent niet-deterministisch aangezien LLM's elke keer verschillende reacties kunnen genereren
• Workflows kunnen deterministischer worden gemaakt via gedefinieerde tool-uitvoeringspaden
• Ontwikkelaars kunnen het niveau van determinisme controleren door te configureren welke delen van het systeem LLM-inferentie gebruiken
• Zelfs met LLM-componenten blijft het algehele systeemgedrag voorspelbaar door gestructureerde tool-interacties
• Met deze aanpak kunnen zowel creativiteit als betrouwbaarheid in je AI-applicaties worden bereikt

Deterministische Workflows

AgentDock ondersteunt volledig de deterministische workflows waarmee je vertrouwd bent vanuit typische workflow-bouwers. Alle voorspelbare uitvoeringspaden en betrouwbare resultaten die je verwacht zijn beschikbaar, met of zonder LLM-inferentie:

Niet-Deterministisch Agentgedrag

Met AgentDock kun je ook AgentNodes met LLM's gebruiken wanneer je meer aanpassingsvermogen nodig hebt. Creatieve outputs kunnen variëren op basis van je behoeften, terwijl gestructureerde interactiepatronen behouden blijven:

Niet-Deterministische Agenten met Deterministische Sub-Workflows

AgentDock biedt je het beste van twee werelden door niet-deterministische agentintelligentie te combineren met deterministische workflow-uitvoering:

Met deze aanpak kunnen complexe, meerstaps workflows (mogelijk met honderden deterministische stappen geïmplementeerd binnen tools of als sequenties van verbonden nodes) worden aangeroepen door intelligente agentbeslissingen. Elke workflow wordt voorspelbaar uitgevoerd ondanks dat deze wordt getriggerd door niet-deterministische agentredenering.

Voor meer geavanceerde AI-agent workflows en multi-stage verwerkingspipelines bouwen we aan AgentDock Pro - een krachtig platform voor het bouwen, visualiseren en uitvoeren van complexe agentsystemen.

Kort samengevat (TL;DR): Configureerbaar Determinisme

Vergelijk het met autorijden. Soms heb je de creativiteit van AI nodig (zoals navigeren door stadsstraten - niet-deterministisch), en soms heb je betrouwbare, stapsgewijze processen nodig (zoals het volgen van snelwegborden - deterministisch). Met AgentDock kun je systemen bouwen die beide gebruiken, waarbij je de juiste aanpak kiest voor elk deel van een taak. Je krijgt de intelligentie van AI en voorspelbare resultaten waar nodig.

🏗️ Kernarchitectuur

Het framework is gebouwd rond een krachtig, modulair, op nodes gebaseerd systeem, dat dient als basis voor alle agentfunctionaliteit. Deze architectuur gebruikt verschillende node-typen als bouwstenen:

• BaseNode: De fundamentele klasse die de kerninterface en mogelijkheden voor alle nodes vastlegt.
• AgentNode: Een gespecialiseerde kern-node die LLM-interacties, toolgebruik en agentlogica orkestreert.
• Tools en Aangepaste Nodes: Ontwikkelaars implementeren agentcapaciteiten en aangepaste logica als nodes die BaseNode uitbreiden.

Deze nodes interageren via beheerde registers en kunnen worden verbonden (gebruikmakend van kernarchitectuurpoorten en een potentiële message bus) om complexe, configureerbare en potentieel deterministische agentgedragingen en workflows mogelijk te maken.

Voor een gedetailleerde uitleg van de componenten en mogelijkheden van het nodesysteem, zie de Node Systeem Documentatie.

🚀 Aan de slag

Voor een uitgebreide gids, zie de Getting Started Gids.

Vereisten

• Node.js ≥ 20.11.0 (LTS)
• pnpm ≥ 9.15.0 (Vereist)
• API-sleutels voor LLM-providers (Anthropic, OpenAI, etc.)

Installatie

1. Kloon de Repository:

   git clone https://github.com/AgentDock/AgentDock.git
   cd AgentDock
   

2. Installeer pnpm:

   corepack enable
   corepack prepare pnpm@latest --activate
   

3. Installeer Afhankelijkheden:

   pnpm install
   

   Voor een schone herinstallatie (wanneer je vanaf nul moet herbouwen):

   pnpm run clean-install
   

   Dit script verwijdert alle node_modules, lock-bestanden en herinstalleert de afhankelijkheden correct.

4. Configureer de Omgeving:

   Maak een omgevingsbestand (.env of .env.local) aan op basis van het meegeleverde .env.example-bestand:

   # Optie 1: Maak .env.local aan
   cp .env.example .env.local
   
   # Optie 2: Maak .env aan
   cp .env.example .env
   

   Voeg vervolgens je API-sleutels toe aan het omgevingsbestand.

5. Start de Ontwikkelserver:

   pnpm dev
   

Geavanceerde Mogelijkheden

Het opslagsysteem evolueert momenteel met key-value opslag (Memory, Redis, Vercel KV providers) en client-side secure storage, terwijl vectoropslag en extra backends in ontwikkeling zijn.

📕 Documentatie

De documentatie voor het AgentDock-framework is beschikbaar op hub.agentdock.ai/docs en in de /docs/ map van deze repository. De documentatie omvat:

• Getting started-gidsen
• API-referenties
• Tutorials voor het bouwen van nodes
• Integratievoorbeelden

📂 Repository Structuur

Deze repository bevat:

1. AgentDock Core: Het kernframework, te vinden in agentdock-core/
2. Open Source Client: Een volledige referentie-implementatie gebouwd met Next.js, die dient als consument van het AgentDock Core-framework.
3. Voorbeeldagenten: Kant-en-klare agentconfiguraties in de agents/ map

Je kunt AgentDock Core onafhankelijk gebruiken in je eigen applicaties, of deze repository gebruiken als startpunt voor het bouwen van je eigen agent-aangedreven applicaties.

📝 Agent Templates

AgentDock bevat verschillende vooraf geconfigureerde agent templates. Verken ze in de agents/ map of lees de Agent Template Documentatie voor configuratiedetails.

🔧 Voorbeeldimplementaties

Voorbeeldimplementaties tonen gespecialiseerde use cases en geavanceerde functionaliteit:

🔐 Omgevingsconfiguratie Details

De AgentDock Open Source Client vereist API-sleutels voor LLM-providers om te functioneren. Deze worden geconfigureerd in een omgevingsbestand (.env of .env.local) dat je aanmaakt op basis van het meegeleverde .env.example-bestand.

LLM Provider API-sleutels

Voeg je LLM-provider API-sleutels toe (minimaal één vereist):

# LLM Provider API Sleutels - minimaal één vereist
ANTHROPIC_API_KEY=sk-ant-xxxxxxx  # Anthropic API Sleutel
OPENAI_API_KEY=sk-xxxxxxx         # OpenAI API Sleutel
GEMINI_API_KEY=xxxxxxx            # Google Gemini API Sleutel
DEEPSEEK_API_KEY=xxxxxxx          # DeepSeek API Sleutel
GROQ_API_KEY=xxxxxxx              # Groq API Sleutel

API-sleutel Resolutie

De AgentDock Open Source Client volgt een prioriteitsvolgorde bij het bepalen welke API-sleutel te gebruiken:

1. Aangepaste API-sleutel per agent (ingesteld via agentinstellingen in de UI)
2. Globale instellingen API-sleutel (ingesteld via de instellingenpagina in de UI)
3. Omgevingsvariabele (van .env.local of implementatieplatform)

Tool-Specifieke API-sleutels

Sommige tools vereisen ook hun eigen API-sleutels:

# Tool-Specifieke API Sleutels
SERPER_API_KEY=                  # Vereist voor zoekfunctionaliteit
FIRECRAWL_API_KEY=               # Vereist voor diepere web scraping

Voor meer details over omgevingsconfiguratie, zie de implementatie in src/types/env.ts.

Je Eigen API-sleutels Gebruiken (BYOK)

AgentDock volgt een BYOK (Bring Your Own Key) model:

1. Voeg je API-sleutels toe op de instellingenpagina van de applicatie
2. Alternatief, lever sleutels via request headers voor direct API-gebruik
3. Sleutels worden veilig opgeslagen met het ingebouwde encryptiesysteem
4. Er worden geen API-sleutels gedeeld of opgeslagen op onze servers

📦 Pakketbeheerder

Dit project vereist het gebruik van pnpm voor consistent afhankelijkheidsbeheer. npm en yarn worden niet ondersteund.

💡 Wat Je Kunt Bouwen

1. AI-Aangedreven Applicaties

   • Aangepaste chatbots met elke frontend
   • Command-line AI-assistenten
   • Geautomatiseerde dataverwerkingspipelines
   • Backend service-integraties

2. Integratiemogelijkheden

   • Elke AI-provider (OpenAI, Anthropic, etc.)
   • Elk frontend framework
   • Elke backend service
   • Aangepaste databronnen en API's

3. Automatiseringssystemen

   • Dataverwerkingsworkflows
   • Documentanalyse pipelines
   • Geautomatiseerde rapportagesystemen
   • Taakautomatiseringsagenten

Kernfuncties

🧰 Componenten

De modulaire architectuur van AgentDock is gebouwd op deze kerncomponenten:

• BaseNode: De basis voor alle nodes in het systeem
• AgentNode: De hoofdabstractie voor agentfunctionaliteit
• Tools en Aangepaste Nodes: Aanroepbare capaciteiten en aangepaste logica geïmplementeerd als nodes.
• Node Registry: Beheert de registratie en het ophalen van alle node-typen
• Tool Registry: Beheert de beschikbaarheid van tools voor agenten
• CoreLLM: Uniforme interface voor interactie met LLM-providers
• Provider Registry: Beheert LLM-providerconfiguraties
• Foutafhandeling: Systeem voor het afhandelen van fouten en het waarborgen van voorspelbaar gedrag
• Logging: Gestructureerd loggingsysteem voor monitoring en debugging
• Orkestratie: Controleert toolbeschikbaarheid en gedrag op basis van conversatiecontext
• Sessies: Beheert state-isolatie tussen gelijktijdige conversaties

Voor gedetailleerde technische documentatie over deze componenten, zie het Architectuuroverzicht.

🗺️ Roadmap

Hieronder staat onze ontwikkelingsroadmap voor AgentDock. De meeste hier genoemde verbeteringen hebben betrekking op het AgentDock-kernframework (agentdock-core), dat momenteel lokaal wordt ontwikkeld en als een geversioneerd NPM-pakket zal worden gepubliceerd zodra een stabiele release is bereikt. Sommige roadmap-items kunnen ook verbeteringen aan de open-source client-implementatie met zich meebrengen.

👥 Bijdragen

We verwelkomen bijdragen aan AgentDock! Zie CONTRIBUTING.md voor gedetailleerde bijdragerichtlijnen.

📜 Licentie

AgentDock wordt uitgebracht onder de MIT Licentie.

✨ Grenzeloze mogelijkheden!

AgentDock biedt de basis om vrijwel elke AI-aangedreven applicatie of automatisering te bouwen die je je kunt voorstellen. We moedigen je aan om het framework te verkennen, innovatieve agenten te bouwen en bij te dragen aan de community. Laten we samen de toekomst van AI-interactie bouwen!

Terug naar Vertalingsindex