microsoft/sessions

Was macht sessions?

Architektur des Agents-Fensters — umfasst die agents-zentrierte App, Schichten, Ordnerstruktur, Chat-Widget, Menüs, Beiträge, Einstiegspunkte und Entwicklungsrichtlinien. Verwenden Sie dies bei der Implementierung von Funktionen oder der Behebung von Fehlern im Agents-Fenster.

Übersicht

Das Agents-Fenster ist der zentrale Ort für Interaktionen mit KI-Agenten. Es besteht aus einer mehrschichtigen Architektur, die Flexibilität und Erweiterbarkeit ermöglicht.

Schichtenarchitektur

1. Basisschicht - Stellt die grundlegende Kommunikationsinfrastruktur bereit.
2. Widget-Schicht - Enthält das Chat-Widget und andere UI-Komponenten.
3. Beitragsschicht - Ermöglicht die Integration von Drittanbieter-Funktionen.
4. Anwendungsschicht - Definiert die agents-zentrierte App-Logik.

Ordnerstruktur

agents-window/
├── app/
│   ├── agents-app.ts
│   └── layers/
├── chat/
│   ├── chat-widget.ts
│   └── menus/
├── contributions/
│   └── entry-points/
└── guidelines/
    └── development.md

Chat-Widget

Das Chat-Widget ist das Herzstück der Interaktion. Es unterstützt:

• Nachrichtenaustausch mit Agenten
• Kontextmenüs für Aktionen
• Anpassbare UI-Elemente

Menüs

Menüs bieten Zugriff auf Agentenfunktionen:

• Agentenauswahl - Wählen Sie den aktiven Agenten.
• Kontextmenüs - Rechtsklick-Optionen für bestimmte Aktionen.
• Beitragsmenüs - Von Erweiterungen bereitgestellte Menüs.

Beiträge und Einstiegspunkte

Entwickler können neue Funktionen über Beiträge und Einstiegspunkte hinzufügen:

• Beiträge - Erweiterungen der UI oder Funktionalität.
• Einstiegspunkte - Definierte Orte, an denen Code ausgeführt werden kann (z. B. beim Start des Agents-Fensters).

Entwicklungsrichtlinien

• Konsistenz - Befolgen Sie die vorhandenen Muster für UI und Logik.
• Erweiterbarkeit - Entwerfen Sie Komponenten so, dass sie leicht geändert oder ersetzt werden können.
• Fehlerbehandlung - Implementieren Sie robuste Fehlerverarbeitung für Agenteninteraktionen.
• Tests - Fügen Sie Tests für neue Beiträge und Einstiegspunkte hinzu.

Unterstützte Plattformen

• VS Code
• Cursor
• Claude Code

Verwendung

1. Bei der Implementierung - Konsultieren Sie dieses Dokument, um die Architektur zu verstehen und Änderungen korrekt zu platzieren.
2. Bei der Fehlerbehebung - Verfolgen Sie Probleme durch die Schichten, um die Ursache zu finden.

Beispiel: Hinzufügen eines neuen Beitrags

import { AgentContribution } from 'microsoft/sessions';

class MyContribution implements AgentContribution {
    onActivate(context: ContributionContext) {
        // Fügen Sie hier benutzerdefinierte Logik hinzu
    }
}

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert.