Probar el agente localmente en el área de juegos de agentes de Microsoft 365

Los detalles de cómo probar su agente localmente dependen de cómo lo creó.

Puede crear un agente usando el SDK de agentes de Microsoft 365 de tres maneras:

• Comience con el Microsoft 365 Agents Toolkit con C#, JavaScript o Python utilizando Visual Studio o Visual Studio Code.
• Clonar un ejemplo y ábralo en su IDE
• Uso de la CLI

Comience su proyecto con el kit de herramientas

Si comienza con el Agents Toolkit, todo está configurado para probar inmediatamente con el Área de juegos de agentes. Puede probar en el área de juegos de agentes localmente o en Microsoft 365 Copilot o Microsoft Teams. Hablamos de este particular en:

• Tutorial de Visual Studio Code
• Tutorial de Visual Studio

Empiece su proyecto clonando o usando la CLI

Si empieza su proyecto usando la CLI o clonas una muestra y la abre en su IDE, puede usar el área de juegos de Agents local para probar. El área de juegos de agentes se conecta al código local.

Puede instalar el área de juegos de agentes mediante uno de los métodos siguientes:

Opción 1: Instalar el binario independiente

winget install agentsplayground

curl -s https://raw.githubusercontent.com/OfficeDev/microsoft-365-agents-toolkit/dev/.github/scripts/install-agentsplayground-linux.sh | bash

Opción 2: Instalar usando npm

• Instale Node.js (si aún no está instalado): descargue e instale la versión más reciente de Node.js desde nodejs.org.

• Instale el paquete del área de juegos de Agents:

  Para la instalación global (recomendado):

  npm install -g @microsoft/m365agentsplayground
  

  Para una instalación específica del proyecto:

  npm install -D @microsoft/m365agentsplayground
  

Probar el agente

1. Una vez que cree el agente de inicio rápido o clone un ejemplo del repositorio, puede usarlo con el Área de juegos de agentes.

2. El área de juegos de Agents admite tanto el modo anónimo como el modo autenticado. Para pruebas anónimas, no es necesaria ninguna configuración adicional. Si quiere probar con la autenticación, debe configurar los registros de aplicaciones de Microsoft Entra ID para el Área de juegos de agentes (las opciones se proporcionan en el texto siguiente) y su aplicación. Para más información, consulte Aprovisionar un bot de Azure para usarlo con el SDK de agentes.

3. Configurar correctamente los puertos en su aplicación. Seleccione un puerto disponible para su agente (el predeterminado es 3978, pero puede usar cualquier puerto disponible).

4. Ejecute el código.

5. Abra el área de juegos de agentes e inicie con el punto de conexión del agente:

   agentsplayground -e "http://localhost:<your-agent-port>/api/messages" -c "emulator"
   

   Configurar la autenticación si lo requiere su agente:

   agentsplayground -e "http://localhost:<your-agent-port>/api/messages" -c "emulator" --client-id "your-client-id" --client-secret "your-client-secret" --tenant-id "your-tenant-id"
   

   Opciones principales:

   • -e, --app-endpoint: URL del punto de conexión de su agente (por ejemplo, http://localhost:3978/api/messages)
   • -c, --channel-id: tipo de canal (por ejemplo, emulator, webchat, msteams). Cada canal ofrece diferentes experiencias de usuario y propiedades de actividad.
   • --client-id: Id. de cliente para autenticación
   • --client-secret: secreto de cliente para autenticación
   • --tenant-id: id. de inquilino para autenticación

   Use agentsplayground --help para ver la lista completa de opciones disponibles.

   Alternativamente, puede usar variables de entorno en lugar de opciones de CLI. Si ambas opciones están especificadas, la opción de CLI tiene mayor prioridad.

   export BOT_ENDPOINT="http://localhost:<your-agent-port>/api/messages"
   export DEFAULT_CHANNEL_ID="emulator"
   export AUTH_CLIENT_ID="your-client-id"
   export AUTH_CLIENT_SECRET="your-client-secret"
   export AUTH_TENANT_ID="your-tenant-id"
   

   Una vez que su agente esté iniciado, se debe abrir como se muestra en la siguiente imagen. Puede hacer preguntas y probar el agente en la interfaz del área de juegos.

   

Siempre que sea posible, recomendamos que empiece con el kit de herramientas de Microsoft 365 Agents. El Toolkit hace que comenzar, probar en local y desplegar sea más fácil y rápido. Abstrae gran parte de la configuración manual del Azure Bot Service y los registros de aplicaciones de Azure, por lo que no es necesario que lo hagas. Al iniciar manualmente, debe realizar estos pasos usted mismo.

Resumen

Ha probado su SDK de agentes de Microsoft 365 localmente utilizando el área de juegos de Microsoft 365 Agents, comenzando con un ejemplo clonado desde el repositorio de GitHub o generado desde la CLI.