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

Utilice el comando a365 publish para empaquetar su agente y luego cargar el paquete en el Centro de administración de Microsoft 365. Una vez publicado, puede crear instancias de agentes dentro de su organización y administrar el agente.

Requisitos previos

Antes de empezar, asegúrese de que tenga 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

Herramientas necesarias

Pasos de instalación obligatorios

Antes de publicar, complete estos pasos:

  1. Cree el plano técnico del agente: siga el paso de configuración para crear el plano técnico del agente.
  2. Probar agente localmente: compruebe que el agente funciona correctamente con el Área de juegos de agentes (consulte Probar agentes localmente).
  3. Preparar archivos de configuración: asegúrese de que a365.config.json y a365.generated.config.json estén actualizados.

Comando Publicar

Ejecute el comando a365 publish:

a365 publish

Nota

Al ejecutar a365 publish -h, se muestran todas las opciones que admite este comando.

Qué significa este comando

  1. Actualizar el manifiesto: actualizaciones manifest.json con su Id. de plano de 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.

Nota

El comando a365 publish funciona tanto para agentes como para compañeros de equipo con IA. Para los agentes aprovisionados mediante --agent-name (config-free), asegúrese de que a365.generated.config.json exista en su directorio de trabajo antes de ejecutar a365 publish, ya que el comando lee el id. del plano técnico desde este archivo.

Cargar al Centro de administración

Cuando finalice 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 archivo manifest.zip desde la carpeta manifest de su proyecto.

Para obtener más información, consulte Cargar agentes al Centro de administración de Microsoft 365.

Comprobar que la publicación fue correcta

Utilice la siguiente lista de verificación para comprobar que su agente se haya publicado correctamente:

✅ La publicación mediante CLI es correcta
✅ manifest carpeta creada con manifest.json y manifest.zip
✅ El agente aparece en el Centro de administración de Microsoft

Salida CLI

Se muestran estos mensajes de salida cuando el comando publish se ejecuta correctamente:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ Instrucciones paso a paso para cargar impresas

Si el comando falla, revise los mensajes de error y asegúrese de que ha completado la configuración del plano técnico.

Posibles errores:

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

Siga estos pasos cuando la publicación falle.

Archivos de manifiesto

Puede probar los siguientes archivos en la carpeta manifest con 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 ve estos archivos, intenta ejecutar el a365 publishcomando de nuevo.

Agente aparece en el Centro de administración

Nota

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

Confirme que el agente esté presente siguiendo estos pasos:

  1. Vaya al Centro de administración de Microsoft 365.
  2. Vaya a Agentes>Todos los agentes.
  3. El agente aparece en la lista.

La siguiente tabla muestra qué detalles puede encontrar:

Campo Elementos que se deben comprobar
Nombre Nombre de su agente (de manifest.json)
Versión Número de versión (por ejemplo, 1.0.0)
Editor El nombre de su organización
Disponibilidad Disponible/Todos los usuarios

Vea también

Pasos siguientes

Después de publicar tu agente, crea una instancia para configurarla y usarla en su 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 solución de problemas de Agent 365 contiene recomendaciones generales, procedimientos recomendados y vínculos a recursos de solución de problemas para cada parte del ciclo de vida del desarrollo de Agent 365.

Fallo en el comando de publicación

Síntomas:

  • Error durante a365 publish
  • manifest.zip no se crea

Causas raíz:

  • No se ha completado la instalación
  • Errores de validación de manifiestos
  • Permisos insuficientes

Solución:

  1. Compruebe que la instalación se ha completado.

    Get-Content a365.generated.config.json | ConvertFrom-Json | Select-Object agentBlueprintId

  2. Ejecute el comando publish y siga 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 raíz:

  • Permisos insuficientes en el centro de administración
  • manifest.zip no válido o desactualizado

Solución:

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

Para obtener más ayuda, consulte Cargar agentes al Centro de administración de Microsoft 365.

  • Last updated on