Наблюдаемость MCP: заключение пятислойного договора о здравоохранении

Наблюдаемость MCP должна ответить на более сложный вопрос, чем совершенствовалась запрос? Для каждой сессии Model Context Protocol, сохранить одну коррелированную цепочку доказательств от авторизации и инициализации через обнаружение инструмента, призыв, внешний эффект и ожидаемый результат пользователя. Зеленый ответ tools/call это только одно звено в этой цепочке. Разумным дефолтом является пятислойный договор о медицинском обслуживании: 1. Session: Вы договорились с клиентом и сервером о поддерживаемой версии протокола и возможностях, которые будет использоваться этим запуском? 2. Catalog: читал ли клиент полный список текущих инструментов и реагировал на более поздний сигнал изменения списка? 3. Запрос: Можете ли вы присоединиться к запросу JSON RPC, уведомлениям о прогрессе, отмене, ответе и сроку? 4. EEffect: Если инструмент изменит внешнюю систему, есть ли доказательства того, что произошло на самом деле? 5. OOutcome: был ли артефакт, изменение состояния или решение агент должен был производить прошли его проверку? Этот контракт намеренно отделяет протокольную деятельность от полезного прогресса. Он также дает оператору конкретное состояние маршрута: needs auth , incompatible session , stale catalog , working , protocol error , tool failed , effect unknown , false success или healthy . Начните с одной цепи доказательств, а не с одного номера панели. Свежие результаты в США по mcp наблюдаемости подчеркивают сессии, подключения, аналитику инструментов, задержку транспорта, пропускную способность и ошибки. Они полезны. Современный Документация о Наблюдаемости МПК Grafana перечисляет установку сеанса, стабильность подключения, соответствие протоколам, производительность инструмента и надежность транспорта. Разница не в том, что эти сигналы неправильны. Отсутствие заключается в том, что ни один из них, в одиночку, не доказывает, что намеченная агентом работа достигла своего назначения. Досье здоровья может оставаться компактным: Хешы это идентификаторы, а не разрешение на загрузку инструментальных схем, аргументов, запросов, токенов или возвращенного контента. Сохраняйте чувствительные ценности у хозяина. Запишите самые маленькие поля, необходимые для соотношения состояния и доказательства решения. В договоре также должно быть правило преимущества. Неудача авторизации происходит до состояния сеанса; несовместимая сессия происходит до свежести каталога; неразрешенный каталог происходит до интерпретации запроса; переходное время транспортировки на границе побочного эффекта становится effect unknown , а не автоматическая повторная попытка; и успешный звонок с отсутствующим доставкой становится false success , не здоровым. Сделайте протокольное состояние наблюдаемым перед измерением латентности инструмента MCP спецификация жизненного цикла делает инициализацию первым взаимодействием клиент сервер. Обе стороны договорились о версии протокола, обмене возможностями, а затем начали нормальную работу. В том же документе говорится, что последующее сообщение должно уважать переговорную версию и возможности. Это дает наблюдаемости чистый первый контрольный пункт: хранить запрошенную версию, принятую версию, набор возможностей и момент, когда клиент отправил notifications/initialized . Не разрушайте каждый провал до этого момента в сервер вниз. Для HTTP транспорт, авторизация является отдельным воротами. Нынешний Спецификация разрешения на MCP определяет открытие защищенных ресурсов и требует от клиентов решения проблемы 401 Unauthorized . Сервер может быть доступен и исправлен, пока клиенту не хватает токена, у него не соответствует охват или он не может обнаружить сервер авторизации. Напишите это как needs auth ; не указывайте его как перерыв в транспорте. Открытие инструментов нуждается в собственном доказательстве полноты. спецификация инструментов говорит, что tools/list настраивается на страницы и что серверы, декларирующие listChanged , могут выпускать notifications/tools/list changed . Поэтому мы получили одну страницу не является свежим каталогом. Запись: возможности инициализации, которые рекламируют инструменты; каждый курсор pagination до тех пор, пока не останется nextCursor ; канонический хэш названий и схемы ввода/вывода; последнее успешное время освежения; любое уведомление о tools/list changed и последующее обновление. Это более узкое, чем запись каждой схемы. Клиент может вычислить хэш локально и сохранить только хэш, количество инструментов, количество страниц и обновление доказательств. Если приходит уведомление о изменении и обновление не удается, классифицируйте сессию stale catalog . Сервер все еще может отвечать на пинг, но модель может выбирать из устаревшего инструментального контракта. Длинные звонки вводят еще одну ловушку. MCP уведомления о прогрессе использует токен, предоставляемый по запросу, который должен быть уникальным среди активных запросов; значения прогресса должны увеличиваться, а уведомления прекращаются после завершения. Эти доказательства могут обосновать working , пока вызов находится в пределах его максимального срока. Это не доказывает, что работа полезна, и она никогда не должна продлевать срок навсегда. Повторяемое сообщение без увеличения значения, токен, прикрепленный к неправильному запросу, или прогресс после терминального ответа являются несоответствующими доказательствами. Используйте два часа: окно бездействия, которое может быть перезагружено на действительный монотонный прогресс; абсолютный максимальный срок, который не может быть пересмотрен. Это различие предотвращает две противоположные ошибки: уничтожение законной длительной работы, потому что она еще не вернулась, и принятие бесконечного потока уведомлений о прогрессе как здоровье. Успешный инструментальный звонок не является результатом MCP отличает ошибки протокола от ошибок выполнения инструмента. Согласно спецификации инструментов, неправильно сформированные запросы и неизвестные инструменты используют ошибки JSON RPC, в то время как бизнес или входные ошибки могут возвращать результат инструмента с isError: true . Держите эти состояния отдельно, потому что следующее действие отличается: зафиксируйте клиентский контракт для protocol error ; корректируйте входы, разрешения или зависимость вдоль потока для tool failed . Более опасный случай отсутствие реакции после возникновения побочного эффекта. Предположим, что publish report раз выходит. Немедленная повторная попытка может создать дублированный отчет, потому что транспортная неопределенность ничего не говорит о месте назначения. Отметьте вызов effect unknown , согласовывайте с использованием стабильного ключа операции или запроса назначения и попытайтесь повторно только после того, как доказательства докажут, что первая попытка не была совершена. Даже нормального результата недостаточно. Сервер может вернуть isError: false , пока обещанный файл отсутствует, удаленная запись по прежнему является чертежом или URL является частным. Добавьте проверку результатов, выбранную до вызова: хэш файла, строка базы данных плюс версия, публичный статус HTTP, результат теста или другой детерминистический квитанция. Используйте судью LLM только тогда, когда результат не может быть проверен напрямую, и помещайте на более слабые доказательства. Это создает три отдельных терминальных состояния: Результат протокола Эффект назначения Ожидаемый результат Состояние здоровья Время отключения неизвестный неизвестный effect unknown Успех проверенные неисправность или отсутствие false success Успех проверенные проверенные healthy Средний ряд важнее всего. Это предотвращает успешный обмен протокола, превращаясь в ложное утверждение о том, что агент завершил задачу пользователя. Повторять контракт против неудобных случаев Сопровождающийся артефакт представляет собой иллюстративный девятиклассный фиксир и детерминистический классификатор. Он не содержит телеметрию производства. Попробуйте: Эта фиксация охватывает один здоровый экспорт и восемь неудобных границ: вызов авторизации, не поддерживаемая версия протокола, не согласованное изменение списка инструментов, длительный звонок с действительным прогрессом, неправильный звонок, ошибка исполнения инструмента, отсрочка после возможного побочного эффекта и успех с отсутствующим результатом доставки. Классификатор вернул один случай в каждом ожидаемом состоянии: Это фальсифицируемая часть метода: изменить доказательства и состояние должно измениться предсказуемо. Если после tools/list changed происходит полное обновление, следует продвинуться вперед в случае устаревшего каталога. В случае, если задержанный звонок получает квитанцию на место назначения, но его проверяющий орган не успеет, он должен перейти от effect unknown к false success . Он достигает healthy только тогда, когда доказательства сессии, каталога, запроса, эффекта и результата согласны. Артефакт не подтверждает правильность бизнес семантики инструмента. Он не обнаруживает недокументированного побочного эффекта, не доказывает, что эмитент OAuth является надежным, и не решает, сколько должен быть срок. Это специальные обзоры. Его задача меньше: не допустить, чтобы отсутствующие доказательства молча делались зелеными. Предупреждение о состоянии, требующем действий Не отправляйте всех нездоровых состояний в один канал. needs auth передается владельцу аккредитации или разрешения с обжалованным ресурсом и требуемым объемом, никогда не знаковое значение. incompatible session переходит к владельцу интеграции с клиентской версией, серверной версией и возможностями переговоров. stale catalog запускает одну попытку ограниченного повторного открытия; повторная неудача становится инцидентом интеграции. working остается тихим, пока прогресс действителен и абсолютный срок остается. protocol error отправляется к клиенту исполнителю с методом, идентификатором запроса и классом дезинфицированной ошибки. tool failed следует политике повторной попытки инструмента только тогда, когда неизвестно, что отказ является обратимым. effect unknown блокирует автоматическую повторную попытку на границе побочного эффекта и запускает примирение. false success открывает исходный инцидент, несмотря на то, что сам MCP завершен. Этот маршрутизатор поддерживает ожидание отличается от stuck. Призыв к авторизации, присвоенный человеку, может быть законным ожиданием; токен прогресса, продвигающийся в пределах ограниченного запроса, может быть рабочим; неизменный каталог после сигнала перечня измены не является ни одним. Начните с одного высокоценного инструмента и одного реального проверщика результатов. Захватить цепочку на неделю, проверить все неизвестные состояния, а затем добавить охват. Совершенная панель управления по всему флоту, построенная на несовместимых событиях, менее полезна, чем один инструмент, чья сессия, эффект и результат могут быть объяснены от конца к концу. Где этот договор прекращается Наблюдаемость MCP может установить протокол и эксплуатационные доказательства, но она не может вывести все намерения пользователя из провода. Действующая схема выпуска доказывает форму, а не правду. Допуск по месту назначения доказывает эффект, а не то, что эффект был мудрым. Монотонный сигнал прогресса доказывает движение, сообщенное сервером, а не полезный прогресс к цели пользователя. Эти границы требуют проверки приложения и иногда человеческого суждения. Sidewisp сейчас находится на этапе закрытого предварительного доступа. Его адаптеры мониторинга производства и системы восстановления обычно не отправляются. Договор в настоящей статье является методом работы и местным артефактом, который может быть проверен, а не утверждением о том, что Sidewisp уже собирает сеансы MCP или ремонтирует их. Целью продукта является облегчение наблюдения за доказательствами здоровья, неопределенностью и границами одобрения в сочетании с существующими сроками эксплуатации. Если вы разрабатываете интеграцию MCP сейчас, держите пятислойный запись локально, редактируйте контент и отказывайтесь называть бег здоровым, пока ожидаемый результат не получит свой собственный результат. Это одно правило превращает протокольную телеметрию в оперативное решение вместо другой зеленой диаграммы.