Servidor de herramientas simuladas

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 Agent 365 incluye un servidor de herramientas simuladas para fines de prueba y desarrollo. Este servidor simula interacciones con servidores MCP (Model Context Protocol), por lo que puedes probar localmente las capacidades de herramientas de tu agente sin necesidad de implementaciones reales del servidor. No cubre ninguna otra funcionalidad del Agente 365.

Ventajas de usar el servidor simulado

El servidor simulado ofrece los siguientes beneficios para el desarrollo y las pruebas locales:

Desarrollo offline: Prueba tu agente sin conectividad a internet ni dependencias externas.
Pruebas consistentes: Recibe respuestas predecibles para los casos límite de prueba.
Depuración: Ver todas las solicitudes y respuestas en tiempo real
Iteración rápida: No es necesario esperar llamadas a API externas ni configurar entornos de prueba complejos.

Prerrequisitos

Antes de usar el servidor de herramientas simuladas, asegúrate de cumplir los siguientes requisitos:

CLI del Agente 365 instalado - Usa el servidor de herramientas de mock junto con la CLI. Consulta la CLI del Agente 365 para las instrucciones de instalación.
- Deberías tener al menos la versión 1.1.25-preview para usar el servidor de herramientas de mock.
Proyecto de agente de ejemplo : un proyecto de agente local que puede conectarse a servidores MCP. Consulta nuestro repositorio deAgent365-Samples para los puntos de partida disponibles.

Inicia el servidor de herramientas de simulación

Usa el comando a365 develop-mock-tooling-server para iniciar el servidor de herramientas de mock.

# Full command
a365 develop start-mock-tooling-server

# Short alias
a365 develop mts

Opciones de comando

El servidor de herramientas simuladas admite las siguientes opciones:

Opción	Description	Predeterminado
`-p, --port <port>`	Número de puerto del servidor ficticio	5309
`-v, --verbose`	Habilitación del registro detallado	false
`-?, -h, --help`	Mostrar información de ayuda y uso	-
`-bg`	Ejecución del servidor en un nuevo terminal	-

Examples

Los siguientes ejemplos muestran formas comunes de iniciar el servidor de herramientas de mock:

Empieza con la configuración por defecto:

a365 develop start-mock-tooling-server

Empieza con un puerto personalizado:

a365 develop start-mock-tooling-server -p 8080

Empieza con registros detallados:

a365 develop start-mock-tooling-server -v

Cuando ejecutas el comando, es:

Inicia el servidor simulado en el puerto especificado (por defecto: localhost:5309).
Muestra los registros del servidor y las solicitudes entrantes en la terminal.

Usa un servidor de simulación con agentes de ejemplo

Para conectar tu agente de muestra al servidor de herramientas de simulación:

Paso 1: Inicia el servidor simulado

a365 develop start-mock-tooling-server

El servidor arranca y muestra la salida similar al siguiente ejemplo:

info: Microsoft.Hosting.Lifetime[14]
      Now listening on: http://localhost:5309
info: Microsoft.Hosting.Lifetime[0]
      Application started. Press Ctrl+C to shut down.

Paso 2: Configura tu agente

Configura la MCP_PLATFORM_ENDPOINT variable de entorno en tu agente de muestra para que apunte al servidor de mock:

MCP_PLATFORM_ENDPOINT=http://localhost:5309

Si usas un puerto personalizado, reemprézcalo 5309 por el número de puerto que elijas.

Paso 3: Gestiona a tu agente

Empieza con tu agente de muestra como normalmente haces. El agente ahora se conecta al servidor simulado en lugar de a los servidores MCP reales.

Paso 4: Monitorizar la actividad del servidor

El terminal del servidor simulado muestra:

Solicitudes entrantes de tu agente
Respuestas burladas que se envían de vuelta
Estado de la conexión y errores (si los hay)

Ejemplos de registros de servidores:

info: Microsoft.AspNetCore.Hosting.Diagnostics[1]
      Request starting HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - application/json 351
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[0]
      Executing endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Http.Result.JsonResult[3]
      Writing value of type '<>f__AnonymousType14`3' as Json.
info: Microsoft.AspNetCore.Routing.EndpointMiddleware[1]
      Executed endpoint 'HTTP: POST /agents/servers/{mcpServerName}'
info: Microsoft.AspNetCore.Hosting.Diagnostics[2]
      Request finished HTTP/1.1 POST http://localhost:5309/agents/servers/mcp_CalendarTools - 200 - application/json;+charset=utf-8 399.1814ms

Detener el servidor simulado

Para detener el servidor de simulación, usa Ctrl+C en la terminal donde está funcionando el servidor, o cierra la ventana del terminal.

Solución de problemas

Esta sección contiene información sobre cómo solucionar problemas comunes con el servidor de herramientas de simulación.

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.

El servidor simulado no arranca

Síntoma:Error: Address already in use

Causa: Otro proceso ya está usando el puerto predeterminado (5309) o el puerto especificado.

Solution:

Usa un puerto diferente.

a365 develop start-mock-tooling-server -p 8080

O detener el proceso usando el puerto y volver a intentarlo.

El agente no puede conectarse al servidor simulado

Síntoma: Los registros de los agentes muestran errores de conexión o tiempos de espera al intentar contactar con el servidor simulado.

Causa:

El servidor simulado no está funcionando.
Variable de entorno incorrecta MCP_PLATFORM_ENDPOINT .
Problemas de cortafuegos o configuración de red.