Сервер имитации инструментов

Интерфейс командной строки Agent 365 включает сервер имитации инструментов для тестирования и разработки. Этот сервер имитирует взаимодействия с сервером MCP (протокол контекста модели), чтобы вы могли локально тестировать инструментальные возможности вашего агента без необходимости в реальных серверах. Он не поддерживает другие функции Agent 365.

Преимущества использования сервера имитации

Сервер имитации предоставляет следующие преимущества для локальной разработки и тестирования:

Офлайн-разработка: тестируйте свой агент без подключения к интернету или внешних зависимостей.
Стабильное тестирование: получайте предсказуемые ответы для тестирования пограничных случаев.
Отладка: просмотр всех запросов и ответов в реальном времени
Быстрая итерация: нет необходимости ждать внешних API-вызовов или настраивать сложные тестовые среды.

Предварительные условия

Перед использованием сервера имитации инструментов убедитесь, что выполнены следующие предварительные условия:

Установлен интерфейс командной строки Agent 365 — используйте сервер имитации инструментов совместно с интерфейсом командной строки. См. раздел Интерфейс командной строки Agent 365 для инструкций по установке.
- Для использования сервера имитации инструментов у вас должна быть как минимум версия 1.1.25 (предварительная версия).
Пример проекта агента — локальный проект агента, который может подключаться к MCP-серверам. См. наш репозиторий Agent365-Samples для доступных начальных точек.

Запуск сервера имитации инструментов

Используйте команду a365 develop start-mock-tooling-server, чтобы запустить сервер имитации инструментов.

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

# Short alias
a365 develop mts

Параметры команды

Сервер имитации инструментов поддерживает следующие параметры:

Вариант	Описание	По умолчанию
`-p, --port <port>`	Номер порта для сервера имитации	5309
`-v, --verbose`	Включить подробное ведение журнала	false
`-?, -h, --help`	Показать справку и инструкции по использованию	-
`-bg`	Запуск сервера в новом терминале	-

Примеры

Следующие примеры показывают распространенные способы запуска сервера имитации инструментов:

Запуск с настройками по умолчанию:

a365 develop start-mock-tooling-server

Запуск на пользовательском порте:

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

Запуск с подробным журналом:

a365 develop start-mock-tooling-server -v

Когда вы выполняете команду, она:

Запускает сервер имитации инструментов на указанном порте (по умолчанию: localhost:5309).
Отображает журналы сервера и входящие запросы в терминале.

Использование сервера имитации с тестовыми агентами

Чтобы подключить ваш тестовый агент к серверу имитации инструментов:

Шаг 1. Запуск сервера имитации

a365 develop start-mock-tooling-server

Сервер запускается и отображает вывод, аналогичный следующему примеру:

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

Шаг 2. Настройка агента

Установите переменную среды MCP_PLATFORM_ENDPOINT в вашем тестовом агенте так, чтобы она указывала на сервер имитации:

MCP_PLATFORM_ENDPOINT=http://localhost:5309

Если вы используете пользовательский порт, замените 5309 на выбранный вами номер порта.

Шаг 3. Запуск вашего агента

Запустите тестовый агент, как обычно. Теперь агент подключается к серверу имитации инструментов, а не к настоящим MCP-серверам.

Шаг 4. Отслеживание активности сервера

В терминале сервера имитации отображается:

Входящие запросы от вашего агента
Имитированные ответы отправляются обратно
Статус подключения и ошибки (при наличии)

Пример журналов сервера:

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

Остановка сервера имитации

Чтобы остановить сервер имитации, используйте Ctrl+C в терминале, где запущен сервер, или закройте окно терминала.

Устранение неполадок

В этом разделе представлена информация о том, как устранять распространенные проблемы с сервером имитации инструментов.

Совет

Руководство по устранению неполадок Agent 365 содержит общие рекомендации по устранению неполадок, лучшие практики и ссылки на материалы по устранению неполадок для каждого этапа жизненного цикла разработки Agent 365.