Практикум: от задачи до результата

Этот практикум связывает части GrantTap в одну историю: подготовить безопасную папку, поручить небольшое изменение агенту, продолжить с телефона, проверить доставку, принять решение и увидеть результат. Он рассчитан на собственный учебный репозиторий, а не на ваш рабочий продукт. Каждый сетевой запрос агенту здесь отправляете вы сами.

[Скачать GrantTap Lab](/guide/granttap-lab.zip) — маленький проект без зависимостей, сети, ключей и AI SDK. В нём один расчёт заказа и шесть тестов. Суммы хранятся целыми копейками. Это учебная модель, а не платёжная система.

1. Подготовить исходную точку#

Распакуйте архив в отдельную папку и откройте её в терминале. Нужен Node.js 22 или новее. Устанавливать зависимости не требуется: проект использует встроенный модуль тестирования Node.

cd granttap-lab
npm test

Ожидаемый исходный результат: 6 тестов прошли, 0 ошибок. Сохраните этот вывод. Он позволит отличить исходное состояние от изменений агента. Если тесты не стартуют, проверьте node --version и что вы открыли папку с package.json; подключение телефона здесь ещё ни при чём.

Если хотите изучить перенос задачи, создайте в этой папке обычный Git-репозиторий и исходный commit. Используйте привычный вам способ. Не добавляйте пароли или файлы из других проектов. Для первого упражнения достаточно работы на одном компьютере: удалённый репозиторий и push не нужны.

2. Подключить правильное место работы#

1. Завершите установку и подключение компьютера.
2. Откройте папку granttap-lab в поддерживаемом coding app. Провайдер должен быть уже установлен и авторизован обычным для него способом.
3. В GrantTap проверьте компьютер, провайдера и рабочую папку выбранного исполнения.
4. Используйте отдельный Project Mesh для учебной работы, если хотите безопасно исследовать Governance.

Название компьютера помогает ориентироваться, но не заменяет его стабильную идентичность. Если у вас два Mac с похожими именами, сначала откройте Devices. Сообщение существующего чата не переедет на другой компьютер только из-за выбора новой карточки.

3. Поставить ограниченную задачу#

Пример задания для вашего агента:

В учебном GrantTap Lab добавь промокод HELLO10:
10% скидки только на товары, без скидки на доставку.
Сначала добавь тесты и покажи их падение, затем реализацию.
Не устанавливай зависимости, не выходи в сеть и ничего не публикуй.
В итоге покажи diff и полный результат npm test.

Вы можете создать новую Task с телефона либо продолжить заранее открытый нативный чат. Не смешивайте эти операции: новая Task получает собственную цель, а сообщение в открытом чате продолжает выбранное исполнение.

Перед Send прочитайте короткую строку маршрута. После принятой отправки клавиатура может закрыться сразу: это удобство интерфейса, а не доказательство, что агент уже начал работу.

4. Проверить путь сообщения#

Откройте статус именно отправленной записи. В деталях должны совпасть ваш текст и исходный чат. Затем читайте этапы по отдельности: локальное сохранение, Saved on relay, получение компьютером, связанная активность и ответ.

Если сообщение быстро сохранилось на реле, а чат на ПК обновился позднее, это ещё не потеря. В главе о доставке разобраны независимые пути отправки и наблюдения истории. Около 30 секунд — возможное наблюдение в конкретной ситуации, а не обещанный срок и не измеренное среднее всей системы.

Сначала используйте Refresh status. Он проверяет исходную операцию. Повторный текст «сделай то же самое» создаёт другую просьбу и может запустить работу дважды. Для очереди используйте Send now или Cancel; для старой локальной записи — Delete, понимая его границы.

5. Ответить на вопрос с контекстом#

Если агент задаёт вопрос, откройте его через Needs You или исходный чат. Прочитайте, к какой задаче и действию он относится. Для уточнения цвета кнопки допустим простой ответ; для разрешения команды важно проверить точный путь, действие и правила проекта.

Вопрос и approval — разные формы. В ответе на вопрос может быть свободный текст, варианты, фотография или файл при совместимом модуле компьютера. Approval относится к конкретному действию. Skip question скрывает вопрос локально; это не ответ агенту.

Не ослабляйте глобальную политику ради первого учебного запуска. Если действие остановлено, посмотрите причину и покрытие Governance. Разрешение в одной форме не отменяет нативный sandbox провайдера.

6. Отличить рассказ от результата#

После ответа откройте Files. Посмотрите список изменённых файлов и diff для этой просьбы. All files показывает доступное дерево рабочей копии; загруженный предпросмотр может быть старее текущего файла. Перечитайте его при доступном компьютере, если нужно проверить свежесть.

На компьютере снова запустите npm test. Проверьте новые случаи: скидка применяется к товарам, доставка не уменьшается, неизвестный промокод не меняет цену, итог остаётся целым числом. Важен полный итог тестов, а не одна зелёная строка из выборки.

Успешно записанный tool result — сообщение провайдера о результате. Он сам по себе не является независимым доказательством изменения файла. В Runtime и аудите объясняется, чем вызов, заявленный успех и отдельное наблюдение с ревизией отличаются друг от друга.

7. Продолжить без дублирования работы#

Добавьте в очередь небольшой follow-up, например просьбу объяснить округление скидки. Убедитесь, что он относится к той же Task. Посмотрите, как очередь ждёт готовности, и изучите подтверждения до нажатия Send now.

Если хотите сменить агента, сначала прочитайте порядок handoff: что зафиксировано в Git, какие файлы останутся на исходном компьютере и где откроется новое исполнение. В старом чате Transferred не означает, что его история должна исчезнуть.

Дальше попробуйте точечные правила возможностей, Knowledge и Usage. Для каждого нового эксперимента задавайте одну цель и заранее решайте, чем подтвердите её выполнение.