AgentValet/AgentValet

agent_register: Самостоятельно регистрирует этого агента с владельцем. Аутентификация не требуется. Входные данные: owner_id (string), agent_name (string), requested_scopes (массив {platformId, scopes}). Возвращает: registration_token, poll_url, client_id, scope, expires_in. Аутентификация: не требуется.

agent_status: Опрашивает статус регистрации, используя токен из agent_register. Входные данные: token (строка, обязательный). Возвращает: status ("pending_approval"|"approved"|"rejected"), agent_id (если одобрено), mcp_config (если одобрено). Аутентификация: не требуется.

authzen_evaluate: Оценивает, есть ли у этого агента доступ к определённому разрешению (scope) платформы. Вызывайте этот инструмент ПЕРЕД use_platform, если хотите выполнить предварительную проверку без обращения к вышестоящему серверу. Входные данные: platform_id (строка), scope (строка). Возвращает: decision (булево), reason ("approved"|"denied"|"revoked"|"scope_not_granted"). Аутентификация: Bearer agent JWT (отправляется автоматически этим MCP-сервером).

delete_platform: Удаляет данные на платформе, которую владелец подключил, через прокси AgentValet. Вызывает собственный публичный REST API платформы (например, GitHub REST API, Slack Web API, Stripe API); endpoint - это путь в этом API, точно как его определяет документация. Для платформы, чей callStyle равен 'graphql', передавайте "/" в качестве endpoint и помещайте операцию в body в виде {query, variables}: путь и HTTP-метод не имеют значения на этой платформе. Всегда отправляет DELETE. Это удаляет данные, и AgentValet не может обратить это действие. Может блокировать до 50 секунд в ожидании одобрения владельца. Входные данные: platform, endpoint, scope, body (необязательно), connection_id (необязательно), reason (необязательно). Аутентификация: Bearer JWT.

Выдаёт кратковременную учётную запись дочернего агента для сабагента, которого вы собираетесь породить. Дочерний агент получает собственный идентификатор агента, собственный урезанный набор разрешений (области дочернего агента должны быть подмножеством ваших) и собственный журнал аудита; его можно отозвать отдельно, не затрагивая вас или его собратьев. Возвращает bearer-токен, который сабагент должен отправлять в заголовке Authorization. TTL 60-3600 секунд (по умолчанию 900). Внедряйте в контекст сабагента ТОЛЬКО bearer_token, никогда не передавайте собственные учётные данные.

list_my_pending_actions: Возвращает текущие ожидающие запросы на одобрение этого агента, а также любые завершённые за последние 24 часа. Используйте это при запуске сессии, когда пользователь упоминает предыдущее действие, или когда long-poll в use_platform завершился по таймауту и пользователь возвращается с вопросом о том, что произошло. Входные данные: отсутствуют. Возвращает: { pending: [{approval_id, platform_id, scope, created_at, expires_at}], recently_completed: [{approval_id, platform_id, scope, status, executed_at, result_summary, execution_error}] }. Аутентификация: Bearer JWT агента (отправляется автоматически).

list_platforms: Перечисляет платформы и разрешения (scopes), к которым имеет доступ этот агент. Входные данные: нет. Возвращает: { platforms: [{ platformId, platformName, scopes, requireApproval, approvalScopes?, connections?, callStyle? }], version: "<hex>" }. Платформа включает connections, только если у нее есть 2+ доступных аккаунта; передавайте выбранный connection_id в use_platform (опустите его для значения по умолчанию). Стиль вызова: callStyle присутствует только в значении "graphql" и указывает, как ОБРАЩАТЬСЯ к платформе, а не то, какие операции там доступны: у этой платформы ОДИН endpoint, принимающий {query, variables} через POST, поэтому передайте "/" в качестве endpoint, а операцию поместите в тело. Его путь и HTTP-метод не имеют значения, read_platform вообще нельзя использовать на этой платформе, а GET-запрос возвращает ошибку вышестоящего сервиса, в которой не указаны ни платформа, ни причина. Если поле отсутствует, это обычный REST API. Одобрение: вызов требует одобрения человека, если requireApproval платформы равно true (на уровне гранта: при каждом вызове появляется запрос), если requireApproval выбранного подключения равно true, или если scope указан в approvalScopes (на уровне политики: запрос появляется только для этих scope). approvalScopes не указывается, если ни один scope не ограничен политикой. Версия: детерминированный хеш от действующей спецификации: он меняется при изменении набора платформ, scope, требований к одобрению (на уровне гранта или политики) или подключений. Сравните его с Current permissions version, указанной в этом описании: если они отличаются, ваш кешированный результат устарел, и вам нужно снова вызвать list_platforms, прежде чем доверять ему. Аутентификация: Bearer JWT.

read_platform: Читает данные с платформы, которую подключил владелец, через прокси AgentValet. Вызывает собственный публичный REST API платформы (например, GitHub REST API, Slack Web API, Stripe API); endpoint содержит путь в этом API, в точности как указано в его документации. Платформу, которую list_platforms указывает с callStyle 'graphql', этим инструментом прочитать вообще нельзя: она предоставляет ЕДИНЫЙ endpoint, который принимает только POST {query, variables}, поэтому отправляйте запрос на чтение через write_platform (или use_platform с методом POST), даже если это чтение. Запрос GET туда возвращает ошибку вышестоящего сервиса, которая не называет ни платформу, ни причину; это не вина брокера. Всегда выполняет GET: используйте write_platform для создания или обновления, а delete_platform для удаления. Входные данные: platform, endpoint, scope, connection_id (необязательно), reason (необязательно). Возвращает: тело ответа вышестоящего API. Аутентификация: Bearer JWT.

report_self_diagnostic: Отправляет самоотчёт (ошибка/предупреждение/информация) владельцу AgentValet. Используйте после того, как ошибка use_platform вернёт report_hint, ИЛИ заблаговременно, когда вы сталкиваетесь с проблемой, о которой пользователь должен знать. Входные параметры: severity (debug|info|warn|error|critical), message (строка, обязательный, макс. 4096 байт), code (строка, необязательный, макс. 128 символов), platform (строка, необязательный), endpoint (строка, необязательный), correlation_id (uuid строка, необязательный — скопируйте из report_hint от неудачного вызова, чтобы привязать этот отчёт к строке аудита на стороне брокера), context (объект, необязательный, JSON-сериализованный должен быть < 16 КиБ). Возвращает: { id, received_at } в случае успеха. Аутентификация: Bearer agent JWT (отправляется автоматически).

request_platform_access: Запрашивает у администратора организации доступ для этого агента к платформе, от которой он сейчас заблокирован. Вызывайте этот инструмент, когда use_platform возвращает ошибку доступа. Входные параметры: platform (строка, обязательный), scope (строка, опциональный: необходимый объём доступа), reason (строка, опциональный: причина запроса). Вызов ожидает решения администратора до ~50 секунд. Возвращает: { status: "approved"|"pending"|"denied", message }. При статусе "approved" повторите исходный вызов use_platform. При статусе "pending" запрос поставлен в очередь; повторите позже. Аутентификация: Bearer agent JWT (отправляется автоматически).

use_platform: Вызывает внешний API платформы (Airtable, GitHub, Slack, Metabase и т.д.) через прокси AgentValet. Входные данные: platform (string), endpoint (string), method (GET|POST|PUT|PATCH|DELETE), scope (string), body (object, необязательно — тело JSON-запроса для POST/PUT/PATCH/DELETE). Возвращает: тело ответа вышестоящего API. Может занимать до 50 секунд, если для действия требуется одобрение владельца: вызов блокируется в ожидании, затем прозрачно возвращает одобренный результат. Если одобрение не приходит вовремя, возвращает обёртку pending_approval, а действие выполняется асинхронно; пользователь получает уведомление о завершении. Аутентификация: Bearer JWT. Примечание: старые клиенты, передающие data вместо body, всё ещё принимаются для обратной совместимости, но body — каноническое имя.

write_platform: Создаёт или обновляет данные на платформе, которую подключил владелец, через прокси AgentValet. Вызывает собственный публичный REST API платформы (например, GitHub REST API, Slack Web API, Stripe API); endpoint - это путь в этом API, точно такой, как он определён в документации. Для платформы с callStyle 'graphql' передайте "/" в качестве endpoint, а операцию поместите в body как {query, variables}: путь и HTTP-метод на такой платформе не имеют значения. Принимает только POST, PUT или PATCH: для GET используйте read_platform, а для DELETE - delete_platform. Может блокироваться до 50 секунд в ожидании одобрения владельца, затем возвращает одобренный результат; в противном случае возвращает обёртку pending_approval. Входные данные: platform, endpoint, scope, method (необязательно, по умолчанию POST), body (необязательно), connection_id (необязательно), reason (необязательно). Аутентификация: Bearer JWT.