С чего начать
Проект, машина и фраза. Пять минут для человека у машины, и 1ADK не нужно давать никакого доступа.
Пока идёт анализ и после него
Что происходит с каждым ответом до того, как он покинет машину, и после, и как читать проект, когда результат попал в него.
- Документация Подключённый анализ Анализ приходит небольшими порциями работы. Кодовый агент отвечает на каждую, 1adk-agent сверяет ответ с контрактом и защитой приватности до отправки, а сервер проверяет его снова. Как устроены остановка, продолжение и коммит посреди анализа. Что происходит, пока кодовый агент анализирует систему?
- Документация Как читать результат Что показывает каждая часть проекта: карта системы и её подсистемы, реестр интерфейсов, доказательства под каждым утверждением, вопросы без ответа, то, насколько система изучена, сравнение анализов и выгрузка. Что я вижу, когда анализ попал в проект?
Правила под капотом
Страницы протокола описывают тот же механизм как спецификацию: о чём просят агента, чего ему нельзя и как сравниваются два анализа.
- Протокол Задание на сканирование Задание на сканирование — ограниченная задача с сроком и явными правилами: только чтение, ничего не запускается, никаких секретов, только относительные пути, текст репозитория считается данными, а не инструкциями, и сетевое правило, разное для подключённого агента и для ручной работы. Что агенту вообще разрешено делать во время анализа 1ADK?
- Протокол Формат Evidence Package Один JSON-файл, описывающий систему: сущности, структура, связи, интерфейсы, данные, утверждения, доказательства, неизвестное и охват. Для чего нужен каждый раздел и для чего в формате намеренно нет поля. Что такое Evidence Package?
- Протокол Снимки и изменения Тождество — трудная задача за любым инструментом, который следит за архитектурой во времени. Как компоненты узнаются между анализами, почему охват решает, что можно сообщить как удалённое, и что такое смысловая разница. Как понять, что два анализа описывают один и тот же компонент?