Servidor de herramientas simuladas

Agent 365 CLI incluye un servidor simulado de herramientas para pruebas 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 de Agent 365.

Beneficios de utilizar el servidor simulado

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

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

Requisitos previos

Antes de usar el servidor simulado de herramientas, asegúrate de tener los siguientes requisitos:

  • CLI de Agent 365 instalado: use el servidor de herramientas simulado junto con la CLI. Consulta Agent 365 CLI para 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 Agent365-Samples para conocer los puntos de partida disponibles.

Iniciar el servidor de herramientas simulado

Use el comando start-mock-tooling-server de a365 para iniciar el servidor de simulación de herramientas.

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

# Short alias
a365 develop mts

Opciones de comando

El servidor de simulación de herramientas admite las siguientes opciones:

Opción Descripción Valor predeterminado
-p, --port <port> Número de puerto para el servidor simulado 5309
-v, --verbose Habilitación del registro detallado falso
-?, -h, --help Mostrar ayuda e información de uso -
-bg Ejecutar el servidor en una nueva terminal -

Ejemplo

A continuación se muestran ejemplos de cómo iniciar el servidor simulado de herramientas:

Inicia con la configuración predeterminada:

a365 develop start-mock-tooling-server

Empieza con un puerto personalizado:

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

Empieza con registro detallado:

a365 develop start-mock-tooling-server -v

Cuando ejecuta el comando, es:

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

Usa el servidor simulado con agentes de ejemplo

Para conectar tu agente de muestra al servidor simulado de herramientas:

Paso 1: Iniciar el servidor simulado

a365 develop start-mock-tooling-server

El servidor se inicia y muestra una 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: Configurar el agente

Establezca la variable de entorno MCP_PLATFORM_ENDPOINT en tu agente de muestra para que apunte al servidor simulado:

MCP_PLATFORM_ENDPOINT=http://localhost:5309

Si usa un puerto personalizado, reemplace 5309 por el número de puerto que elijas.

Paso 3: Ejecutar su agente

Inicie su agente de muestra como lo hace normalmente. El agente ahora se conecta al servidor simulado en lugar de a los servidores MCP reales.

Paso 4: Monitorea la actividad del servidor

El terminal del servidor simulado muestra:

  • Solicitudes provenientes de tu agente
  • Respuestas simuladas que se devuelven
  • Estado de la conexión y errores (si los hay)

Ejemplos de registros del servidor:

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 pruebas, use Ctrl+C en la terminal donde se está ejecutando 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 solución de problemas de Agent 365 contiene recomendaciones generales, procedimientos recomendados y vínculos a recursos de solución de problemas para cada parte del ciclo de vida del desarrollo de Agent 365.

El servidor simulado no se inicia

Síntoma:Error: Address already in use

Causa: Otro proceso ya está utilizando el puerto predeterminado (5309) o el puerto que especificó.

Solución:

  • Use un puerto diferente.

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

  • O detener el proceso que está utilizando el puerto y volver a intentarlo.

El agente no puede conectarse al servidor simulado

Síntoma: Los registros del agente muestran errores de conexión o tiempos de espera al intentar conectarse al servidor simulado.

Causa:

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

Solución:

  1. Compruebe que el servidor simulado se esté ejecutando y muestre "Ahora escuchando en: http://localhost:5309".
  2. Compruebe que la variable de entorno MCP_PLATFORM_ENDPOINT coincida con la dirección del servidor.
  3. Compruebe que ningún cortafuegos esté bloqueando la conexión en el puerto especificado.
  • Last updated on