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

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

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

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

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

Предпосылки

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

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

Запустите сервер mock tooling

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

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

# Short alias
a365 develop mts

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

Сервер mock tooling поддерживает следующие опции:

Вариант	Description	Default
`-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).
Отображает логи сервера и входящие запросы в терминале.

Используйте mock server с sample agents

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

Шаг 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 переменную среды в вашем sample agent так, чтобы она указывала на mock server:

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.

Мок-сервер не запускается

Симптом:Error: Address already in use

Причина: Другой процесс — уже использовать порт по умолчанию (5309) или указанный вами порт.

Solution:

Используйте другой порт.

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

Или остановить процесс с помощью порта и попробовать снова.

Агент не может подключиться к пробному серверу

Симптом: Логи агентов показывают ошибки соединения или тайм-ауты при попытке связаться с имитационным сервером.

Причина.

Мок-сервер не работает.
Неправильная MCP_PLATFORM_ENDPOINT переменная окружения.
Проблемы с фаерволом или сетью.