Разделы документации
Документация/Настройка

Артефакты control plane и рабочие процессы с AI

ThreadCells публикует документы JSON Schema Draft 2020-12 для ProfileDefinition V1, ProviderConfiguration V1, AdapterManifest V1 и AdapterCapabilities V1 в schemas/v1 локального кандидата и в cli_agent_orchestrator/public_schemas/v1 колеса.

Используйте threadcells profiles schema|example или threadcells providers schema|example, чтобы получить исходный документ. Проверяйте его до импорта. Ошибки полей представляются устойчивыми записями JSON-pointer, а не отображёнными необработанными значениями. Импорт через UI, CLI и API вызывает один и тот же сервис и создаёт неизменяемые ревизии.

Создание артефактов с помощью AI

  1. Получите подходящие schema, пример и безопасный prompt для генерации из /api/v1/profiles/ai-prompt или /api/v1/providers/ai-prompt.
  2. Попросите модель вернуть только один объект JSON. Не передавайте учётные данные, приватные пути, исполняемые команды, флаги оболочки или непроверенные MCP-команды.
  3. Вручную проверьте идентификаторы, ссылки на провайдера, полномочия, инструменты, тайм-ауты и инструкции.
  4. Запустите validate; исправьте каждую проблему JSON-pointer.
  5. Импортируйте только после проверки оператором. Для импортов, требующих wildcard-инструментов или иных привилегированных полномочий, нужен отдельный путь доверенного оператора.
  6. Перед запуском используйте итоговый preview, а после импорта — экспорт, чтобы подтвердить канонический артефакт с удалёнными чувствительными данными.

Сгенерированный AI JSON — недоверенный ввод. Правдоподобный документ не устанавливает код адаптера, не регистрирует возможность MCP, не предоставляет авторизацию владельца и не обходит политику репозитория. Встроенные профили остаются неизменяемыми, а экспорты никогда не содержат учётных данных провайдера или разрешений на запуск.

Создано и поддерживается Субаевым Русланом при участии сообщества ThreadCells. Открыть репозиторий