REST + OpenAPI
Вызывайте /agent/v1 с помощью Bearer API-ключа. /agent/v1/openapi.json предоставляет описание интерфейса, чтобы инструменты знали доступные запросы.
Пусть ИИ выявит проблему. Вы решаете, что выполнять.
Передайте топологию, метрики, события и диагностику используемым вами ИИ-инструментам. Подключение через REST или MCP, а область ресурсов, разрешения на конфигурацию и предварительную авторизацию исправлений определяете вы.
Подробнее о подключении инструментовПодключите инструменты, которыми вы уже пользуетесь.
Удалённый HTTP MCP
Подключение через /mcp с использованием API-ключа или авторизации OAuth PKCE. REST и MCP используют общие разрешения, задачи и правила аудита.
Один Agent —одна идентичность.
Ресурсы и функции ограничиваются отдельно.
Выберите отдельные ресурсы или все ресурсы аккаунта, а с помощью областей возможностей (Scope) определите, что можно читать, диагностировать или изменять. Область «все ресурсы» также охватывает ресурсы, добавленные позже.
Чтение и диагностика по умолчанию, запись предоставляется отдельно.
Создание, изменение, удаление или публикация конфигураций клиентов, правил маршрутизации трафика, маршрутизации узлов и безопасности источников требует соответствующего разрешения на управление. Создание, выполнение и просмотр задач также требуют разрешения на просмотр задач.
Срок действия и квота — настраиваются по необходимости.
Для каждой идентичности задайте срок действия, квоту вызовов в минуту и дневную квоту задач. API-ключ полностью отображается только один раз — при создании или ротации, поэтому сохраните его в менеджере учётных данных; позже его можно ротировать или отозвать.
Сначала просмотрите диагностику, затем решите, выполнять ли действие.
При нарушении heartbeat узла предоставьте разрешения на диагностику и планирование, чтобы инструмент мог прочитать соответствующую топологию, метрики и события и составить план восстановления. Просмотрите доказательства и план в деталях задачи, а затем решите, какие действия по восстановлению разрешить.
Предварительная авторизация восстановления отдельно выбирает узлы, действия, срок действия и дневной лимит восстановлений. Вы можете разрешить восстановление служб узла, размещение Agent, установку собственного узла или обработку неудачного обновления прошивки; для выполнения также требуется соответствующая область (Scope).
В настоящее время предварительная авторизация восстановления применяется только к узлам без активного Relay. При выполнении проверяются план, ресурсы, идентичность прошивки и состояние работоспособности. Восстановление может ненадолго прервать работу служб узла; при сбое выполнение останавливается, а конкретная причина сохраняется.
Диагностика и исправления — всё фиксируется.
Диагностика, планирование и выполнение фиксируются в виде задач. Доказательства и планы доступны для последующей проверки, а результаты выполнения и повторная проверка состояния узлов отображаются отдельно, что позволяет легко определить, восстановлена ли служба.
Страница подключения AI Agent фиксирует управление Key, предварительную авторизацию клиентов, вызовы интерфейса, выполнение задач и проверку, позволяя находить конкретные задачи по действию, результату и времени.
Подробнее о состоянии и восстановлении узлов →Часто задаваемые вопросы.
Расширяет ли авторизация OAuth существующие права Agent?
Нет. При авторизации вы выбираете командную учетную запись и идентификатор Agent, и приложение может использовать только те права и область ресурсов, которые уже предоставлены этому идентификатору. Токены доступа действительны не более пятнадцати минут; ротация или отзыв API Key также аннулирует исходную авторизацию OAuth.
Если предоставлены права на диагностику, может ли восстановление выполняться автоматически?
Нет. Планирование, выполнение и запросы задач требуют отдельных прав, а для выполнения восстановления дополнительно необходима отдельная предварительная авторизация узла, действия, срока действия и квоты, а также соблюдение условий обслуживания на момент выполнения.
При отзыве идентификатора будут ли отменены уже выданные операции?
Отзыв останавливает новый доступ и еще не выполненное восстановление. Уже отправленные операции продолжают отслеживаться до конечного результата; состояние задач отображается в консоли.