Итоговый проект по ИИ-рабочему процессу: создайте и проверьте JSON-отчёт
Table of Contents
Вернуться к курсу «Практический ИИ-рабочий процесс»
Создайте новый формат вывода и подтвердите его работу. Ранее вы добавили фильтр статуса. Этот итоговый проект начинается с новой лабораторной копии и добавляет JSON-отчёт, который прочитает другая программа. Новое требование проверяет, умеете ли вы переносить рабочий процесс на другую функцию.
Результат обучения: вы подготовите проверенный JSON-отчёт, журнал доказательств по источникам и инструментам и передачу, понятную новой сессии.
Главное
- Отдельное требование определяет функцию итогового проекта.
- Изменение агента-программиста ограничено названными файлами.
- Независимые проверки определяют приёмку.
- Передача новой сессии позволяет восстановить ход работы.
Перед началом
Предварительные требования: завершите уроки 0–10, включая контекст репозитория, первое задание по программированию, MCP или его вариант в браузере, делегирование и ограниченные циклы. Урок 11 необязателен. Выделите 90–120 минут. Сложность средняя.
Используйте свежую распаковку
стартовой лабораторной работы
. До любых изменений выполните python3 task_report.py tasks.json и два базовых теста. В Windows используйте py -3, если в настройке задействован Python Launcher. Создайте локальную исходную точку Git, как при настройке курса. Фильтр статуса из урока 5 намеренно отсутствует.
Прочитайте docs/capstone-requirements.md, редакция 1. Требование задаёт --format text|json. Текстовый вывод по умолчанию остаётся Total tasks: 4. JSON-вывод содержит числовой итог и количество записей для каждого статуса в данных. Проверьте пустой список, отсутствующий статус и неподдерживаемый формат. Не используйте docs/requirements.md как источник требований для этой новой функции.
Выберите маршрут. Подключённый маршрут использует наблюдаемое изменение от агента-программиста, реальный вызов MCP только для чтения и нативного worker или отдельную сессию worker. Учебный маршрут использует чат-ассистента для предложения кода, браузерный источник вместо MCP и отдельные чаты в роли симулированных worker. Недоступные шаги с инструментами отметьте «не запускались». Оба маршрута требуют локальных тестов и проверки файлов. Ключ ответов ниже содержит полные файлы для восстановления. Сохраните первую попытку в заметках, прежде чем копировать ключ в свежую распаковку.
Контрольная точка 1: Бриф проекта
Откройте синтетический учебный проект ChatGPT или Claude. Попросите составить напоминание из двух предложений. Сверьте время 19:00 с approved-schedule.md. Расписание задаёт время напоминания. Требование проекта задаёт программу.
Доказательство: запишите имя проекта, редакцию источника, время из наблюдаемого черновика и исправления. Не отправляйте сообщение.
Контрольная точка 2: Контекст репозитория
Откройте свежую лабораторию. Создайте краткий AGENTS.md со ссылками на docs/capstone-requirements.md, task_report.py, тесты и команду проверки, подтверждённую при настройке. Если вы используете Claude Code, подключите общий файл через CLAUDE.md. Создайте человеческий setup-коммит для этих файлов с инструкциями, затем убедитесь, что git status --short не выводит изменений. Агент-программист не должен коммитить изменение функции.
Доказательство: сохраните карту и чистую копию инструкций. Запишите JSON-ключи и поведение при недопустимых входных данных из редакции 1. Если в предыдущем чате обсуждался фильтр статуса, считайте это контекстом другой задачи.
Контрольная точка 3: Внешний источник
Подключённый маршрут: используйте
сервер OpenAI Docs MCP только для чтения
через совместимый клиент. Попросите инструмент MCP вернуть актуальные рекомендации для AGENTS.md. Запишите имя инструмента, URL источника и полезный для лаборатории пункт. Затем удалите учебное подключение.
Учебный маршрут: откройте в браузере
официальную документацию AGENTS.md
. Запишите заголовок, URL и полезный пункт. Поиск и запуск MCP отметьте как «не запускались».
Доказательство: запись настроенного сервера не доказывает его использование. Подключённый маршрут требует видимого вызова инструмента и полученного содержимого источника.
Контрольная точка 4: Делегирование одной проверки
Попросите worker с доступом только на чтение изучить docs/capstone-requirements.md, task_report.py и базовые тесты. Запросите отчёт максимум из пяти строк с отсутствующими проверками и путями файлов. В учебном маршруте используйте отдельный чат и обозначьте его как симуляцию worker.
Ожидаемый результат: стартовые тесты проверяют общий итог и значение JSON, которое не является списком. Они не проверяют JSON-вывод, пустой список, отсутствующий статус или неверный формат. Самостоятельно откройте тестовый файл и проверьте отчёт. Короткая независимая проверка полезна, поскольку критерии приёмки отличаются от урока 5.
Доказательство: сохраните краткий отчёт и решение об интеграции одним предложением. Храните стенограмму worker отдельно от основного журнала задачи.
Контрольная точка 5: Запрос на изменение
Передайте агенту-программисту следующий пакет. В учебном маршруте чат-ассистент предлагает исправление, которое вы вручную применяете в лаборатории.
Цель: добавить --format text|json после пути к JSON-файлу.
Источник: docs/capstone-requirements.md, редакция 1.
Разрешённые изменения: task_report.py и tests/test_task_report.py.
Сохранить: вывод Total tasks: 4 по умолчанию и tasks.json без изменений.
JSON: один объект с total и счётчиками by_status, без дополнительного текста в stdout.
Обязательные проверки: текстовый режим по умолчанию и явно заданный, JSON 4/2/2,
пустой список, отсутствующий статус, неверный формат и базовые тесты.
Остановиться при: конфликте источников, постороннем сбое базового теста или изменении вне области.
Отчёт: изменённые файлы, команды, наблюдаемый вывод, нерешённая проблема.
Не коммитить, не отправлять push, не публиковать и не отправлять сообщения.
Проверьте план перед изменениями. Выбор схемы важен: total — число, а не строка "4". by_status содержит каждый статус из входных данных, включая будущие значения. Ограничьте изменение распакованной лабораторией.
Контрольная точка 6: Проверка и ревью
Выполните эти проверки самостоятельно. В Windows замените python3 на py -3. Порядок ключей и пробелы в JSON не имеют значения. Разберите вывод как JSON и сравните типы значений.
git status --short
git diff -- task_report.py tests/test_task_report.py
python3 -m unittest discover -s tests -v
python3 task_report.py tasks.json
python3 task_report.py tasks.json --format text
python3 task_report.py tasks.json --format json
python3 task_report.py tasks.json --format invalid
Ожидаемое поведение: тесты проходят. Обе текстовые команды выводят Total tasks: 4. Команда JSON возвращает один объект с total 4, by_status.open 2 и by_status.done 2. Неверный формат завершает работу с ненулевым кодом. Тесты также покрывают пустые данные и задачу без строкового status. Прочитайте наблюдаемый текст ошибки и код завершения для этих случаев.
| Контрольная точка | Доказательство успеха | Восстановление после сбоя |
|---|---|---|
| Бриф проекта | В напоминании указано 19:00 | Обновить источник расписания |
| Карта репозитория | Названы требование и пути тестов | Исправить файлы инструкций |
| Внешний источник | Источник MCP прочитан или описан вариант с браузером | Проверить подключение или URL |
| Проверка worker | Отсутствующие тесты подтверждены в файле | Исправить отчёт worker |
| Область файлов | Изменены только программа и тесты | Проверить каждое лишнее изменение |
| Поведение | Проверены текст, JSON, пустой ввод и ошибки | Найти одну причину и повторить проверку |
| Передача | Новая сессия восстанавливает состояние | Добавить недостающий источник или результат |
Для безопасного сброса используйте новую распаковку. Сохраните заметки вне лаборатории, удалите только одноразовую распакованную копию и снова распакуйте исходный ZIP. Не выполняйте общий сброс Git в репозитории с нужной вам работой.
Контрольная точка 7: Передача новой сессии
Подготовьте передачу менее чем на 180 слов вне каталога лаборатории. Укажите редакцию требования, изменённые файлы, точную команду теста и результат, текстовый и JSON-вывод, проверки недопустимых входных данных, журнал использования и следующий шаг. Откройте новую сессию и попросите назвать JSON-ключи и определить, прошла ли функция проверку.
Ожидаемый ответ: новая сессия называет total и by_status, указывает редакцию 1, сообщает только о наблюдавшихся проверках и отмечает пропущенные.
Ключ ответов и критерии оценки
Ниже приведена допустимая реализация. Сохраните первый блок как task_report.py, а второй как tests/test_task_report.py в свежей распаковке лаборатории. Не изменяйте tasks.json и оба файла требований. Выполните проверки из контрольной точки 6. Сравните другие решения с требованием и наблюдаемым поведением.
task_report.py:
"""Выводит текстовый итог или JSON-сводку учебных задач."""
import argparse
import json
import sys
from collections import Counter
from pathlib import Path
def load_tasks(path: Path) -> list:
tasks = json.loads(path.read_text(encoding="utf-8"))
if not isinstance(tasks, list):
raise ValueError("task data must be a list")
for index, task in enumerate(tasks, start=1):
if not isinstance(task, dict) or not isinstance(task.get("status"), str):
raise ValueError(f"task {index} needs a string status")
return tasks
def count_tasks(path: Path) -> int:
return len(load_tasks(path))
def summarize_tasks(path: Path) -> dict:
tasks = load_tasks(path)
counts = Counter()
for task in tasks:
counts[task["status"]] += 1
return {"total": len(tasks), "by_status": dict(sorted(counts.items()))}
def main() -> int:
parser = argparse.ArgumentParser(description="Отчёт по учебным задачам")
parser.add_argument("path", type=Path, help="путь к списку задач в JSON")
parser.add_argument("--format", choices=("text", "json"), default="text")
args = parser.parse_args()
try:
if args.format == "json":
print(json.dumps(summarize_tasks(args.path)))
else:
print(f"Total tasks: {count_tasks(args.path)}")
except (OSError, ValueError) as exc:
print(f"Error: {exc}", file=sys.stderr)
return 1
return 0
if __name__ == "__main__":
raise SystemExit(main())
tests/test_task_report.py:
"""Проверки текстовых отчётов и JSON-сводок учебных задач."""
import json
import subprocess
import sys
import tempfile
import unittest
from pathlib import Path
from sys import path as module_path
ROOT = Path(__file__).resolve().parents[1]
module_path.insert(0, str(ROOT))
from task_report import count_tasks # noqa: E402
def run_report(path: Path, *options: str) -> subprocess.CompletedProcess:
return subprocess.run(
[sys.executable, str(ROOT / "task_report.py"), str(path), *options],
capture_output=True, text=True, check=False,
)
class TaskReportTests(unittest.TestCase):
def test_counts_four_sample_tasks(self):
self.assertEqual(count_tasks(ROOT / "tasks.json"), 4)
def test_rejects_non_list_data(self):
with tempfile.TemporaryDirectory() as directory:
sample = Path(directory) / "invalid.json"
sample.write_text(json.dumps({"tasks": []}), encoding="utf-8")
with self.assertRaises(ValueError):
count_tasks(sample)
def test_default_and_explicit_text(self):
for options in ((), ("--format", "text")):
result = run_report(ROOT / "tasks.json", *options)
self.assertEqual(result.returncode, 0)
self.assertEqual(result.stdout.strip(), "Total tasks: 4")
def test_json_counts_and_types(self):
result = run_report(ROOT / "tasks.json", "--format", "json")
self.assertEqual(result.returncode, 0)
self.assertEqual(json.loads(result.stdout), {
"total": 4, "by_status": {"open": 2, "done": 2},
})
def test_empty_list(self):
with tempfile.TemporaryDirectory() as directory:
sample = Path(directory) / "empty.json"
sample.write_text("[]", encoding="utf-8")
result = run_report(sample, "--format", "json")
self.assertEqual(result.returncode, 0)
self.assertEqual(json.loads(result.stdout), {
"total": 0, "by_status": {},
})
def test_missing_status(self):
with tempfile.TemporaryDirectory() as directory:
sample = Path(directory) / "missing.json"
sample.write_text('[{"id": 1}]', encoding="utf-8")
for options in ((), ("--format", "json")):
result = run_report(sample, *options)
self.assertNotEqual(result.returncode, 0)
self.assertIn("status", result.stderr)
def test_invalid_format(self):
result = run_report(ROOT / "tasks.json", "--format", "invalid")
self.assertNotEqual(result.returncode, 0)
self.assertIn("invalid", result.stderr)
if __name__ == "__main__":
unittest.main()
Сбросьте лабораторию после использования ключа: сохраните заметки вне лаборатории, удалите распакованную копию и снова распакуйте исходную стартовую лабораторию. В новой копии будут два базовых теста и не будет реализации функции.
Начислите по баллу за каждую точку в таблице выше. Семь баллов завершают подключённый маршрут, если в строке внешнего источника указан реальный вызов MCP, а в строке worker задокументирована реальная сессия. Семь баллов завершают учебный маршрут, если источник — проверенная страница браузера, а шаги с инструментами явно отмечены как незапущенные. Отсутствие проверки поведения, источника или области файлов блокирует оба маршрута.
Проверьте понимание
- Какое требование определяет эту функцию?
docs/capstone-requirements.md, редакция 1. Предыдущее требование к фильтру статуса относится к уроку 5. - Что подтверждает JSON-контракт? Разберите вывод команды, сравните числовые значения и счётчики каждого статуса, проверьте пустые и неверные входные данные. Аккуратного резюме агента недостаточно.
Устранение неполадок
- Базовый тест не проходит до изменений: восстановите лабораторию из ZIP и повторите настройку.
- Агент изменил другой файл: проверьте diff и восстановите только лишнее изменение лаборатории.
- Не работает подключение MCP: используйте источник в браузере и отметьте точку как учебный маршрут.
- Worker повторяет неверное значение: перечитайте требование проекта и исправьте отчёт.
- Закончились попытки: сохраните журнал ошибок и попросите человека-рецензента указать следующий шаг.
Что дальше
Сохраните журнал доказательств. Для продвинутой командной публикации и полномочий между системами продолжите курс «Внедрение совместной работы с ИИ» .
Навигация по курсу: Предыдущий обязательный урок: ограниченные циклы , Необязательно: оценка специализированных агентов , План курса .