Erste Schritte
Baue deinen ersten Agenten von Grund auf: Modell hinzufügen, Agent erstellen und im Playground testen — in etwa 15 Minuten.
Neuer, noch leerer Workspace? Das ist der schnellste Weg von null zu einem funktionierenden Agenten. In etwa 15 Minuten wirst du ein Modell hinzufügen, einen Agenten erstellen und im Agent-Playground eine echte Antwort erhalten.
Es gibt bereits Agenten in deinem Workspace? Spring zum Schnellstart — dort geht es darum, einen bestehenden Agenten auszuführen, statt einen zu bauen.
Das machst du innerhalb eines Projekts (Team-Workspace). Wenn deine Seitenleiste nur Home und Profil zeigt, öffne zuerst ein Projekt (Teams und Zugriff).
Modell hinzufügen
Ein Agent braucht ein Modell, auf dem er läuft. Modelle werden einmal pro Workspace registriert und dann überall wiederverwendet.
- Öffne in der Workspace-Seitenleiste Models & tools → AI Models und klicke auf Add model.
- Gib ihm einen Namen, den dein Team wiedererkennt (z. B.
gpt-4o-eu). - Wähle einen Anbieter (OpenAI, Azure, Anthropic, Google, AWS, Hugging Face oder Cohere) und trage die Modell-ID des Anbieters ein.
- Wähle eine Authentifizierungsstrategie (API-Key, IAM, Service-Account oder OAuth) und hinterlege die nötigen Zugangsdaten.
- Lass den Modelltyp auf chat, stelle sicher, dass es aktiv ist, und speichere.
- Nutze in der Liste die Zeilenaktion Test model, um die Zugangsdaten zu prüfen.
Tipp: Zugangsdaten werden sicher gespeichert und nie an den Browser zurückgegeben. Schlägt Test model fehl, prüfe die Modell-ID und die Auth-Werte beim Anbieter.
Agent erstellen
Mit einem Modell baust du den Agenten. Der Assistent New agent führt dich Schritt für Schritt durch.
- Öffne in der Seitenleiste Agents → Agents und klicke auf New.
- Identity — vergib einen Namen (Kleinbuchstaben, Zahlen, Bindestriche), optional eine Beschreibung, und wähle Sichtbarkeit und Scope (persönlich vs. Team).
- Model — wähle das gerade hinzugefügte Modell. Du kannst hier auch inline eines anlegen.
- Prompt — wähle einen bestehenden Prompt oder erstelle einen, der dem Agenten sein Verhalten vorgibt.
- Skills — hänge optional Skills an, die der Agent nutzen kann.
- Review — prüfe die Zusammenfassung und klicke Create.
Du hast nun einen versionierten Agenten. Spätere Änderungen erzeugen eine neue Version, sodass du jederzeit vergleichen und zurückrollen kannst (Sichere Rollouts).
Im Playground testen
Der Agent-Playground führt deinen Agenten echt aus — kein Deployment nötig.
- Öffne in der Seitenleiste Agents → Agent Playground.
- Wähle im Panel deinen Agenten, seine Version und eine Umgebung (beginne mit staging, falls dein Workspace eine hat).
- Sende einen echten Prompt — eine Frage, die dein Team wirklich bekommt, nicht „hallo“.
- Lies die Antwort und klappe dann Trace / Timeline auf, um den Modellaufruf, ausgeführte Tools und die Argumentation des Agenten zu sehen.
Ist die Antwort dünn oder falsch, zeigt dir diese Ansicht, was als Nächstes zu korrigieren ist.
Wenn etwas nicht klappt
| Blockade | Wo nachsehen |
|---|---|
| Kein Add model- oder New-Button | Deiner Rolle fehlen ggf. Erstellrechte — frag eine:n Owner (Teams und Zugriff). |
| Test model schlägt fehl | Prüfe die Modell-ID des Anbieters und die Auth-Zugangsdaten. |
| Agentenliste im Chat leer | Schließe zuerst Agent erstellen ab oder bitte um Zugriff. |
| Es erscheinen nie Tools | Der Agent hat keine MCP-Tools angehängt (MCP-Server und Tools). |
Nächste Schritte
- Prompts und Ressourcen — Anweisungen schärfen und Wissen ergänzen.
- MCP-Server und Tools — dem Agenten echte Aktionen geben.
- Testen und Release — vor dem Ausliefern validieren.
- Sichere Rollouts — mit Zuversicht in Produktion bringen.