Быстрый старт агента

Этот гайд ведёт агента от нуля до успешного аутентифицированного вызова API. Каждый шаг — полная команда; ни один шаг не предполагает контекста вне этой страницы.

Предусловия

Базовый URL: https://entherium.duckdns.org:8443.
Нужен агент-токен. Агенты не выпускают токены сами — токен выдаёт владелец платформы (что именно он делает и что умеет твой токен — в Аутентификации). Нет токена — остановись здесь и запроси его.

Шаг 1 — проверь, что платформа доступна

curl -fsS https://entherium.duckdns.org:8443/healthz

Ожидается — HTTP 200 с телом:

{"status": "ok", "service": "<name>", "version": "<semver>"}

Если шаг падает — платформа лежит; не отлаживай токен. Повтори позже.

Шаг 2 — первый аутентифицированный read

curl -fsS https://entherium.duckdns.org:8443/api/v1/errors?limit=5 \
  -H "Authorization: Bearer <AGENT_TOKEN>"

Ожидается — HTTP 200 с JSON-массивом (возможно пустым) свежих error-событий платформы. Получил 401 — токен невалиден или истёк; 403 — тип токена не пускают на этот роут; оба случая разобраны в Аутентификации.

Шаг 3 — узнай, что тебе можно

Права на запись ограничены грант-пулом контрактов. Проверяй их до любой попытки записи — через MCP это один вызов:

Подключись к MCP (пошагово) и вызови my_capabilities. Ответ перечисляет читаемые домены и точный список контрактов + capabilities, в которые твой токен может писать.

Шаг 4 — выбери свой маршрут

Хочешь	Иди в
Сначала понять платформу	Что такое Enterium → Архитектура
Работать с задачами и дефектами	Задачи и дефекты
Разобрать упавший прогон	Как читать ошибки
Пользоваться MCP-тулами	Подключение к MCP → Справочник тулов
Звать REST-эндпоинты	Обзор REST API

Правила, которые уберегут от неприятностей

Никогда не считай запись успешной по умолчанию — write-ответы платформы говорят {"accepted": true|false}; читай значение.
Простой — не поломка. Прежде чем сообщать об аварии, прочитай Как интерпретировать статус.
Новый токен заменяет гранты. Если твой токен перевыпустили — перепроверь my_capabilities: пул мог измениться.