Agent-Registrierung Schritt für Schritt
Durch den Sieben-Schritt-Wizard navigieren — Identität, AI-Assist, Governance, Multi-Framework-Screening, Übergabe.
Der Agent-Registrierungs-Wizard ist das Werkzeug der Wahl des Compliance Officers. Eine Seite, sieben Abschnitte, die sich Ihrem Plan anpassen — von 2 Abschnitten in Community (~30 Sekunden) bis alle 7 in Enterprise (~5-10 Minuten).
Rollen-Trennung — Die Registrierung erfasst nur Governance-Daten. Die technische Integration (SDK-/Gateway-Verkabelung) ist Sache des Developers, erledigt im Integration-Tab nach der Registrierung. Siehe Rollen & Berechtigungen.
Wizard starten
- Navigieren Sie zu Agent Registry in der Sidebar.
- Klicken Sie Neuer Agent (oben rechts).
- Die Registrierungsseite öffnet sich — Settings-ähnliches Layout mit Erklärungen links und Eingaben rechts.
Alternativ: Wählen Sie ein Template aus der Galerie, um mit sinnvollen Defaults zu starten (Customer Support, HR Screening, Code Assistant etc.).
Abschnitt 1 — Identität & Templates (alle Pläne)
| Feld | Erforderlich | Beschreibung |
|---|---|---|
| Agent-Name | ✅ | Eindeutiger, menschenlesbarer Name (max. 64 Zeichen). Erscheint in Audit-Logs und Compliance-Berichten. |
| Beschreibung | ✅ | Was tut dieser Agent? Welche Daten verarbeitet er? Auditoren lesen das wörtlich. |
| Intended Purpose | — | Freitext — wofür der Agent vorgesehen ist. Treibt den Risikoklassifizierungs-Schritt. |
Templates: Ein Template ausgewählt füllt Beschreibung, Datenschutzprofil und andere Defaults automatisch aus. Sie können danach alles anpassen.
Abschnitt 2 — AI-Assist (Pro+)
Der Wizard enthält einen AI-Assist-Schritt, der mühsame Governance-Felder basierend auf Agent-Name und -Beschreibung befüllt.
- Klicken Sie den ✨ Sparkles-Button neben Beschreibung, um eine Beschreibung aus dem Agent-Namen zu generieren.
- Klicken Sie ✨ Diesen Abschnitt mit AI-Assist befüllen unten in jedem Abschnitt, um Felder vorzubefüllen, in denen die KI sich sicher ist — Purpose-Statement, vorgeschlagene Risikostufe, vorgeschlagene Datenschutzstufe.
Die KI-Vorschläge sind nur Hilfestellung — jedes Feld ist editierbar, nichts wird gespeichert, bis Sie Agent registrieren klicken. Der AI-Assist-Endpoint ist derselbe, der den NL-Policy-Builder antreibt.
Abschnitt 3 — Schutzprofil / Datenschutz
Community
Wählen Sie ein Schutzprofil aus drei Karten:
| Profil | Beschreibung |
|---|---|
| Maximaler Schutz | Alle Checks an, Flare-Attestation empfohlen |
| Ausgewogen | Standard-Checks, Flare optional |
| Leichtgewicht | Nur grundlegende Checks — nur interne Agenten |
Pro und höher
Drei Datenschutz-Stufen ersetzen das Profil:
| Stufe | Was passiert | Empfohlen für |
|---|---|---|
| Maximaler Schutz | Alle PII vor dem LLM redigiert; der Provider sieht nie echte Daten | Code-Assistenten, interne Analytik |
| Pseudonymisiert | PII durch Pseudonyme ersetzt, in Antworten wiederhergestellt | Kundenservice, HR-Screening |
| Nur loggen | PII geht zum LLM durch; jeder Datenfluss wird erfasst | Interne Agenten mit AVV |
Projekt-Defaults — Wenn Ihr Admin unter Einstellungen → Agent-Defaults eine Standard-Datenschutz-Stufe gesetzt hat, ist sie vorausgewählt. Sie können eine restriktivere Stufe wählen; weniger restriktive Optionen sind gesperrt.
Abschnitt 4 — Verantwortungskette (Business+)
Drei verantwortliche Personen pro Agent:
| Rolle | Erforderlich bei | Beschreibung |
|---|---|---|
| Verantwortliche Person | HOCH-Risiko | Verantwortlich gegenüber Behörden für das Verhalten des Agenten |
| Technischer Betreuer | Immer | Wartet den Agenten technisch; erster Kontakt bei Vorfällen |
| Genehmigungsbefugte | HOCH-Risiko | Genehmigt gequeuete Anfragen für diesen Agenten |
Dropdowns zeigen jedes Team-Mitglied mit editor oder höher. Bei HOCH-Risiko sind alle drei Felder Pflicht.
Abschnitt 5 — Provider- / Deployer-Rolle (Business+, nur EU)
Der EU AI Act unterscheidet Anbieter (Provider) (die das KI-System entwickeln / vermarkten) und Betreiber (Deployer) (die es in ihrer Organisation einsetzen). Unterschiedliche Pflichten greifen für jeden.
| Rolle | Beispiele | Wichtigste Pflichten |
|---|---|---|
| Provider | Sie haben einen eigenen Agent auf GPT-4 gebaut und nutzen ihn intern | Art. 16 — Risikomanagement, technische Dokumentation, Post-Market-Monitoring |
| Deployer | Sie nutzen ein Drittanbieter-CRM mit eingebauten KI-Features | Art. 26 — menschliche Aufsicht, Transparenz gegenüber Betroffenen, FRIA bei HOCH-Risiko |
| Beides | Sie bauen Agenten und betreiben sie auch | Alles oben |
Der Wizard wählt für Templates, die externe APIs nutzen (OpenAI, Anthropic, Google) Deployer vor, und Provider für Templates, die eigene Modelle umhüllen. Bei Bedarf übersteuern — Ihr Rechtsteam sollte bei HOCH-Risiko-Agenten beraten.
Abschnitt 6 — Risikoklassifizierung (Business+, nur EU)
Wählen Sie die Risikostufe aus vier Karten:
| Stufe | Beschreibung | EU AI Act |
|---|---|---|
| Minimal | Kein regulatorisches Risiko | Keine besonderen Pflichten |
| Limitiert | Transparenzpflichten | Art. 50 Kennzeichnung |
| Hoch | Strenge Compliance | Art. 6, Annex III, FRIA erforderlich |
| Inakzeptabel | Verbotene Anwendung | Art. 5 — Registrierung blockiert |
Bei HOCH: Wählen Sie eine der 8 Annex-III-Domänen (Biometrie, Kritische Infrastruktur, Bildung, Beschäftigung, Öffentliche Dienste, Strafverfolgung, Migration, Justiz). Menschliche Aufsicht wird automatisch aktiviert und kann nicht deaktiviert werden.
Abschnitt 7 — Compliance-Screening (Enterprise, EU + Multi-Framework)
Der Screening-Abschnitt prüft den Agent gegen mehrere regulatorische Frameworks. Sie beantworten eine kleine Anzahl von Ja/Nein-Fragen pro Framework; der Wizard zeigt, welche Pflichten ausgelöst werden.
EU AI Act Art. 5 (verbotene Praktiken)
- Nutzt der Agent Social Scoring oder bewertet Personen anhand ihres sozialen Verhaltens?
- Nutzt der Agent unterschwellige Manipulation, um Entscheidungen zu beeinflussen?
- Nutzt der Agent biometrische Echtzeit-Identifikation in öffentlich zugänglichen Räumen?
- Nutzt der Agent Emotionserkennung am Arbeitsplatz oder in Bildungseinrichtungen?
Ein Ja → Registrierung blockiert. Der Wizard zeigt den konkreten Art.-5-Absatz und empfiehlt, die Rechtsabteilung zu konsultieren.
EU AI Act Art. 6 / Annex III (Hoch-Risiko-Klassifizierung)
Der Wizard geht die 8 Annex-III-Domänen durch und stellt gezielte Ja/Nein-Fragen pro Domäne. Ein Ja in einer Domäne klassifiziert den Agent automatisch als HOCH-Risiko (überschreibt Abschnitt 6 bei Bedarf) und schaltet den FRIA-Workflow frei.
Colorado AI Act (USA — wenn anwendbar)
Aktiv, wenn die Provider-/Deployer-Rolle US-Betrieb anzeigt. Fünf Ja/Nein-Fragen zu:
- Konsumentennahe konsequenzhafte Entscheidungen
- Personalisierte Preisgestaltung oder Berechtigung
- Algorithmisches Diskriminierungsrisiko
- Impact-Assessment-Pflichten
Ein Ja triggert Colorado-AI-Act-Controls — Algorithmic-Impact-Assessment-Workflow, Offenlegungspflichten und Erinnerungen zum zweijährlichen Bias-Audit.
Singapore PDPA (APAC — wenn anwendbar)
Aktiv, wenn die Deployment-Jurisdiktion Singapur einschließt. Deckt KI-spezifische PDPA-Pflichten ab: Erklärbarkeits-Anforderungen, Opt-out-Mechanismen und DPO-Attestation-Pflichten.
Ergebnis
Das Screening-Ergebnis landet als screening_result-JSONB-Feld auf dem Agent-Record:
{
"eu_ai_act": { "risk_level": "HIGH", "annex_iii_domain": "employment", "fria_required": true },
"colorado_ai": { "applies": true, "biennial_audit_due": "2027-12-01" },
"pdpa_sg": { "applies": false }
}Das Compliance-Dashboard liest aus diesem Feld, um die Readiness-Scores pro Framework zu berechnen.
Abschnitt 8 — Erfolg & Developer-Übergabe
Nach erfolgreicher Registrierung:
- Agent-API-Key — auf dem Integration-Tab sichtbar mit
freshKey-Banner bei Erst-Registrierung. - Setup-Anleitung — Framework-spezifische Integration-Guides (LangChain, CrewAI, OpenAI Agents etc.).
- Test-Command — ein copy-paste curl zum Verifizieren der Connectivity.
Öffnen Sie das Agent-Detail und teilen Sie die Setup-Anleitungs-URL mit dem Developer.
Tier-Matrix
| Abschnitt | Community | Pro | Business | Enterprise |
|---|---|---|---|---|
| Identität & Templates | ✅ | ✅ | ✅ | ✅ |
| AI-Assist | — | ✅ | ✅ | ✅ |
| Schutzprofil / Datenschutz | ✅ | ✅ | ✅ | ✅ |
| Verantwortungskette | — | — | ✅ | ✅ |
| Provider- / Deployer-Rolle | — | — | ✅ | ✅ |
| Risikoklassifizierung | — | — | ✅ | ✅ |
| Compliance-Screening | — | — | — | ✅ |
| Erfolg & Übergabe | ✅ | ✅ | ✅ | ✅ |
Drei Ebenen von Defaults
Der Wizard zieht aus drei Quellen, niedrig schlägt hoch:
- Projekt-Defaults — Admin konfiguriert einmal unter Einstellungen → Agent-Defaults.
- Template-Defaults — Template übersteuert Projekt-Defaults für die Felder, die das Template besitzt.
- Pro-Agent-Anpassung — Nutzer übersteuert den Rest.
Der fünfte Agent sollte nur einen Namen und eine Beschreibung brauchen — alles andere kommt aus Defaults.
Importierte Agenten (Cross-Platform)
Agenten, die über Cross-Platform Import (Azure AI Foundry oder Google Vertex AI) importiert wurden, kommen mit vorausgefüllten Identitäts-Feldern (Name, Modell, Tools, Instructions). Die Governance-Abschnitte müssen trotzdem ausgefüllt werden — Agent-Detail öffnen und Wizard von dort fahren.