Neu

EDDI v6 wurde veröffentlicht! Jetzt starten

Jetzt Starten

Erste Schritte mit EDDI

EDDI installieren, ersten Agent erstellen und in 5 Minuten chatten.

Erste Schritte mit EDDI

Voraussetzungen

  • Docker (empfohlen) oder Java 25+
  • Ein LLM-Anbieter-API-Key (OpenAI, Anthropic, Google Gemini oder eine lokale Ollama-Instanz)

1. EDDI installieren & starten

Der schnellste Weg, EDDI zum Laufen zu bringen, ist das Ein-Befehl-Installationsskript. Es richtet EDDI + Ihre Wahl der Datenbank über Docker Compose ein, stellt einen Starter-Agent bereit und führt Sie durch die Konfiguration:

Linux / macOS / WSL2:

curl -fsSL https://raw.githubusercontent.com/labsai/EDDI/main/install.sh | bash

Windows (PowerShell):

iwr -useb https://raw.githubusercontent.com/labsai/EDDI/main/install.ps1 | iex

Wenn Sie manuelle Kontrolle bevorzugen, klonen Sie das Repository und verwenden Sie Docker Compose direkt:

docker compose up

EDDI ist unter http://localhost:7070 erreichbar.

2. Via MCP verbinden

Wenn Sie Claude Desktop oder einen MCP-kompatiblen Client verwenden, fügen Sie EDDI als MCP-Server hinzu:

{
  "mcpServers": {
    "eddi": {
      "url": "http://localhost:7070/mcp"
    }
  }
}

Jetzt können Sie mit EDDIs 42 MCP-Tools direkt aus Ihrem KI-Assistenten interagieren.

3. API-Key sicher speichern

Bevor Sie einen Agent erstellen, speichern Sie Ihren LLM-Anbieter-API-Key sicher in EDDIs Secrets Vault (AES-256-GCM verschlüsselt):

curl -X PUT http://localhost:7070/secretstore/secrets/default/my-anthropic-key \
  -H "Content-Type: application/json" \
  -d '{"value": "sk-ant-your-actual-key", "description": "Anthropic API key"}'

Öffnen Sie die Manager-UI unter http://localhost:7070, navigieren Sie zu Secrets Vault und fügen Sie ein neues Secret mit dem Schlüsselnamen my-anthropic-key hinzu.

💡 Tipp: Die ${eddivault:my-anthropic-key}-Syntax referenziert EDDIs integrierten Secrets Vault. Der Vault-Masterschlüssel wird automatisch vom Installer generiert. Zum schnellen Testen können Sie API-Keys auch direkt übergeben: apiKey: "sk-ant-...".

4. Ersten Agent erstellen

Verwenden Sie setup_agent, um in einem Aufruf einen funktionsfähigen Agent zu erstellen — via MCP oder REST-API:

setup_agent(
  agentName: "My first agent",
  systemPrompt: "You are a helpful assistant that answers questions clearly.",
  provider: "anthropic",
  model: "claude-sonnet-4-6",
  apiKey: "${eddivault:my-anthropic-key}"
)
curl -X POST http://localhost:7070/administration/agents/setup \
  -H "Content-Type: application/json" \
  -d '{
    "agentName": "My first agent",
    "systemPrompt": "You are a helpful assistant that answers questions clearly.",
    "provider": "anthropic",
    "model": "claude-sonnet-4-6",
    "apiKey": "${eddivault:my-anthropic-key}"
  }'

Dies erstellt Regeln, LLM-Konfiguration, Workflow, Agent und deployt ihn — alles in einem Schritt.

5. Mit Ihrem Agent chatten

chat_with_agent(agentId: "<your-agent-id>", message: "Hello! What can you do?")
# Start a conversation and send a message
curl -X POST http://localhost:7070/agents/<your-agent-id>/start \
  -H "Content-Type: application/json" \
  -d '{"input": "Hello! What can you do?"}'

6. Die Manager-UI öffnen

Navigieren Sie zu http://localhost:7070, um Ihre Agents, Workflows und Konversationen visuell mit dem EDDI Manager zu verwalten.

EDDI Manager UI Dashboard-Vorschau

Installer-Optionen

Das Installationsskript unterstützt Flags für automatisierte und angepasste Setups:

  • --defaults — Alle Standardwerte, keine Eingabeaufforderungen
  • --db=postgres — PostgreSQL statt MongoDB verwenden
  • --with-auth — Keycloak-Authentifizierung aktivieren
  • --full — Alles aktiviert (Datenbank + Auth + Monitoring)
  • --local — Docker-Image aus lokalem Quellcode bauen (für Beitragende)

EDDI aktualisieren

Der Installer erstellt einen eddi CLI-Wrapper. Um das neueste Image zu laden und neu zu starten:

eddi update

Falls die CLI nicht verfügbar ist, führen Sie den Befehl aus Ihrem Installationsverzeichnis (~/.eddi) aus:

cd ~/.eddi
docker compose --env-file .env -f docker-compose.yml pull
docker compose --env-file .env -f docker-compose.yml up -d

Kubernetes-Deployment

Deployment auf Kubernetes mit einem einzigen Befehl:

kubectl apply -f https://raw.githubusercontent.com/labsai/EDDI/main/k8s/quickstart.yaml

Kustomize-Overlays und Helm-Charts sind ebenfalls verfügbar für MongoDB, PostgreSQL, Auth, Monitoring und Produktionshärtung (HPA, PDB, NetworkPolicy). Siehe den Kubernetes-Leitfaden.

Quarkus SDK

Sie bauen eine Quarkus-App? Verwenden Sie die quarkus-eddi-Erweiterung für Dev Services, Fluent API, SSE-Streaming und MCP-Bridge:

<dependency>
    <groupId>io.quarkiverse.eddi</groupId>
    <artifactId>quarkus-eddi</artifactId>
    <version>6.0.0</version>
</dependency>

Wie geht es weiter?

Alle FeaturesEntdecken Sie alles, was EDDI bietet MCP ServerAlle 42 MCP-Tools durchsuchen Dokumentation ↗Deep-Dive in Architektur & APIs Warum EDDI?Der Enterprise-Case für EDDI