Seminar Sanity KI-Integration mit Agent Actions, MCP und Dataset Embeddings

Im Mittelpunkt stehen programmatische KI-Aktionen, Werkzeuganbindung, semantische Suche und sichere Betriebsarchitektur. Die Inhalte werden an einem durchgängigen Praxisfall erarbeitet und so strukturiert, dass fachliche Entscheidungen, technische Umsetzung und betriebliche Anforderungen nachvollziehbar zusammenwirken.

Inhaltsübersicht

1. Zielsetzung
2. Zielgruppe
3. Voraussetzungen
4. Seminarinhalte
5. Praxisübungen
6. Qualitätssicherung
7. Methodik

Zielsetzung

Das Seminar entwickelt die erforderlichen Kenntnisse systematisch von der Einordnung bis zur kontrollierten Umsetzung.

• Agent Actions für strukturierte Inhaltsoperationen kontrolliert einsetzen
• MCP-basierte Werkzeuge in Entwicklungs- und Agentenszenarien integrieren
• Embeddings, Berechtigungen und menschliche Kontrollpunkte zu einer sicheren Lösung verbinden

Zielgruppe

KI-, Backend-, Plattform- und Integrationsteams sowie technische Architekturrollen.

Voraussetzungen

Sichere API- und JavaScript- oder TypeScript-Kenntnisse, Verständnis von Sanity-Schemas und Grundlagen generativer KI.

Seminarinhalte

1. KI-Architektur und Risikomodell

Dieser Baustein behandelt die Aufgabe, Datenflüsse, Vertrauensgrenzen, Freigaben und Rückfallwege festlegen. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „Datenflüsse, Vertrauensgrenzen, Freigaben und Rückfallwege festlegen“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „Datenflüsse, Vertrauensgrenzen, Freigaben und Rückfallwege festlegen“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

2. Agent Actions

Dieser Baustein behandelt die Aufgabe, Generierung, Übersetzung und Transformation strukturiert anstoßen und auswerten. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „Generierung, Übersetzung und Transformation strukturiert anstoßen und auswerten“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „Generierung, Übersetzung und Transformation strukturiert anstoßen und auswerten“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

3. Schema- und Promptbezug

Dieser Baustein behandelt die Aufgabe, Feldtypen, Validierungen und fachlichen Kontext in KI-Aufgaben berücksichtigen. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „Feldtypen, Validierungen und fachlichen Kontext in KI-Aufgaben berücksichtigen“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „Feldtypen, Validierungen und fachlichen Kontext in KI-Aufgaben berücksichtigen“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

4. Experimentelle Funktionen absichern

Dieser Baustein behandelt die Aufgabe, Änderbarkeit, Versionierung und begrenzte Einsatzbereiche technisch einplanen. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „Änderbarkeit, Versionierung und begrenzte Einsatzbereiche technisch einplanen“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „Änderbarkeit, Versionierung und begrenzte Einsatzbereiche technisch einplanen“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

5. MCP-Grundlagen

Dieser Baustein behandelt die Aufgabe, Werkzeuge, Ressourcen, Authentifizierung und Clientzugriff voneinander abgrenzen. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „Werkzeuge, Ressourcen, Authentifizierung und Clientzugriff voneinander abgrenzen“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „Werkzeuge, Ressourcen, Authentifizierung und Clientzugriff voneinander abgrenzen“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

6. Sanity-MCP-Workflows

Dieser Baustein behandelt die Aufgabe, Inhaltsrecherche und kontrollierte Inhaltsoperationen aus Agentenumgebungen durchführen. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „Inhaltsrecherche und kontrollierte Inhaltsoperationen aus Agentenumgebungen durchführen“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „Inhaltsrecherche und kontrollierte Inhaltsoperationen aus Agentenumgebungen durchführen“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

7. Sanity Context

Dieser Baustein behandelt die Aufgabe, einen schema-bewussten, schreibgeschützten Kontextzugriff für Agentenanwendungen konfigurieren. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „einen schema-bewussten, schreibgeschützten Kontextzugriff für Agentenanwendungen konfigurieren“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „einen schema-bewussten, schreibgeschützten Kontextzugriff für Agentenanwendungen konfigurieren“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

8. Dataset Embeddings

Dieser Baustein behandelt die Aufgabe, semantische Repräsentationen für Suche, Ähnlichkeit und Retrieval vorbereiten. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „semantische Repräsentationen für Suche, Ähnlichkeit und Retrieval vorbereiten“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „semantische Repräsentationen für Suche, Ähnlichkeit und Retrieval vorbereiten“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

9. Retrieval-gestützte Abläufe

Dieser Baustein behandelt die Aufgabe, Suchergebnisse, Quellkontext und strukturierte Ausgaben miteinander verbinden. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „Suchergebnisse, Quellkontext und strukturierte Ausgaben miteinander verbinden“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „Suchergebnisse, Quellkontext und strukturierte Ausgaben miteinander verbinden“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

10. Berechtigungen und Geheimnisse

Dieser Baustein behandelt die Aufgabe, Tokens, Rollen, Umgebungen und minimale Zugriffsrechte durchgängig absichern. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „Tokens, Rollen, Umgebungen und minimale Zugriffsrechte durchgängig absichern“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „Tokens, Rollen, Umgebungen und minimale Zugriffsrechte durchgängig absichern“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

11. Qualität und Evaluation

Dieser Baustein behandelt die Aufgabe, Testfälle, Referenzantworten und fachliche Prüfmetriken definieren. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „Testfälle, Referenzantworten und fachliche Prüfmetriken definieren“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „Testfälle, Referenzantworten und fachliche Prüfmetriken definieren“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

12. Human-in-the-Loop

Dieser Baustein behandelt die Aufgabe, Entwürfe, Freigaben und reversible Änderungen verbindlich gestalten. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „Entwürfe, Freigaben und reversible Änderungen verbindlich gestalten“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „Entwürfe, Freigaben und reversible Änderungen verbindlich gestalten“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

13. Monitoring und Kostenkontrolle

Dieser Baustein behandelt die Aufgabe, Fehler, Nutzung, Latenz und Ressourcenverbrauch beobachtbar machen. Die Bearbeitung folgt einem kontrollierbaren Vier-Schritte-Verfahren.

1. Schritt 1: Ausgangslage erfassen. Fachliche Ziele, beteiligte Rollen, vorhandene Daten und technische Randbedingungen für „Fehler, Nutzung, Latenz und Ressourcenverbrauch beobachtbar machen“ werden dokumentiert.
2. Schritt 2: Lösung umsetzen. Die erforderliche Konfiguration oder Implementierung für „Fehler, Nutzung, Latenz und Ressourcenverbrauch beobachtbar machen“ wird in nachvollziehbaren Teilschritten aufgebaut.
3. Schritt 3: Verhalten prüfen. Normalfälle, Grenzfälle, Berechtigungen, fehlerhafte Eingaben und Wiederholbarkeit werden anhand definierter Prüffälle kontrolliert.
4. Schritt 4: Betrieb absichern. Entscheidungen, Qualitätskriterien, Verantwortlichkeiten, Wartungshinweise und erforderliche Rückfallmaßnahmen werden festgehalten.

Praxisübungen

1. Eine Agent-Action-Pipeline für strukturierte Übersetzung entwerfen.
2. Einen MCP-Zugriff mit begrenztem Rollenprofil konfigurieren.
3. Eine semantische Suche mit Evaluationsfällen konzipieren.
4. Ein Freigabe- und Rückfallmodell für KI-Änderungen ausarbeiten.

Qualitätssicherung

• Jeder Arbeitsschritt wird mit einem nachvollziehbaren Soll-Ergebnis abgeschlossen.
• Konfigurationen und Implementierungen werden gegen Normal-, Grenz- und Fehlerfälle geprüft.
• Fachliche und technische Entscheidungen werden mit Annahmen und Auswirkungen dokumentiert.
• Die Abschlussprüfung bewertet Vollständigkeit, Wartbarkeit, Sicherheit und betriebliche Eignung.

Methodik

Fachliche Einordnung, Live-Demonstration, angeleitete Umsetzung, eigenständige Übungen, Review und Fehleranalyse wechseln sich ab. Der Praxisfall wächst über die einzelnen Bausteine hinweg zu einer konsistenten Gesamtlösung.