Agenten konfigurieren
Was ist ein Agent?
Ein Agent ist eine konfigurierbare KI-Schnittstelle auf Basis eines oder mehrerer Deployments. Er bietet dir:
- einen stabilen Slug als
model-Feld in API-Anfragen - eine Routing-Strategie — Fixed, Rule-Based oder Workflow
- einen System-Prompt, der jeder Anfrage vorangestellt wird
- optionale Knowledge Bases und MCP Tools
Um einen Agenten zu erstellen, benötigst du mindestens ein laufendes Deployment. Falls noch nicht vorhanden: Dedicated Deployment erstellen.
Agent erstellen
Navigiere in der linken Navigation zu Agents und klicke oben rechts auf New Agent.
Im Erstellungs-Dialog kannst du festlegen:
- Name — einen aussagekräftigen Namen für deinen Agenten
- Beschreibung — optional eine kurze Beschreibung
- Routing-Strategie — die initiale Strategie (kann im Agent jederzeit geändert werden)
Mycelis unterscheidet zwischen drei Routing-Strategien:
| Strategie | Beschreibung |
|---|---|
| Fixed | Ein festes Deployment antwortet auf alle Anfragen |
| Rule-Based | Regeln bestimmen, welches Deployment eine Anfrage erhält |
| Workflow | Visueller Graph-Editor für komplexe Pipelines |
Klicke auf Erstellen, um den Agenten anzulegen und zur Detail-Ansicht zu gelangen.
Tab: Allgemein
Im Tab Allgemein konfigurierst du die Grundeinstellungen:
- Name — den Namen des Agents ändern
- Slug (API Model-ID) — die eindeutige Kennung, die als
model-Feld in API-Anfragen verwendet wird. Besonders wichtig für OpenAI-kompatible Clients wie OpenCode, Cursor und andere - System Prompt — ein systemweiter Instruktionstext, der jeder Anfrage vorangestellt wird
Tab: Modelle & Routing
Hier konfigurierst du die Routing-Strategie oder wechselst sie.
Routing-Strategie: Fixed
Jede Anfrage wird an ein einziges, fest konfiguriertes Deployment weitergeleitet.
- Wähle Fixed als Strategie
- Wähle das Ziel-Deployment aus der Dropdown-Liste
- Klicke auf Speichern
Nach dem Speichern erscheinen zwei zusätzliche Tabs: Knowledge & Tools und Settings.
Routing-Strategie: Rule-Based
Regeln bestimmen, welches Deployment eine Anfrage erhält — basierend auf Bedingungen wie erkannter Absicht, Anfrageinhalt oder technischen Eigenschaften.
Klicke auf Neue Regel, um eine Regel zu erstellen. Jede Regel besteht aus einer oder mehreren Conditions und einem Ziel-Deployment.
Condition: Auto Intent
Mycelis erkennt automatisch die Absicht einer Anfrage. Verfügbare Intentionen:
- Coding, Debugging, Code Review, Architektur, Erklärung, Dokumentation
- Creative Writing, Datenanalyse, Mathematik, Übersetzung, DevOps, Agentic, Langer Kontext
Condition: Text / Query
- Contains — Anfrage enthält einen bestimmten Begriff oder Satz
- Regex — Anfrage entspricht einem regulären Ausdruck
Condition: Request Info
- Has Tools — Anfrage enthält Tool-Definitionen
- Tokens > N / Tokens < N — Token-Schwellenwert
- Client Type Is — Cursor, GitHub Copilot, Continue, OpenCode, Generisch
- MCP Tool Available — ein bestimmtes MCP-Tool ist in der Anfrage verfügbar
- Knowledge Base ID — eine bestimmte Knowledge Base ist aktiv
Füge eine Default-Regel (Fallback) hinzu, um sicherzustellen, dass jede Anfrage beantwortet wird.
Routing-Strategie: Workflow
Der Workflow-Editor ist ein visueller Graph-Editor für komplexe Routing-Pipelines. Knowledge Bases und Tools werden direkt im Editor konfiguriert.
Starte mit einer der verfügbaren Vorlagen oder beginne mit einem leeren Canvas.
Verfügbare Node-Typen:
| Node | Beschreibung |
|---|---|
| Start | Einstiegspunkt — jede Pipeline beginnt hier |
| Raw Model | Leitet die Anfrage direkt an ein Deployment weiter |
| Agent | Leitet die Anfrage an einen anderen Agenten weiter |
| If / Else | Verzweigungsknoten mit konfigurierbaren Zweigen |
| Knowledge Base | Bindet eine einzelne Knowledge Base als Kontext ein |
| All KBs | Bindet alle Knowledge Bases des Workspaces ein |
| MCP Tool | Ruft ein einzelnes MCP-Tool auf |
| MCP Server | Bindet einen kompletten MCP-Server ein |
| MCP Hub | Stellt alle aktivierten MCP-Tools zur Verfügung |
| Semantic Cache | Cacht semantisch ähnliche Anfragen |
| Smart Router | Intelligentes Routing basierend auf Anfrageeigenschaften |
Verbinde die Nodes, um den Datenfluss abzubilden, und klicke auf Speichern.
Tab: Knowledge & Tools
Verfügbar für Fixed- und Rule-Based-Agenten. Im Workflow-Modus werden Knowledge Bases und Tools direkt im Editor konfiguriert.
MCP Tools
Einzelne MCP-Server oder gezielt einzelne Tools innerhalb eines Servers hinzufügen.
Noch keine MCP-Tools aktiviert? Richte sie zunächst im MCP Hub ein.
Knowledge Bases
Eine oder mehrere Knowledge Bases hinzufügen. Bei jeder Anfrage sucht der Agent automatisch nach relevanten Dokumentenstellen und fügt sie als Kontext ein.
Noch keine Knowledge Base erstellt? Hier erfährst du, wie du eine RAG-Pipeline aufsetzen kannst.
API-Aufruf
Verwende den Slug des Agents als model-Feld:
curl https://app.mycelis.ai/api/proxy/v1/chat/completions \
-H "Authorization: Bearer pat_..." \
-H "Content-Type: application/json" \
-d '{
"model": "dein-agent-slug",
"messages": [{"role": "user", "content": "Hallo!"}]
}'
Nächste Schritte
- RAG-Pipeline aufsetzen — Dokumente als Wissensquelle anbinden
- MCP Tools — Externe APIs direkt im Modellkontext nutzen
- API-Referenz — Alle verfügbaren API-Parameter