Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ein Paket repräsentiert einen Agenten im Katalog der organization. Mit der Paketverwaltungs-API können IT-Administratoren Agents in Ihrer gesamten organization anzeigen und verwalten. Diese API bietet Endpunkte, um alle Agents aufzulisten und detaillierte Informationen zu 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
- Abrufen eines Bestands aller Agents in der organization und optionales Filtern nach:
- Host (Copilot, Outlook, Teams)
- Plattform (Copilot Studio, Microsoft 365 Copilot Agent Builder)
- Uhrzeit der letzten Aktualisierung
- Elementtypen, die im Agentpaket enthalten sind (Bots, deklarative Agents und mehr).
- Anforderungsstatus oder Anforderungstyp, um die von den Benutzern in der organization angeforderten Agents zu überprüfen.
- Abrufen weiterer Metadaten für einen bestimmten Agent
- Blockieren, Entsperren und erneutes Zuweisen des Besitzes von Paketen.
Beispielszenarien
- Der Organisationsadministrator ruft den Bestand aller Agents ab.
- Der Admin überprüft die Paketdetails, einschließlich Verfügbarkeit und Status der Bereitstellung.
- Der Admin überprüft die Agents, die von Benutzern angefordert wurden, damit sie ausstehende Anforderungen selektieren können.
- Der Admin überprüft die Details des Agent-Elements, einschließlich des DeclarativeAgent- oder customEngineAgent-Elementobjekts.
- Der Admin blockiert ein Paket, um seine Verwendung in der gesamten organization zu verhindern.
- Der Admin weist den Paketbesitz neu zu, wenn ein Mitarbeiter die organization verlässt.
API-Liste
| Vorgang | HTTP-Methode | Beschreibung |
|---|---|---|
| Auflisten von Paketen | GET /copilot/admin/catalog/packages |
Rufen Sie alle Agents in der organization ab. |
| Abrufen von Paketdetails | GET /copilot/admin/catalog/packages/{id} |
Abrufen detaillierter Metadaten für einen bestimmten Agent. |
| Updatepaket (Vorschau) | PATCH /copilot/admin/catalog/packages/{id} |
Aktualisieren Sie die Paketmetadaten. |
| Blockieren (Vorschau) | POST /copilot/admin/catalog/packages/{id}/block |
Blockieren eines Pakets, um seine Verwendung zu verhindern. |
| Blockierung aufheben (Vorschau) | POST /copilot/admin/catalog/packages/{id}/unblock |
Heben Sie die Blockierung eines Pakets auf, um seine Verwendung zuzulassen. |
| Neu zuweisen (Vorschau) | POST /copilot/admin/catalog/packages/{id}/reassign |
Weisen Sie den Besitz eines Pakets einem anderen Benutzer neu zu. |
| Auflisten von Agentanforderungen | GET /copilot/admin/catalog/packages |
Abrufen aller aktiven Agent-Anforderungen in der organization. |
| Abrufen von Details zur Agent-Anforderung | GET /copilot/admin/catalog/packages/{id} |
Abrufen detaillierter Metadaten für eine bestimmte Agent-Anfrage. |