Перейти к содержимому
Внимание · Документация

Путеводитель для агента

Человекочитаемый компаньон к машинным точкам входа /llms.txt и /docs/agents (они отдаются сервером как обычный текст). Здесь — ориентиры и ссылки в канон.

Аутентификация и формат

  • Каждый запрос — заголовок Authorization: Bearer tak_... (токен заводится в профиле, «Токены API» — создать токен). Токен действует как его владелец, под его ролью.
  • Scope токена: read (только GET) или read_write (GET + мутации).
  • Формат: cookie-клиент получает JSON; токен с Accept: text/markdown (или ?format=md) — Markdown-зеркало ресурса. У ресурсов есть ETag → If-None-Match → 304. Подробнее — Конвенции.
  • site-admin-операции недоступны никакому токену на любом scope.

Кто я и что вижу

Что можно делать с проектом

С токеном read_write (под своей ролью) доступны те же действия, что в UI: создать, сгенерировать граф (SSE), обновить, удалить / восстановить, передать в организацию, сменить владельца, share-ссылка.

Действие, на которое у вашей роли нет права (не тот tier / чужой спейс / чужая организация) → 403 с причиной.

Дизайн-документ проекта

У проекта есть пояснительный документ по блокам: читать целиком или по блоку (с Markdown-зеркалом и ETag), генерировать потоком (SSE) блок или весь документ, править и откатывать версии. Полный список — домен Дизайн-документ.

Коллекции (токен org-admin)

Коллекции — шаблоны, по которым строятся проекты. Под токеном org-admin доступны чтение и управление: список · получить · создать · (пере)генерация (modes + SSE) · содержимое (блоки, слои, специальности, связи) · промпты. Полный список — домен Коллекции. Межорганизационный доступ к коллекции (grant/revoke) — site-admin only, токену недоступно.

Спейсы (рабочие пространства)

Спейс — пространство команды по коллекции с оверлеем (свои правки поверх шаблона). Под токеном доступны чтение (список · спейс с Markdown-зеркалом и ETag · блоки / слои / специальности / связи) и — под ролью менеджера спейса или org-admin — управление оверлеем (переопределить / снять / удалить / вернуть), участниками и наблюдателями. Полный список — домен Спейсы.