Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Пакет представляет агента в каталоге организации. API управления пакетами позволяет ИТ-администраторам просматривать агенты в организации и управлять ими. Этот API предоставляет конечные точки для перечисления всех агентов и получения подробных сведений об отдельном агенте, включая метаданные и подробные элементы.
Важно!
Для доступа к API управления пакетами требуется лицензия Microsoft Agent 365.
Ключевые возможности
- Получите список всех агентов в организации, при необходимости отфильтруйте по:
- Узел (Copilot, Outlook, Teams)
- Платформа (Copilot Studio, Microsoft 365 Copilot Agent Builder)
- Время последнего обновления
- Типы элементов, содержащиеся в пакете агента (боты, декларативные агенты и т. д.).
- Состояние или тип запроса для просмотра агентов, запрошенных пользователями в организации.
- Получение дополнительных метаданных для определенного агента.
- Блокировка, разблокировка и переназначение владельцев пакетов.
Примеры сценариев
- Администратор организации получает инвентаризацию всех агентов.
- Администратор просматривает сведения о пакете, включая доступность и состояние развертывания.
- Администратор проверяет запрошенные пользователями агенты, чтобы они могли просматривать ожидающий запрос.
- Администратор проверяет сведения об элементе агента, включая объект элемента declarativeAgent или customEngineAgent.
- Администратор блокирует пакет, чтобы предотвратить его использование в организации.
- Администратор переназначает владение пакетом, когда сотрудник покидает организацию.
Список API
| Operation | Метод HTTP | Описание |
|---|---|---|
| Вывод списка пакетов | GET /copilot/admin/catalog/packages |
Соберите всех агентов в организации. |
| Получение сведений о пакете | GET /copilot/admin/catalog/packages/{id} |
Получение подробных метаданных для конкретного агента. |
| Пакет обновления (предварительная версия) | PATCH /copilot/admin/catalog/packages/{id} |
Обновление метаданных пакета. |
| Заблокировать (предварительная версия) | POST /copilot/admin/catalog/packages/{id}/block |
Заблокируйте пакет, чтобы предотвратить его использование. |
| Разблокировка (предварительная версия) | POST /copilot/admin/catalog/packages/{id}/unblock |
Разблокируйте пакет, чтобы разрешить его использование. |
| Переназначение (предварительная версия) | POST /copilot/admin/catalog/packages/{id}/reassign |
Переназначение владения пакетом другому пользователю. |
| Запрос агента списка | GET /copilot/admin/catalog/packages |
Получение всех активных запросов агента в организации. |
| Получение сведений о запросе агента | GET /copilot/admin/catalog/packages/{id} |
Получить подробные метаданные для конкретного запроса агента. |