Referencia de comandos de la CLI create-instance del agente 365

Importante

Debe formar parte del programa de versión preliminar Frontier para obtener acceso early a Microsoft Agent 365. Frontier le conecta directamente con las últimas innovaciones de inteligencia artificial de Microsoft. Las previsualizaciones de Frontier están sujetas a los términos de vista previa existentes en tus acuerdos con clientes. Como estas funciones aún están en desarrollo, su disponibilidad y capacidades pueden cambiar con el tiempo.

Cree la identidad del agente y el usuario del agente y agregue permisos a la identidad y las licencias al usuario. El create-instance comando crea instancias de agente con identidades, licencias y permisos necesarios. Use este comando para configurar instancias de agente completas, incluida la creación de la identidad del agente, la asignación de licencias necesarias y la concesión de permisos a la identidad.

El create-instance comando realiza estas operaciones:

  1. Crear identidad del agente: registra una entidad de servicio de identidad del agente en Microsoft Entra a través del Graph API.
  2. Crea el usuario del agente : crea una cuenta de usuario del agente asociada a la identidad.
  3. Asigna el administrador y el patrocinador : establece el usuario actual como administrador y patrocinador del usuario y la identidad del agente.
  4. Asigna licencias : asigna las licencias necesarias del Agente 365 al usuario del agente.

Rol mínimo necesario: Administrador global

Nota:

Si aún no tiene las licencias del Agente 365 necesarias para asignarlas, puede seguir usando create-instance identity y, a continuación, usar create-instance licenses después para asignar las licencias cuando las tenga.

Syntax

A continuación se muestra la sintaxis del create-instance comando y sus subcomandos opcionales.

a365 create-instance [command] [options]

Cuando se ejecuta create-instance sin un subcomando, ejecuta ambos pasos en secuencia: crea la identidad del agente y el usuario del agente y, a continuación, asigna licencias.

Options

Use estas opciones con el create-instance comando o los create-instance identity subcomandos y create-instance licenses .

Opción Description
-c, --config <config> Ruta de acceso del archivo de configuración (valor predeterminado: a365.config.json)
-v, --verbose Mostrar salida detallada
--dry-run Mostrar lo que se haría sin ejecutar
-?, , -h, --help Mostrar información de ayuda y uso

Prerrequisitos

Antes de ejecutar create-instance, asegúrese de que:

  • Completó el paso de plano técnico del agente de instalación (a365 setup).
  • Publique el agente mediante a365 publish.
  • Tener un valor válido a365.config.json y a365.generated.config.json en el directorio de trabajo.
  • Ha iniciado sesión con una cuenta que tenga permisos de administrador global.

ejemplos de create-instance

Estos ejemplos muestran cómo usar el create-instance comando sin subcomandos.

Creación de una instancia de agente completa

Ejecute create-instance sin opciones para crear una instancia completa del agente mediante la configuración predeterminada.

a365 create-instance

Creación con un archivo de configuración específico

Use la --config opción para especificar una ruta de acceso de archivo de configuración personalizada.

a365 create-instance --config path/to/a365.config.json

Vista previa de los cambios

Use la --dry-run opción para ver lo que create-instance haría sin realizar ningún cambio.

a365 create-instance --dry-run

create-instance identity

Cree la identidad del agente y el usuario del agente, pero no asigne licencias.

Use este comando para omitir las licencias al crear una identidad.

Nota:

Si aún no tiene licencias disponibles, use este comando para que no esté bloqueado. Puede ejecutarse create-instance licenses cuando tenga licencias.

a365 create-instance identity

create-instance licenses

Agregue licencias a un usuario del Agente existente.

Use este comando para crear las licencias cuando la identidad ya exista.

Nota:

Si usó create-instance identity anteriormente, use este comando cuando las licencias estén disponibles.

a365 create-instance licenses

Use estos comandos junto con create-instance para administrar el ciclo de vida completo del agente.

  • Last updated on