Compartir por

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

Instala la CLI del Agente 365 usando el siguiente comando con el --prerelease parámetro:

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

Importante

El CLI del Agente 365 sigue en vista previa. Hasta que la CLI del Agente 365 esté disponible en general, utiliza siempre el --prerelease parámetro para obtener la última versión con las correcciones y características más recientes. Cuando la CLI del Agente 365 esté disponible de forma general, el --prerelease parámetro no será necesario.

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

Actualizar la CLI del Agente 365 usando el comando de actualización de la herramienta dotnet con el --prerelease parámetro:

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

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.

Consulte Ciclo de Vida de Desarrollo del Agente 365 para instrucciones completas sobre cómo configurar un agente del Agente 365 usando la CLI.

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, asegúrate de usar el --prerelease parámetro. Todas las versiones actuales de la CLI son versiones de pre-lanzamiento.

Solution:

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

# For updates
dotnet tool update --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

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:

    Aprende a configurar un blueprint de agente en el Portal de Desarrolladores de Teams

  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