Что такое ИИ-агент для трассировки: MCP и OpenTelemetry закрыли разрыв в отладке

Чтобы понять, что такое ИИ-агент в контексте трассировки, представьте программу, которая сама решает, какой инструмент вызвать, какой API запросить и в каком порядке действовать. Один пользовательский запрос может пройти через хост-приложение, SDK, MCP-сервер и несколько зависимых систем. Без общего контекста отладка превращается в гадание: непонятно, где задержка и кто виноват. Именно эту проблему решают два обновления, о которых сообщили спецификация MCP от 28 июля и доклады на Japan Community Day перед KubeCon + CloudNativeCon Japan в тот же день.

Что понадобится

• Понимание базовых концепций MCP (хост, клиент, сервер)
• Установленный MCP SDK на Python или C#
• OpenTelemetry-совместимый бэкенд для сбора трейсов (Jaeger, Grafana Tempo или аналог)
• Спецификация MCP редакции 2026-07-28 (описания изменений в SEP-414 и SEP-2577)
• Примерно 2 часа на первую настройку сквозной трассировки

Что изменилось в MCP 2026-07-28?

Редакция MCP от 28 июля 2026 года закрепила передачу контекста трассировки по стандарту W3C Trace Context. Для этого в поле _meta внутри params используются три ключа:

• traceparent
• tracestate
• baggage

Для этих ключей сделано исключение из общего правила DNS-префиксов в _meta. Без исключения разные реализации могли бы выбрать разные имена (например, io.modelcontextprotocol.traceparent), и тогда они не смогли бы продолжать один трейс.

Базовый протокол стал stateless (без сохранения состояния между запросами). Из обязательного ядра удалены initialize, initialized и заголовок Mcp-Session-Id. Версия протокола, идентификация клиента и контекст трассировки теперь передаются в _meta каждого запроса. Прокси, балансировщики и шлюзы теперь меньше зависят от скрытого состояния сессии.

Одновременно MCP начал выводить из протокола встроенный механизм Logging. Для структурированной телеметрии (систематического сбора данных о работе системы) предлагается использовать OpenTelemetry. Переходное окно составляет минимум двенадцать месяцев.

Пошаговая инструкция: сквозной трейс от приложения до внешнего API

1. Убедитесь, что ваш MCP SDK поддерживает редакцию 2026-07-28. Передача контекста уже работала в C# и Python SDK, Logfire, инструментации OpenInference и Envoy AI Gateway. Теперь имена ключей зафиксированы в протоколе.

2. Сформируйте запрос с traceparent в _meta. Пример из спецификации:

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_weather",
    "arguments": {
      "location": "New York"
    },
    "_meta": {
      "traceparent": "00-0af7651916cd43dd8448eb211c80319c-00f067aa0ba902b7-01"
    }
  }
}

1. На стороне MCP-сервера извлеките контекст из _meta. Сам протокол не создаёт спаны (span, единица работы внутри трейса) автоматически. Клиенты, серверы и вызываемые ими компоненты должны сами извлечь контекст, продолжить трейс и экспортировать данные.

2. Настройте экспорт в OpenTelemetry-совместимый бэкенд. Один trace_id сохраняется при переходе от приложения к MCP-серверу и вызываемому API. Трейс собирается в бэкенде вместе с телеметрией остальных сервисов.

3. Проверьте, что в одном трейсе видны все звенья цепочки:

4. сколько времени модель принимала решение
5. какой инструмент был выбран
6. сколько занял вызов MCP-сервера
7. где возникла ошибка

8. какой зависимый сервис стал причиной задержки

9. Замените встроенный Logging на OpenTelemetry для структурированной телеметрии. Logging не удаляют сразу, но новым реализациям рекомендуют переходить уже сейчас.

Куда движется OpenTelemetry в части ИИ-агентов?

На Japan Community Day 28 июля и KubeCon Japan 29 и 30 июля прошли доклады, посвящённые наблюдаемости ИИ-агентов. После получения статуса graduated (завершение инкубации в CNCF) в мае 2026 года OpenTelemetry перечислил направления развития:

• семантические соглашения для генеративного ИИ и агентных сценариев
• наблюдаемость браузерных и мобильных приложений
• управление схемами телеметрии через Weaver (инструмент для описания, проверки и документирования семантических соглашений)
• упрощение установки через Packaging (набор APT- и RPM-пакетов)
• развитие Injector (библиотека, которая при запуске процесса подключает агенты автоинструментации без правки кода приложения)

Одного trace_id для ИИ-систем пока недостаточно. Семантические соглашения (правила, как единообразно описывать вызов модели, вызов инструмента, шаг агента, ошибку политики) ещё развиваются. Наблюдаемость агентов нельзя считать полностью стандартизированной, но механизм передачи и корреляции контекста уже описан.

Факт выступления с докладом на KubeCon Japan, одной из крупных конференций по облачной инфраструктуре, говорит о том, что агентная наблюдаемость перешла из экспериментальной области в рабочую повестку индустрии.

Что делать с этим прямо сейчас, по ролям

Разработчику ИИ-агентов. Обновите MCP SDK до редакции 2026-07-28 и убедитесь, что traceparent передаётся в каждом запросе. Замените встроенный Logging на экспорт в OpenTelemetry. Это снизит затраты на отладку цепочек, проходящих через локальные API и внешние сервисы.

Автору Дзена, который пишет о технологиях. Понимание того, что такое ИИ-агент и как устроена его трассировка, даёт вам экспертный угол для контента. Тема агентной наблюдаемости пока слабо покрыта на русском языке, и статья с конкретными примерами запросов привлечёт технически грамотную аудиторию.

Техническому руководителю. Если ваша команда строит продукт с ИИ-агентами, закладывайте OpenTelemetry в архитектуру сейчас. Переходное окно по Logging составляет минимум 12 месяцев, но откладывать миграцию значит копить технический долг.

Главный вывод: журнал действий агента показывает его собственные шаги, а сквозной трейс связывает эти шаги с MCP-сервером, внешними API и инфраструктурой. Механизм для этой связи теперь зафиксирован в протоколе. Осталось его внедрить.