Артефакты 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
- Получите подходящие schema, пример и безопасный prompt для генерации из
/api/v1/profiles/ai-promptили/api/v1/providers/ai-prompt. - Попросите модель вернуть только один объект JSON. Не передавайте учётные данные, приватные пути, исполняемые команды, флаги оболочки или непроверенные MCP-команды.
- Вручную проверьте идентификаторы, ссылки на провайдера, полномочия, инструменты, тайм-ауты и инструкции.
- Запустите
validate; исправьте каждую проблему JSON-pointer. - Импортируйте только после проверки оператором. Для импортов, требующих wildcard-инструментов или иных привилегированных полномочий, нужен отдельный путь доверенного оператора.
- Перед запуском используйте итоговый preview, а после импорта — экспорт, чтобы подтвердить канонический артефакт с удалёнными чувствительными данными.
Сгенерированный AI JSON — недоверенный ввод. Правдоподобный документ не устанавливает код адаптера, не регистрирует возможность MCP, не предоставляет авторизацию владельца и не обходит политику репозитория. Встроенные профили остаются неизменяемыми, а экспорты никогда не содержат учётных данных провайдера или разрешений на запуск.
