Compartir a través de

CLI de Agent 365

Importante

Debe formar parte del programa de versión preliminar de 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.

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:

Nota

Durante el a365 config init paso (después de la instalación), la CLI valida automáticamente el registro de tu app cliente personalizada, comprobando que la app existe, tiene permisos requeridos y cuenta con el consentimiento del administrador.

Sugerencia

Diferentes comandos CLI pueden requerir distintos roles o permisos. Cada página de referencia de comandos especifica el rol mínimo requerido. Por ejemplo, consulta la setup referencia de comandos para sus requisitos específicos.

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

Nota

Todas las actualizaciones para la CLI del Agente 365 requieren conexión a internet para acceder al último paquete NuGet: 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:

SO Ruta
Linux/macOS $HOME/.dotnet/tools
Windows %USERPROFILE%\.dotnet\tools

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

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.

  • Last updated on