Compartir a través de

Publicar el agente en el centro de administración de Microsoft

Importante

Debe formar parte del programa de versión preliminar Frontier para obtener acceso anticipado a Microsoft Agent 365. Frontier le conecta directamente con las innovaciones de inteligencia artificial más recientes de Microsoft. Las versiones preliminares de Frontier están sujetas a los términos de vista previa existentes en tus acuerdos con clientes. Dado que estas características siguen en desarrollo, su disponibilidad y funcionalidades pueden cambiar con el tiempo.

Use el a365 publish comando para empaquetar el agente y, a continuación, cargue el paquete en el Centro de administración de Microsoft 365. Después de la publicación, puede crear instancias de agente dentro de la organización y controlar el agente.

Prerrequisitos

Antes de empezar, asegúrate de tener los siguientes elementos.

Cuentas y permisos requeridos

  • Inquilino de Microsoft 365 con uno de los siguientes roles (necesario para el paso de carga del Centro de administración):

    • Administrador global
    • Administrador de ID de Agente

Herramientas necesarias

Pasos de instalación obligatorios

Antes de publicar, complete estos pasos:

  1. Crea el plano del agente - Sigue el paso de configuración para crear el plano del agente.
  2. Agente de prueba localmente : compruebe que el agente funciona correctamente mediante el área de juegos de agentes (consulte Agentes de prueba localmente).
  3. Preparar archivos de configuración : asegúrese a365.config.json de que y a365.generated.config.json estén actualizados.

Comando de publicación

Ejecuta el a365 publish comando:

a365 publish

Nota:

La ejecución a365 publish -h muestra todas las opciones que admite este comando.

Lo que hace este comando:

  1. Actualizar manifiesto - actualiza manifest.json con el identificador de blueprint del agente
  2. Crear paquete : paquetes manifest.json e iconos en manifest.zip
  3. Instrucciones de impresión : muestra instrucciones paso a paso para cargar a través del Centro de administración de Microsoft 365

Subir al centro de administración

Una vez finalizado el a365 publish, siga las instrucciones impresas para cargar el agente.

  1. Vaya al Centro de administración de Microsoft 365.
  2. Vaya a Agentes>Todos los agentes.
  3. Seleccione Cargar agente personalizado.
  4. Cargue el manifest.zip archivo desde la manifest carpeta del proyecto.

Para obtener más información, consulte Carga de agentes en el Centro de administración de Microsoft 365.

Verificar el éxito de la publicación

Utiliza la siguiente lista de comprobación para verificar que tu agente haya publicado correctamente:

✅ Publicación de CLI exitosa
✅ manifest carpeta creada con manifest.json y manifest.zip
✅ El agente aparece en el Centro de administración de Microsoft

Salida de la línea de comandos (CLI)

Verá estos mensajes de salida cuando el comando publish se realiza correctamente:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ Instrucciones de carga paso a paso impresas

Si se produce un error en el comando, revise los mensajes de error y asegúrese de completar la configuración del plano técnico.

Posibles errores:

Error Paso para resolver el problema
Agent blueprint ID not found Ejecute a365 setup para completar la configuración del plano técnico.
Permissions missing Reejecuta la configuración con el a365 setup permissions comando.

Sigue estos pasos cuando la publicación fracase.

Archivos de manifiesto

Puede probar los siguientes archivos en la manifest carpeta mediante el comando de PowerShell Test-Path .

# Check manifest folder and contents exists
Test-Path <deploymentProjectPath>/manifest/
Test-Path <deploymentProjectPath>/manifest/manifest.json
Test-Path <deploymentProjectPath>/manifest/manifest.zip
# All should return: True

Nota:

Si no ves estos archivos, prueba a ejecutar ela365 publish comando de nuevo.

El agente aparece en el centro administrativo

Nota:

Después de cargarlo, el agente puede tardar entre 5 y 10 minutos en aparecer en el centro de administración y Teams. Este retraso es normal.

Confirme que el agente está presente mediante estos pasos:

  1. Vaya a Microsoft 365 centro de administración.
  2. Vaya a Agentes>Todos los Agentes.
  3. Tu agente aparece en la lista.

La siguiente tabla muestra qué detalles puedes encontrar:

Campo Qué comprobar
Nombre Nombre del agente (de manifest.json)
Versión Número de versión (por ejemplo, 1.0.0)
Publisher Nombre de tu organización
Availability Disponible/Todos los usuarios

Consulte también

Pasos siguientes

Después de publicar tu agente, crea una instancia para poder configurarla y usarla en tu inquilino.

Crear una instancia de agente

Solución de problemas

Problemas comunes al publicar agentes en el Centro de administración de Microsoft 365.

Sugerencia

La Guía de Resolución de Problemas del Agente 365 contiene recomendaciones de alto nivel para la solución de problemas, mejores prácticas y enlaces a contenido de solución de problemas para cada parte del ciclo de vida del desarrollo del Agente 365.

Falla el comando de publicación

Síntomas:

  • Error durante a365 publish
  • manifest.zip no está creado

Causas principales:

  • La preparación no está completa
  • Errores de validación de manifiestos
  • Permisos insuficientes

Solution:

  1. Verifica que la configuración esté completa.

    a365 config display -g
# Check for: agentBlueprintId

  2. Ejecuta el comando de publicar y sigue las indicaciones.

Error al cargar en el centro de administración

Síntomas:

  • Error al cargar manifest.zip en el Centro de administración de Microsoft 365
  • El agente no aparece después de la carga

Causas principales:

  • Permisos insuficientes en el Centro de administración
  • No válido o obsoleto manifest.zip

Solution:

  1. Asegúrese de que tiene el rol Administrador global o Administrador de id. de agente.
  2. Vuelva a ejecutar a365 publish para generar un nuevo manifest.zip.
  3. Intente cargar de nuevo siguiendo los pasos de carga.

Para obtener más ayuda, consulte Carga de agentes en el Centro de administración de Microsoft 365.

  • Last updated on