Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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.
Entidad que representa un paquete de Copilot disponible en un inquilino, que contiene metadatos básicos e información de configuración para la administración de paquetes.
Importante
El acceso a la API de administración de paquetes requiere una licencia de Microsoft Agent 365.
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
agentIdentityId |
Cadena | Identificador de la identidad del agente de Microsoft Entra asociada al paquete Copilot. Solo lectura. |
appId |
Cadena | Identificador de registro de la aplicación de Microsoft Entra AD asociado para este paquete. |
assetId |
Cadena | Identificador usado para hacer referencia a este paquete en el almacén de activos. |
availableTo |
packageAllowStatus | Valor de enumeración que especifica qué usuarios o grupos del inquilino pueden acceder a este paquete (allowedForAll, allowedForSome, allowedForNone). |
createdDateTime |
DateTimeOffset | La fecha y hora en que se creó el paquete de agente. |
deployedTo |
packageAcquireStatus | Valor enumerado que indica el ámbito de implementación actual del paquete dentro del inquilino (acquiredForAll, acquiredForSome, acquiredForNone). |
displayName |
Cadena | Nombre del paquete legible para el usuario que se muestra a los usuarios y administradores. |
elementTypes |
Colección string | Colección de tipos de elementos contenidos en este paquete (por ejemplo, bot, declarativeAgent). |
governanceMetadata |
Cadena | La clasificación agéntica del agente. Los valores posibles son: PromptAgent, HostedAgent, WorkflowAgent, ManagedAgentUnmanaged, y AIApp. |
id |
Cadena | Identificador único para el paquete Copilot dentro del inquilino. |
isBlocked |
Booleano | Marca booleana que indica si el paquete está bloqueado administrativamente para su uso dentro del inquilino. |
lastModifiedDateTime |
DateTimeOffset | Marca de tiempo de la última modificación realizada en la configuración del paquete o metadatos. |
manifestId |
Cadena | Identificador único declarado en el manifiesto del paquete. No se puede actualizar después de la creación. |
manifestVersion |
Cadena | Versión del esquema de manifiesto usado para definir este paquete. No se puede actualizar después de la creación. |
platform |
Cadena | La plataforma host a la que se dirige este paquete (por ejemplo, teams, , outlookweb). Admite $filter con eq. |
publisher |
Cadena | Nombre de la organización o entidad que publicó este paquete. |
requestStatus |
copilotPackageRequestStatus | Admite valores NULL. Estado de la solicitud asociada con este paquete. Compatible $filter con eqlos paquetes on List. |
requestType |
copilotPackageRequestType | Admite valores NULL. Tipo de solicitud asociada con este paquete. Compatible $filter con eqlos paquetes on List. |
shortDescription |
Cadena | Breve descripción que proporciona información general sobre la funcionalidad y el propósito del paquete. |
supportedHosts |
Colección string | Colección de aplicaciones host en las que se puede usar este paquete (por ejemplo, teams, outlook, sharePoint). |
type |
packageType | La clasificación de tipo del paquete, que indica si es propio, de terceros, compartido o LOB. |
version |
Cadena | Cadena de versión del paquete (por ejemplo, 1.2.3). No se puede actualizar después de la creación. |
zipFile |
Stream | El archivo de paquete Copilot. |
enumeración copilotPackageRequestStatus
| Valor | Description |
|---|---|
pending |
La solicitud está abierta y esperando que un administrador actúe en consecuencia. |
approved |
Un administrador aprobó la solicitud. |
rejected |
Un administrador rechazó la solicitud. |
unknownFutureValue |
Valor centinela evolutivo. |
Enumeración copilotPackageRequestType
| Valor | Description |
|---|---|
publish |
Un usuario solicitó que se publicara un nuevo paquete en el catálogo de la organización. |
activate |
Un usuario ha solicitado que se active para su uso un paquete presente en el catálogo. |
access |
Un usuario pidió que se le concediera acceso a un paquete que ya está activo en la organización. |
update |
Un usuario solicitó que un paquete ya publicado se actualizara a una versión más reciente. |
unknownFutureValue |
Valor centinela evolutivo. |
Enumeración packageAllowStatus
| Valor | Description |
|---|---|
allowedForNone |
No está disponible para ningún usuario. |
allowedForSome |
Disponible para algunos usuarios o grupos. |
allowedForAll |
Disponible para todos los usuarios. |
unknownFutureValue |
Valor centinela evolutivo. |
packageAcquireStatus enumeración
| Valor | Description |
|---|---|
acquiredForNone |
No implementado para ningún usuario. |
acquiredForSome |
Implementado en algunos usuarios o grupos. |
acquiredForAll |
Implementado para todos los usuarios. |
unknownFutureValue |
Valor centinela evolutivo. |
packageType enumeración
| Valor | Description |
|---|---|
microsoft |
Creado por Microsoft. |
external |
Creado por asociados. |
shared |
Compartidos en su organización. |
custom |
Creado por su organización. |
unknownFutureValue |
Valor centinela evolutivo. |
Relaciones
Ninguna.
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@odata.type": "#microsoft.graph.copilotPackage",
"agentIdentityId": "String",
"appId": "String",
"assetId": "String",
"availableTo": "String",
"createdDateTime": "DateTimeOffset",
"deployedTo": "String",
"displayName": "String",
"elementTypes": ["String"],
"governanceMetadata": "String",
"id": "String",
"isBlocked": "Boolean",
"lastModifiedDateTime": "DateTimeOffset",
"manifestId": "String",
"manifestVersion": "String",
"platform": "String",
"publisher": "String",
"requestStatus": "String",
"requestType": "String",
"shortDescription": "String",
"supportedHosts": ["String"],
"type": "String",
"version": "String",
"zipFile": "Stream"
}