Compartir a través de

CLI de Agent 365

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.

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

Requisitos previos

Asegúrese de que cumple los siguientes requisitos previos antes de empezar:

  • Registro de aplicaciones cliente : la CLI requiere una aplicación cliente personalizada en el inquilino de Microsoft Entra ID para la autenticación. Ver Registro de aplicaciones clientes personalizadas para instrucciones detalladas de configuración. Necesitas el ID de la aplicación (cliente) durante la configuración.
  • Azure suscripción: acceso a una suscripción de Azure donde puede crear recursos.
  • Permisos requeridos - Tu cuenta debe tener uno de los siguientes roles:
    • Administrador global
    • Administrador de ID de Agente
    • Desarrollador de Identificación de Agente

Nota

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

Sugerencia

Diferentes comandos CLI requieren distintos roles o permisos. Cada página de referencia de comandos especifica el rol mínimo requerido. Por ejemplo, consulta la 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 tener .NET instalado. (se recomienda .NET 8.0).

Utiliza dotnet tool install

Instala la CLI Agent 365 usando el siguiente comando con el parámetro:

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

Importante

El CLI de Agent 365 está aún en versión preliminar. Hasta que la CLI del Agente 365 esté disponible en general, utiliza siempre el 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 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, verifica que esté correctamente instalada ejecutando el comando:

a365 -h

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

Actualizar

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

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

Nota

Para actualizar la CLI del Agente 365, necesitas una conexión a internet para acceder al último paquete NuGet: Microsoft.Agents.A365.DevTools.Cli.

Desinstalar

Desinstale Agent 365 CLI mediante el comando dotnet tool uninstall:

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

El SDK añade esta ubicación a tu ruta cuando la ejecutas por primera vez. Así que puedes invocar herramientas globales 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 la instala.

Comandos disponibles

Para la lista completa de comandos disponibles, utilice el comando o consulte la Referencia CLI del Agente 365.

Actualizaciones importantes

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

Para instrucciones completas sobre cómo configurar un agente Agent 365 usando la CLI, consulte Ciclo de Vida de Desarrollo del Agente 365.

Solución de problemas

Esta sección proporciona información sobre cómo solucionar errores con la CLI del Agente 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.

Cuestiones específicas de la CLI tratadas en esta sección:

  • Error al instalar, actualizar o desinstalar
  • Comando no encontrado
  • El agente no aparece en Teams
  • No puedo crear una instancia de agente en Teams

Error al instalar, actualizar o desinstalar

Síntoma: error al instalar, actualizar o desinstalar la CLI del Agente 365.

Solución: Usa el parámetro.

Todas las versiones actuales de la CLI son versiones de pre-lanzamiento.

# 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 no encontrado

Síntoma: Ves el error.

Causa: El CLI eliminó el comando. Evitaba los pasos de registro requeridos, lo que limitaba la funcionalidad del agente. El equipo de desarrollo podría reintroducir este comando en una versión posterior cuando esté a la altura del flujo de trabajo recomendado.

Solución: Utiliza los siguientes pasos en su lugar:

  1. Publica a tu agente: Usa el comando a365 publish.

    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. Deploy to Azure (opcional): Use el comando a365 deploy.

    # Only if hosting on Azure Web App
a365 deploy

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

    1. Abra Microsoft Teams.
    2. Vaya a Aplicaciones.
    3. Busca a tu agente.
    4. Selecciona Añadir para crear una instancia agente.

Para instrucciones detalladas, véase Agentes a bordo.

El agente no aparece en Teams

Resolución de problemas de instancias de agentes creados: El agente no aparece en Teams

No puedo crear una instancia de agente en Teams

Resolución de problemas de instancias de agentes: No se puede crear instancia de agente en Teams

  • Last updated on