Ein GitHub Copilot Agent Skill ist ein Ordner mit Anweisungen und optionalen Ressourcen. Er gewährt Copilot nicht automatisch Zugriff auf SharePoint, Teams, Planner oder Outlook. Für Datenzugriff braucht es eine separate Anwendung oder einen MCP-Server, der eine unterstützte API aufruft, sich mit Microsoft Entra ID authentifiziert und Ergebnisse nur innerhalb der erteilten Berechtigungen zurückgibt.
Anweisungen und Aktionen trennen
Eine typische Architektur besteht aus dem Copilot-Client, einem explizit bereitgestellten Tool oder MCP-Server, einer Microsoft Graph API und einer geprüften Antwort. Das Skill-Dokument kann erklären, wann das Tool zu verwenden ist und wie Ergebnisse ausgegeben werden. Es ersetzt weder den API-Client noch Authentifizierung, Autorisierung, Zustimmung und Fehlerbehandlung.
Microsoft Graph bietet beispielsweise eine DriveItem-Suche innerhalb einer bestimmten Drive- oder Site-Hierarchie. Die dokumentierte Suchfunktion verwendet einen Endpunkt wie /sites/{site-id}/drive/root/search(q='…'); die Berechtigungen unterscheiden sich für delegierte und Anwendungszugriffe, und dieser Endpunkt unterstützt keine Sites.Selected-Anwendungsberechtigung. Für Teams-Nachrichten und Besprechungstranskripte weist Microsoft eigene, teils administrative Zustimmungen und Anwendungsrichtlinien aus.
Nur den erforderlichen Zugriff freigeben
Starten Sie mit einer einzelnen Site und lesendem Zugriff. Wählen Sie für jeden Endpunkt die dokumentierte Mindestberechtigung; prüfen Sie, ob sie delegiert oder als Anwendung erteilt wird und ob Admin Consent erforderlich ist. Vermeiden Sie breite Sites.Read.All- oder Nachrichtenberechtigungen, wenn die Integration mit engerem Zugriff umgesetzt werden kann. Beschränken Sie Abfragen, Seitenanzahl und angezeigte Felder, und geben Sie keine sensiblen Treffer im Prompt oder in Logs unnötig weiter.
In der eigenen Umgebung testen
Microsoft-Graph-Endpunkte und Berechtigungen unterscheiden sich nach Ressource und nationaler Cloud. Prüfen Sie Endpunkt, SDK-Syntax, Tenant-Consent und Benutzerzugriff mit einem Testkonto. Teams-Transkripte sind nur für unterstützte Meetings und unter dokumentierten Bedingungen verfügbar. Senden Sie keine Meeting- oder Nachrichteninhalte an Copilot, solange Betroffene, Aufbewahrung und Zweck nicht geklärt sind.
Quellen: GitHub: Agent Skills · Microsoft Graph: Dateien suchen · Microsoft Graph: Kanalnachrichten und Berechtigungen · Microsoft Graph: Besprechungstranskripte · Microsoft Graph: Selected-Berechtigungen

