Comparteix a través de

Prueba agentes usando el Microsoft Agent 365 SDK

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.

Antes de la implementación, pruebe el agente localmente mediante Agents Playground. Esta guía trata sobre cómo configurar tu entorno de desarrollo, configurar la autenticación y validar la funcionalidad de tu agente utilizando la herramienta de pruebas Agents Playground.

Una vez que el agente funcione localmente, siga el ciclo de vida de desarrollo del Agente 365 para probar en aplicaciones de Microsoft 365 como Teams, Word y Outlook.

Requisitos previos

Antes de comenzar a probar el agente, asegúrese de que cumple los siguientes requisitos previos instalados:

Requisitos previos comunes

Requisitos previos específicos de idioma

Configurar el entorno de pruebas del agente

Esta sección describe cómo establecer variables de entorno, autenticar tu entorno de desarrollo y preparar tu agente impulsado por Agent 365 para las pruebas.

Configure el entorno de prueba del agente siguiendo este flujo de trabajo secuencial:

  1. Configura tu entorno - Crea o actualiza tu archivo de configuración de entorno.

  2. Configuración de LLM - Obtener claves de API y configurar OpenAI o la configuración de Azure OpenAI.

  3. Configurar autenticación - Configurar autenticación agente.

  4. Referencia de variables de entorno: configure las variables de entorno necesarias:

    1. Variables de autenticación
    2. Configuración de puntos de conexión MCP
    3. Variables de observabilidad
    4. Configuración del servidor de aplicaciones del agente

Después de completar estos pasos, estará listo para empezar a probar el agente en el Espacio de prueba de agentes.

Paso 1: Configuración del entorno

Configure su archivo de configuración:

cp .env.template .env

Nota

Para las plantillas de configuración que muestran los campos requeridos, consulta los ejemplos del SDK del Microsoft Agent 365.

Paso 2: Configuración de LLM

Configurar los ajustes de OpenAI o Azure OpenAI para las pruebas locales. Añade tus claves API y puntos finales de servicio de los requisitos previos a tu archivo de configuración junto con cualquier parámetro de modelo.

Agregue a su archivo .env:

# Replace with your actual OpenAI API key
OPENAI_API_KEY=

# Azure OpenAI Configuration
AZURE_OPENAI_API_KEY=
AZURE_OPENAI_ENDPOINT=
AZURE_OPENAI_DEPLOYMENT=
AZURE_OPENAI_API_VERSION=

Variables de entorno de Python para LLM

Variable Descripción Obligatorio Ejemplo
OPENAI_API_KEY Clave de API para OpenAI Service Para OpenAI sk-proj-...
AZURE_OPENAI_API_KEY Clave de API para el servicio Azure OpenAI Para Azure OpenAI a1b2c3d4e5f6...
AZURE_OPENAI_ENDPOINT URL del punto de conexión del servicio Azure OpenAI Para Azure OpenAI https://your-resource.openai.azure.com/
AZURE_OPENAI_DEPLOYMENT Nombre de implementación en Azure OpenAI Para Azure OpenAI gpt-4
AZURE_OPENAI_API_VERSION Versión de API para Azure OpenAI Para Azure OpenAI 2024-02-15-preview

Paso 3: Configurar la autenticación para tu agente

Elige uno de los siguientes métodos de autenticación para tu agente:

  • Autenticación agente : Úsalo para escenarios de producción cuando hay una identidad de usuario agente disponible.
  • Autenticación OBO - Úsalo para escenarios de producción cuando necesitas permisos de usuario delegados sin una identidad agente de usuario.
  • Autenticación de token portador - Úsalo solo para escenarios de desarrollo y pruebas iniciales antes de configurar la autenticación en producción.

Autenticación agentica

Utiliza el comando Agent 365 CLI a365 config display para obtener tus credenciales de plano de agente.

a365 config display -g

Este comando muestra la configuración del plano técnico del agente. Copie los siguientes valores:

valor Descripción
agentBlueprintId Id. de cliente del agente
agentBlueprintClientSecret Secreto del cliente de tu agente
tenantId Identificador de inquilino de Microsoft Entra

Use estos valores para configurar la autenticación de agente en su agente:

Agregue la siguiente configuración al archivo .env y reemplace los valores de marcador de posición por sus credenciales reales:

USE_AGENTIC_AUTH=true
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTID=<agentBlueprintId>
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTSECRET=<agentBlueprintClientSecret>
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__TENANTID=<your-tenant-id>
Variable Descripción Obligatorio Ejemplo
USE_AGENTIC_AUTH Habilitar el modo de autenticación de agente Sí true
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTID Id. de cliente del plano técnico de agente desde a365 config display -g Sí 12345678-1234-1234-1234-123456789abc
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__CLIENTSECRET Id. de cliente de plano técnico de agente desde a365 config display -g Sí abc~123...
CONNECTIONS__SERVICE_CONNECTION__SETTINGS__TENANTID Microsoft Entra ID de tenant de a365 config display -g Sí adfa4542-3e1e-46f5-9c70-3df0b15b3f6c

Autenticación OBO

Mediante la autenticación on-Behalf-Of (OBO), el agente puede acceder a las herramientas del servidor MCP mediante permisos de usuario delegados sin necesidad de una identidad de usuario agente. En este flujo, el agente recibe el token delegado por el usuario y lo intercambia para realizar acciones en nombre del usuario.

La autenticación OBO es adecuada para escenarios de producción donde:

  • Tu agente no tiene una identidad de usuario agente.
  • Necesitas acceder a recursos con permisos específicos de cada usuario.
  • Quieres que el agente actúe en nombre del usuario autenticado.

Para más detalles sobre cómo funciona el flujo OBO, véase Flujos de autenticación. Para obtener un ejemplo de implementación completo, consulte el ejemplo de autorización OBO en el Microsoft 365 Agents SDK.

Autenticación por token de portador

Para escenarios iniciales de desarrollo y pruebas cuando la autenticación en producción no está configurada, usa la autenticación con token portador para probar tu agente. Este método utiliza autenticación interactiva del navegador para obtener un token de acceso delegado. Al usar este token, tu agente puede llamar a las herramientas del servidor MCP usando tus permisos de usuario. Este enfoque simula cómo un usuario agente accede a recursos en producción sin necesidad de una instancia real de agente.

Primero, usa a365 develop add-permissions para añadir los permisos necesarios del servidor MCP a tu aplicación:

a365 develop add-permissions

Luego, se utiliza a365 develop get-token para recuperar y configurar los tokens portadores:

a365 develop get-token

El comando get-token automáticamente:

  • Recupera tokens de portador para todos los servidores MCP configurados en el ToolingManifest.json archivo.
  • Actualiza los archivos de configuración del proyecto con la variable de entorno BEARER_TOKEN.

Antes de ejecutar get-token, configure el archivo de configuración del proyecto para que el comando sepa dónde guardar el token:

  • .NET: agregue "BEARER_TOKEN": "" a environmentVariables en cada perfil de Properties/launchSettings.json. El comando solo actualiza los perfiles que ya tienen esta clave definida.
  • Python/Node.js: crear un archivo .env con BEARER_TOKEN= antes de ejecutar. Si falta el archivo, el comando omite guardar y muestra instrucciones.

Nota

Si se ejecuta a365 develop get-token --app-id <id> sin un a365.config.json archivo, el token no se guarda automáticamente. Copie y péguelo manualmente en Properties/launchSettings.json (para .NET) o el archivo /.env (para Python/Node.js).

Las fichas de portador caducan tras aproximadamente una hora. Usa a365 develop get-token para actualizar tokens expirados.

Paso 4: Referencia a variables de entorno

Complete la configuración del entorno mediante la configuración de las siguientes variables de entorno necesarias:

Variables de autenticación

Configure las opciones del controlador de autenticación necesarias para que la autenticación agente funcione correctamente.

Agregue a su archivo .env:

# Agentic Authentication Settings
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__TYPE=AgenticUserAuthorization
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__SCOPES=https://graph.microsoft.com/.default
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALTERNATEBLUEPRINTCONNECTIONNAME=service_connection

# Connection Mapping
CONNECTIONSMAP_0_SERVICEURL=*
CONNECTIONSMAP_0_CONNECTION=SERVICE_CONNECTION
Variable Descripción Obligatorio
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__TYPE Tipo de controlador de autenticación Sí
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__SCOPES Ámbitos de autenticación para Microsoft Graph Sí
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALTERNATEBLUEPRINTCONNECTIONNAME Nombre de conexión de plano técnico alternativo Sí
CONNECTIONSMAP_0_SERVICEURL Patrón de dirección URL de servicio para la asignación de conexiones Sí
CONNECTIONSMAP_0_CONNECTION Nombre de conexión para asignación Sí

Configuración de puntos de conexión MCP

Especifica el punto final de la plataforma Agent 365 al que se conecta tu agente. Cuando generes el manifiesto de herramientas que define los servidores de herramientas para tu agente, especifica el endpoint de la plataforma MCP. Este punto de conexión determina a qué entorno (preprod, test o producción) se conectan los servidores de la herramienta MCP para las funcionalidades de integración de Microsoft 365.

Agregue a su archivo .env:

# MCP Server Configuration
MCP_PLATFORM_ENDPOINT=<MCP endpoint>
Variable Descripción Obligatorio Valor predeterminado Ejemplo
MCP_PLATFORM_ENDPOINT Dirección URL del punto de conexión de la plataforma MCP (preproducción, prueba o producción) No Punto de conexión de producción

Importante: Si no especificas MCP_PLATFORM_ENDPOINT, la app usa el endpoint de producción.

Nota

Si usas el servidor de herramientas simulado de la CLI, configura el endpoint http://localhost:<port> usando el número de puerto que utilizaste. El puerto predeterminado es 5309.

Variables de observabilidad

Configure estas variables necesarias para habilitar el registro y el seguimiento distribuido para el agente. Aprende más sobre las características de observabilidad y las mejores prácticas.

Nota

La configuración de observabilidad es la misma en todos los idiomas.

Variable Descripción Valor predeterminado Ejemplo
ENABLE_A365_OBSERVABILITY Habilitar o desactivar la observabilidad false true
ENABLE_A365_OBSERVABILITY_EXPORTER Exportar rastros al servicio de observabilidad false true
OBSERVABILITY_SERVICE_NAME Nombre del servicio para seguimiento Nombre del agente my-agent-service
OBSERVABILITY_SERVICE_NAMESPACE Espacio de nombres de servicio agent365-samples my-company-agents

Configuración del servidor de aplicaciones del agente

Configure el puerto donde se ejecuta el servidor de aplicaciones del agente. Esta configuración es opcional y se aplica a Python y a los agentes de JavaScript.

Agregue a su archivo .env:

# Server Configuration
PORT=3978
Variable Descripción Obligatorio Valor predeterminado Ejemplo
PORT Número de puerto donde se ejecuta el servidor del agente No 3978 3978

Instalar dependencias e inicio del servidor de aplicaciones del agente

Después de configurar tu entorno, instala las dependencias necesarias y inicia el servidor de aplicaciones del agente localmente para las pruebas.

Instalar dependencias

uv pip install -e .

Este comando lee las dependencias del paquete definidas en pyproject.toml y las instala desde PyPI. Al crear una aplicación agente desde cero, crea un pyproject.toml archivo para definir tus dependencias. Los agentes de ejemplo del repositorio de ejemplos ya tienen definidos estos paquetes. Puede agregarlos o actualizarlos según sea necesario.

Inicie el servidor de aplicaciones del agente

python <main.py>

Reemplace <main.py> por el nombre del archivo de Python principal que contiene el punto de entrada de la aplicación del agente (por ejemplo, start_with_generic_host.py, app.py o main.py).

O usa UV:

uv run python <main.py>

El servidor del agente ya se está ejecutando y está listo para recibir solicitudes desde el área de juegos de agentes o las aplicaciones de Microsoft 365.

Probar el agente en el área de juegos de agentes

Agents Playground es una herramienta de prueba local que simula el entorno de Microsoft 365 sin necesidad de una configuración completa del inquilino. Es la forma más rápida de validar la lógica y las invocaciones de herramientas del agente. Para obtener más información, consulte Probar con el área de juegos de agentes.

Configurar Agents Playground para la autenticación agentica

Nota

Esta configuración solo es necesaria cuando se utiliza autenticación agente. Si usas autenticación con token de portador, puedes saltarte esta sección y pasar directamente a la prueba Básica.

Al usar la autenticación agéntica, configura el archivo YAML de _Agents Playground_ con los detalles de tu agente:

  1. Configura el archivo de configuración: Crea o actualiza el .m365agentsplayground.yml archivo en la carpeta donde ejecutas Agents Playground. Para obtener instrucciones detalladas de configuración, consulta Personalizar el contexto de Teams.

  2. Actualiza la configuración del bot: Añade los siguientes datos del bot a tu .m365agentsplayground.yml archivo, reemplazando los valores provisionales por tus credenciales reales de agente:

    bot:
  id: <your-agent-email>@<your-tenant>.onmicrosoft.com
  name: <Your Agent Name>
  role: agenticUser
  agenticUserId: <your-agentic-user-id>
  agenticAppId: <your-agentic-app-id>
    Propiedad Descripción Obligatorio
    id La dirección de correo electrónico de tu agente en el formato agentusername@tenant.onmicrosoft.com Sí
    name Nombre visual para tu usuario agente Sí
    role Debe estar configurado en agenticUser para la autenticación agente Sí
    agenticUserId El ID del objeto del usuario agente. Busque este valor en el centro de administración de Microsoft Entra en la página de perfil del usuario del agente. Sí
    agenticAppId El ID de agente del usuario asignado. Busque este valor en el centro de administración de Microsoft Entra en la página de perfil del usuario del agente. Sí

Abra un nuevo terminal (PowerShell en Windows) e inicie El área de juegos de agentes:

agentsplayground

Este comando abre un navegador web con la interfaz de Agents Playground. La herramienta muestra una interfaz de chat en la que puede enviar mensajes al agente.

Prueba básica

Comience comprobando que el agente está configurado correctamente. Enviar un mensaje al agente:

What can you do?

El agente responde con las instrucciones con las que está configurado, basándose en la solicitud del sistema y las capacidades de tu agente. Esta respuesta confirma que:

  • Tu agente está funcionando correctamente.
  • El agente puede procesar mensajes y responder.
  • La comunicación entre el Agente Playground y tu agente está funcionando.

Invocaciones de la herramienta de prueba

Después de configurar tus servidores de herramientas MCP en toolingManifest.json (ver Herramientas para instrucciones de configuración), prueba las invocaciones de herramientas usando ejemplos como estos:

En primer lugar, compruebe qué herramientas están disponibles:

List all tools I have access to

Luego, prueba invocaciones específicas de herramientas:

Herramientas de correo

Send email to your-email@example.com with subject "Test" and message "Hello from my agent"

Respuesta esperada: El agente envía un correo electrónico usando el servidor Mail MCP y confirma que el mensaje se ha enviado.

Herramientas de calendario

List my calendar events for today

Respuesta esperada: El agente recupera y muestra los eventos del calendario correspondientes al día actual.

herramientas de SharePoint

List all SharePoint sites I have access to

Respuesta esperada: el agente consulta SharePoint y devuelve una lista de sitios a los que tiene acceso.

Puede ver las invocaciones de herramientas en:

  • La ventana de chat : vea la respuesta del agente y las llamadas a herramientas.
  • El panel Registro : vea información detallada de la actividad, incluidos los parámetros y respuestas de la herramienta.

Probar con actividades de notificación

Durante el desarrollo local, prueba los escenarios de notificación utilizando los disparadores de notificación integrados en Agents Playground.

Captura de pantalla que muestra la interfaz del Playground de Agentes con el menú Simular una Actividad expandido, mostrando opciones de Actividad de Notificación de Desencadenador, como Enviar correo electrónico y Mencionar en Word.

Antes de probar las actividades de notificación, asegúrate de:

Notificaciones de correo electrónico de prueba

Para probar la gestión de notificaciones por correo electrónico:

  1. Empieza tu Patio de Agentes y Agentes.
  2. En Agents Playground, ve a Simular una Actividad>Actividad de Notificación de Disparo.
  3. Seleccione Enviar correo electrónico.
  4. En el cuadro de diálogo de payload, actualiza los detalles del correo simulado, como el nombre del remitente y el contenido del cuerpo del correo, según sea necesario.
  5. Seleccione Enviar actividad.
  6. Consulta el resultado tanto en la conversación del chat como en el panel de registros.

El agente recibe una notificación simulada por correo electrónico y la procesa según tu lógica de gestión de notificaciones. Para más detalles sobre la estructura de la carga útil de notificación por correo electrónico, consulte Carga útil de notificación por correo electrónico.

Prueba Word notificaciones de mención

Para probar las notificaciones de mención en documentos de Word:

  1. Empieza tu Patio de Agentes y Agentes.
  2. En Agents Playground, ve a Simular una Actividad>Actividad de Notificación de Disparo.
  3. Seleccione Mention en Word.
  4. En el cuadro de diálogo de carga, actualice los detalles del comentario ficticio, como el identificador del documento y el texto del comentario según sea necesario.
  5. Seleccione Enviar actividad.
  6. Consulta el resultado tanto en la conversación del chat como en el panel de registros.

El agente recibe una notificación simulada de mención de Word, y responde según la lógica de manejo de notificaciones. Para obtener más información sobre la estructura de carga de notificación de comentarios de Word, consulte Document comment notification payload.

Eventos de prueba de instalación y desinstalación del agente

Cuando Agents Playground se conecta al agente, envía automáticamente una InstallationUpdate actividad con la acción add. Si implementa un controlador de instalación, el mensaje de bienvenida del agente aparece en el chat inmediatamente después de establecer la conexión.

Para comprobar el control de eventos de instalación:

  1. Inicie el servidor del agente.
  2. Abra el área de juegos de agentes. El área de juegos se conecta al agente y desencadena automáticamente el evento de instalación.
  3. Confirme que el mensaje de bienvenida aparece en la conversación de chat.

Captura de pantalla que muestra la interfaz de la Plataforma de Agentes con el mensaje de bienvenida del agente

Para obtener más información sobre cómo implementar el controlador, consulte Controlar eventos de instalación y desinstalación del agente.

Ver registros de observabilidad

Para ver los registros de observabilidad durante el desarrollo local, instrumente el agente con código de observabilidad (consulte Observabilidad para ejemplos de código) y configure las variables de entorno tal como se describe en Variables de observabilidad. Una vez configurado, aparecen trazas en tiempo real en la consola que muestran:

  • Trazas de invocación de agente
  • Detalles de ejecución de herramienta
  • Llamadas de inferencia de LLM
  • Mensajes de entrada y salida
  • Uso de tokens
  • Tiempos de respuesta
  • Información de error

Estos registros te ayudan a depurar problemas, entender el comportamiento del agente y optimizar el rendimiento.

Pasos siguientes

Después de probar el agente localmente, impleméntelo en Azure y publíquelo en Microsoft 365.

Para probar el agente en aplicaciones de Microsoft 365 como Teams, Word y Outlook, consulte el ciclo de vida de desarrollo del agente 365.

Solución de problemas

Esta sección ofrece soluciones a problemas comunes que puedas encontrar al evaluar a tu agente localmente.

Sugerencia

La Guía de Resolución de Problemas del Agente 365 contiene recomendaciones de solución de problemas de alto nivel, mejores prácticas y enlaces a contenido de solución de problemas para cada parte del ciclo de vida del Agente 365.

Problemas de conexión y entorno

Estos problemas se relacionan con la conectividad de red, los conflictos de puertos y los problemas de configuración del entorno que impiden que el agente se comunique correctamente.

Problemas de conexión con Agents Playground

Síntoma: Agents Playground no puede conectarse a tu agente.

Soluciones:

  • Verifica que tu servidor agente esté funcionando.
  • Comprueba que los números de puerto coincidan entre tu agente y Agents Playground.
  • Asegúrate de que no haya reglas de cortafuegos que bloqueen las conexiones locales.
  • Prueba a reiniciar tanto el Patio de Juegos del Agente como el del Agente.

Versión del Área de juegos de agentes obsoleta

Síntoma: Errores inesperados o funciones ausentes en Agents Playground.

Solución: Desinstalar y reinstalar Agents Playground.

winget uninstall agentsplayground
winget install agentsplayground

Conflictos de puertos

Síntoma: El puerto indicador de error ya está en uso.

Solución:

  • Detén cualquier otra instancia de tu agente.
  • Cambia el puerto en tu configuración.
  • Elimina cualquier proceso que use el puerto.
# Windows PowerShell
Get-Process -Id (Get-NetTCPConnection -LocalPort <port>).OwningProcess | Stop-Process

No se puede agregar DeveloperMCPServer

Síntoma: error al intentar agregar DeveloperMCPServer en Visual Studio Code.

Solución: cierre y vuelva a abrir Visual Studio Code e intente agregar el servidor de nuevo.

Autenticación y problemas de token

Estos problemas se producen cuando el agente no se puede autenticar correctamente con Microsoft 365 servicios o cuando las credenciales expiran o están mal configuradas.

Síntomas:

  • Errores no autorizados 401
  • Mensajes de "Token de portador expirado"
  • Fallos de autenticación agéntica

Causa principal:

  • Los tokens caducan tras aproximadamente una hora
  • Configuración incorrecta de autenticación
  • Falta o credenciales no válidas

Soluciones:

  • Para la expiración del token de acceso

    Actualiza tu token y actualiza tus variables de entorno.

    # Get a new token
a365 develop get-token

# Update your .env file with the new token

  • Para errores de autenticación por agente (Python)

    Revisa tu .env archivo.

    # Should be (with underscore):
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALT_BLUEPRINT_NAME=SERVICE_CONNECTION

# Not:
AGENTAPPLICATION__USERAUTHORIZATION__HANDLERS__AGENTIC__SETTINGS__ALT_BLUEPRINT_NAME=ServiceConnection

  • Por credenciales perdidas

    Confirma que las credenciales requeridas estén presentes antes de hacer la prueba.

    Aseguren que .env y appsettings.json contengan:

    • Claves y secretos API
    • Id. de inquilino
    • Id. de cliente
    • ID de plan maestro (si se utiliza autenticación de agente)

    Comprobación:

    Prueba con una solicitud sencilla en Agents Playground. Deberías recibir una respuesta sin errores 401.

  • Problemas con herramientas y notificaciones

    Estos problemas implican incidencias con la invocación de herramientas, interacciones con servidores MCP y entrega de notificaciones.

Correo electrónico no recibido

Síntoma: el agente indica que se ha enviado el correo electrónico, pero usted no lo ha recibido

Soluciones:

  • Revisa tu carpeta de Correo no deseado o Spam.
  • La entrega del correo electrónico puede retrasarse unos minutos. Espera hasta cinco minutos.
  • Verifica que la dirección de correo electrónico del destinatario sea correcta.
  • Revisa los registros de los agentes para detectar errores durante el envío de correos.

Las respuestas a comentarios en Word no funcionan

Problema conocido: el servicio de notificaciones no puede responder directamente a comentarios de Word. Esta funcionalidad está en desarrollo.

Los mensajes no llegan al agente

Síntoma: Tu aplicación de agente no recibe mensajes que se envían al agente en Teams.

Causas posibles:

  • El Portal para desarrolladores no está configurado con el blueprint del agente.
  • Azure problemas de aplicación web (errores de implementación, aplicación no en ejecución, errores de configuración).
  • La instancia del agente no se crea correctamente en Teams.

Soluciones:

  • Verificar configuración del Portal de Desarrolladores:

    Asegúrate de completar la configuración del plano del agente en el Portal de Desarrolladores. Aprende a configurar el plano del agente en el Portal de Desarrolladores.

  • Verificar el estado de salud de Azure Web App:

    Si implementa el agente en Azure, compruebe que la aplicación web se está ejecutando correctamente:

    1. Vaya al portal Azure.
    2. Ve a tu recurso de aplicación web.
    3. Consultael estado> (debería mostrar "En funcionamiento").
    4. Comprueba el flujo de registro en Monitorización para detectar errores en tiempo de ejecución.
    5. Revisa los registros del Centro de Despliegue para verificar que el despliegue ha tenido éxito.
    6. Verificar Configuración>Configuración La configuración de la aplicación contiene todas las variables de entorno requeridas.

  • Verificar la creación de instancias del agente:

    Asegúrese de crear correctamente la instancia del agente en Microsoft Teams:

    1. Abra Microsoft Teams.
    2. Ve a Apps y busca a tu agente.
    3. Verifica que el agente aparezca en los resultados de búsqueda.
    4. Si no se encuentra, compruebe que está publicado en Microsoft 365 centro de administración: Agentes.
    5. Crea una nueva instancia en tu agente seleccionando Añadir.
    6. Para instrucciones detalladas, véase Agentes a bordo.
  • Last updated on