Prueba tu agente localmente en el entorno de pruebas de Microsoft 365 Agents

Los detalles de cómo probar tu agente localmente dependen de cómo lo creaste.

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

• Comience con el Kit de herramientas de Agentes de Microsoft 365 en C#, JavaScript o Python mediante Visual Studio o Visual Studio Code
• Clonar desde un ejemplo y abrirlo en el IDE
• Uso de la CLI

Inicio del proyecto con el kit de herramientas

Si empiezas con el Agents Toolkit, tienes todo configurado para probar usando el Agents Playground desde el principio. Puedes probar en el Agents Playground localmente, o en Microsoft Copilot o Microsoft Teams. Este escenario se trata en:

• Tutorial de Visual Studio Code
• Tutorial de Visual Studio

Inicie el proyecto mediante la clonación o con la CLI

Si empiezas tu proyecto usando la CLI o clonas una muestra y la abres en tu IDE, puedes usar el Agents Playground local para probar. El "Agents Playground" se conecta a tu código local.

Puedes instalar el Agents Playground usando uno de los siguientes métodos:

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: Instalación mediante npm

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

• Instale el paquete Agents Playground:

  Para la instalación global (recomendado):

  npm install -g @microsoft/m365agentsplayground
  

  Para la instalación específica del proyecto:

  npm install -D @microsoft/m365agentsplayground
  

Probar el agente

1. Después de crear tu agente de inicio rápido o clonar una muestra del repositorio, úsala con el Agents Playground.

2. Agents Playground admite modos anónimos y autenticados. En el caso de las pruebas anónimas, no se requiere ninguna otra configuración. 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. Configure los puertos correctamente en la aplicación. Selecciona un puerto disponible para tu agente (el predeterminado es 3978, pero puedes 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"
   

   Configure la autenticación si el agente lo requiere:

   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: dirección URL del punto de conexión del agente (por ejemplo, http://localhost:3978/api/messages)
   • -c, --channel-id: tipo de canal (por ejemplo, emulator, webchat, msteams). Cada canal proporciona diferentes propiedades de experiencia de usuario y actividad.
   • --client-id: id. de cliente para la autenticación
   • --client-secret: secreto de cliente para la autenticación
   • --tenant-id: identificador de inquilino para la autenticación

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

   Como alternativa, puede usar variables de entorno en lugar de opciones de la CLI. Si se especifican ambos, la opción de la 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"
   

   Cuando tu agente empieza, se abre como se ve en la siguiente imagen. Puede hacer preguntas y probar el agente en la interfaz del área de juegos.

   

Siempre que sea posible, empieza con el Kit de Herramientas de Agentes de Microsoft 365. El kit de herramientas facilita la introducción, las pruebas localmente y la implementación son más fáciles y rápidas. Abstrae gran parte de la configuración manual del Azure Bot Service y Azure Registros de aplicaciones para que no tengas que hacerlo. Al iniciar manualmente, debe realizar estos pasos manuales usted mismo.

Resumen

Probaste tu SDK de agentes de Microsoft 365 localmente usando el Playground de Agentes de Microsoft 365. Empezaste con una muestra clonada del repositorio de GitHub o de la línea de control.