Obtener los detalles del paquete copilot

Importante

Las API de la /beta versión están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción.

Recupera información detallada de un agente o aplicación específico por identificador.

Importante

El acceso a la API de administración de paquetes requiere la inscripción en el programa Frontier. Para obtener más información sobre el programa Frontier, consulte Exploración del acceso anticipado de IA en Microsoft 365.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) CopilotPackages.Read.All CopilotPackages.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación No admitida. No admitida.

Solicitud HTTP

GET https://graph.microsoft.com/beta/copilot/admin/catalog/packages/{id}

Encabezados de solicitud

Nombre Descripción
Authorization Bearer {token}. Obligatorio. Obtenga más información sobre la autenticación y la autorización.

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto copilotPackageDetail en el cuerpo de la respuesta.

Ejemplo

Solicitud

En el ejemplo siguiente se muestra la solicitud.

GET https://graph.microsoft.com/beta/copilot/admin/catalog/packages/abc

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://graph.microsoft.com/beta/$metadata#copilot/admin/catalog/packages/$entity",
  "id": "P_19ae1zz1-56bc-505a-3d42-156df75a4xxy",
  "displayName": "Contoso Sales Agent",
  "type": "custom",
  "shortDescription": "Short description for package abc",
  "isBlocked": false,
  "supportedHosts": ["teams", "outlook", "sharePoint"],
  "lastModifiedDateTime": "2025-10-06T00:07:20.146Z",
  "publisher": "Contoso",
  "availableTo": "all",
  "deployedTo": "some",
  "elementTypes": ["declarativeAgent"],
  "platform": "teams",
  "version": "1.2.3",
  "manifestVersion": "2.0",
  "manifestId": "contoso-sales-agent",
  "appId": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "assetId": "asset-00042",
  "longDescription": "This is a detailed description for package abc. It provides comprehensive information about the package functionality, features, and usage scenarios.",
  "categories": [
    "Development",
    "Productivity",
    "Tools"
  ],
  "sensitivity": "general",
  "allowedUsersAndGroups": [
    {
      "resourceId": "user-123",
      "resourceType": "user"
    },
    {
      "resourceId": "group-456",
      "resourceType": "group"
    }
  ],
  "acquireUsersAndGroups": [],
  "elementDetails": [
    {
      "elementType": "bot",
      "elements": [
        {
          "id": "bot-001",
          "definition": "{\"botId\":\"303e399a-cecc-4511-ad38-82970baa288b\",\"scopes\":[\"personal\"],\"isNotificationOnly\":true,\"supportsCalling\":false,\"supportsVideo\":false,\"supportsFiles\":false}"
        }
      ]
    },
    {
      "elementType": "declarativeAgent",
      "elements": [
        {
          "id": "dcp-001",
          "definition": "{\"id\":\"dcp-001\",\"version\":\"v2.1\",\"name\":\"Contoso Sales Agent\"}"
        }
      ]
    }
  ]
}
  • Last updated on