CLI de Agent 365

La CLI de Agent 365 es una herramienta de línea de comandos multiplataforma para implementar y administrar aplicaciones de Agent 365 en Azure.

Requisitos previos

Antes de comenzar, asegúrese de que tiene lo siguiente:

• Registro personalizado de aplicación cliente - La CLI requiere una aplicación cliente personalizada en tu tenant Microsoft Entra ID para autenticación. Consulta Registro de aplicaciones clientas personalizadas para instrucciones detalladas de configuración. Necesitas el ID de la aplicación (cliente) durante la configuración.
• Suscripción Azure - Acceso a una suscripción Azure donde puedes crear recursos.
• Permisos requeridos - Tu cuenta debe tener uno de los siguientes roles:
  • Administrador global
  • Administrador de ID de Agente
  • Desarrollador de ID de Agente

Instalar la CLI de Agent 365

Siga estos pasos para instalar la CLI de Agent 365 globalmente en el sistema operativo.

Requisitos previos

Debe haber instalado .NET. (Se recomienda .NET 8.0)

Usar dotnet tool install

Instale la CLI de Agent 365 con el siguiente comando:

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli

Si recibes un microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json error, usa el --prerelease parámetro, ya que este paquete podría estar etiquetado como prerelease.

dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease

Para obtener las instrucciones más recientes y las versiones disponibles, visite la página oficial de NuGet: Microsoft.Agents.A365.DevTools.Cli en NuGet.org

Verificar instalación

Después de instalar la CLI de Agent 365, compruebe que está correctamente instalada mediante la ejecución de:

a365 -h

Este comando muestra la información de ayuda y confirma que la CLI está lista para usarse.

Update

Actualice la CLI de Agent 365 mediante el comando dotnet tool update:

dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli

Desinstalar

Desinstale Agent 365 mediante el comando dotnet tool update:

dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli

Ubicaciones de archivo

La ubicación predeterminada del archivo ejecutable de una herramienta depende del sistema operativo:

Esta ubicación se agrega a la ruta del usuario cuando se ejecuta el SDK por primera vez. Por lo tanto, las herramientas globales se pueden invocar desde cualquier directorio sin especificar la ubicación de la herramienta.

El acceso a la herramienta es específico del usuario, no global de la máquina. Una herramienta global solo está disponible para el usuario que instaló la herramienta.

Comandos disponibles

Para obtener la lista completa de comandos disponibles, use el comando --help o consulte Referencia de la CLI de Agent 365

Actualizaciones importantes

Comando eliminado: El create-instance comando fue eliminado de la CLI. Evitaba los pasos de registro requeridos, lo que limitaba la funcionalidad del agente. Este comando puede reintroducirse en una versión posterior cuando esté a la altura del flujo de trabajo recomendado.

Utiliza este flujo de trabajo en su lugar:

1. a365 publish - Publicar el agente en el centro de administración de Microsoft 365
2. Configurar el blueprint del agente en el Portal de Desarrolladores - Consulta Configurar el blueprint del agente en el Portal de Desarrolladores
3. a365 deploy - Desplegar en Azure (opcional, solo si se utiliza alojamiento Azure)
4. Creación de una instancia de agente a través de Microsoft Teams

Consulta los agentes a bordo para instrucciones completas.

Solución de problemas

Esta sección contiene información sobre cómo solucionar errores con la CLI de Agent 365.

• La instalación, actualización o desinstalación de la CLI falla con Not found in NuGet feeds
• create-instance Comando no encontrado
• Agente que no aparece en Teams
• No se puede crear una instancia de agente en Teams

La instalación, actualización o desinstalación de la CLI falla con Not found in NuGet feeds

Si recibes un microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json error, usa el --prerelease parámetro, ya que este paquete podría estar etiquetado como prerelease.

Para obtener las instrucciones más recientes y las versiones disponibles, visite la página oficial de NuGet: Microsoft.Agents.A365.DevTools.Cli en NuGet.org

Comando create-instance no encontrado

Síntoma:

Error: Command 'create-instance' not found

Causa: El create-instance comando fue eliminado de la CLI. Evitaba los pasos de registro requeridos, lo que limitaba la funcionalidad del agente. Este comando puede reintroducirse en una versión posterior cuando esté a la altura del flujo de trabajo recomendado.

Solution:

Utiliza el flujo de trabajo actualizado:

1. Publica a tu agente:

   a365 publish
   

2. Configurar el plano del agente en el Portal de Desarrolladores:

   Consulta Configurar el plano del agente en el Portal de Desarrolladores para instrucciones detalladas.

3. Desplegar en Azure (opcional):

   # Only if hosting on Azure Web App
   a365 deploy
   

4. Crea una instancia de agente a través de Microsoft Teams:

   • Open Microsoft Teams
   • Navegar a Apps
   • Busca a tu agente
   • Haz clic en "Añadir" para crear una instancia de agente

Para instrucciones detalladas, véase Agentes a bordo.

Agente que no aparece en los equipos

Síntoma: Después de ejecutar comandos, el agente no aparece en Microsoft Teams.

Causa: Puede que hayas saltado el publish paso o intentado usar el comando eliminado create-instance .

Solution:

1. Verifica que has corrido a365 publish correctamente
2. Espere entre 5 y 10 minutos para la propagación
3. Consulta el Centro de Administración de Microsoft 365: https://admin.cloud.microsoft/#/agents/all
4. Crea una instancia de agente a través de la sección de Apps de Teams

No se puede crear una instancia de agente en Teams

Síntoma: El agente aparece en Teams pero no puedes crear una instancia de agente (no puedes añadir el agente).

Causa: La licencia "Microsoft Agent 365 Frontier" no se asigna a tu cuenta de usuario.