Übersicht über die Paketverwaltungs-API für Agent und App (Vorschau)

Ein Paket stellt entweder einen Agent oder eine Microsoft 365-App im organization-Katalog dar. Mit der Paketverwaltungs-API können IT-Administratoren Apps und Agents in Microsoft 365 anzeigen und verwalten. Diese API stellt Endpunkte bereit, um alle Apps und Agents aufzulisten und detaillierte Informationen zu einer einzelnen App oder einem einzelnen Agent abzurufen, einschließlich Metadaten und detaillierter Elemente.

Wichtig

Für den Zugriff auf die Paketverwaltungs-API ist eine Microsoft Agent 365 Lizenz erforderlich.

Wichtige Funktionen

  • Rufen Sie ein Inventar aller Agents und Apps innerhalb des organization ab, und filtern Sie optional nach:
    • Host (Copilot, Outlook, Teams)
    • Zeitpunkt der letzten Aktualisierung
    • Im App-Paket enthaltene Elementtypen (Bots, deklarative Agents usw.).
  • Rufen Sie weitere Metadaten für eine bestimmte App oder einen bestimmten Agent ab.
  • Blockieren, Aufheben der Blockierung und erneutes Zuweisen des Besitzes von Paketen.

Beispielszenarien

  • Der Organisationsadministrator ruft den Bestand aller Copilot-Agents und Microsoft 365-Apps ab.
  • Admin überprüft die Paketdetails, einschließlich Verfügbarkeit und Bereitstellung status.
  • Admin überprüft Details des Agent-Elements, einschließlich des deklarativeAgent- oder customEngineAgent-Elementobjekts.
  • Admin blockiert ein Paket, um seine Verwendung im gesamten organization zu verhindern.
  • Admin wird der Paketbesitz neu zugewiesen, wenn ein Mitarbeiter die organization verlässt.

API-Liste

Vorgang HTTP-Methode Beschreibung
Auflisten von Paketen GET /copilot/admin/catalog/packages Rufen Sie alle Apps und Agents im organization ab.
Abrufen von Paketdetails GET /copilot/admin/catalog/packages/{id} Abrufen detaillierter Metadaten für eine bestimmte App oder einen bestimmten Agent.
Updatepaket PATCH /copilot/admin/catalog/packages/{id} Paketmetadaten aktualisieren.
Blockieren POST /copilot/admin/catalog/packages/{id}/block Blockieren Sie ein Paket, um seine Verwendung zu verhindern.
Entsperren POST /copilot/admin/catalog/packages/{id}/unblock Heben Sie die Blockierung eines Pakets auf, um seine Verwendung zuzulassen.
Zuweisen POST /copilot/admin/catalog/packages/{id}/reassign Weisen Sie den Besitz eines Pakets einem anderen Benutzer neu zu.

Ressourcen