{
  "schema_version": "1.0",
  "publisher": "AI Release",
  "article": {
    "title": "Как ускорить Python-код с помощью ИИ-агента: профилирование и переписывание горячих 5%",
    "canonical_url": "https://ai-release.org/guides/kak-uskorit-python-kod-s-pomoschyu-ii-agenta-profilirov.html",
    "language": "ru",
    "article_type": "руководство",
    "published_at": null,
    "updated_at": "2026-11-22T00:00:00+00:00"
  },
  "summary": "Практическое руководство: как найти узкие места профайлером, отдать агенту только медленные участки и портировать их без переписывания всего проекта целиком. Время выполнения: 40–60 минут на первый проход (профиль + одна правка + проверка) Уровень сложности: Intermediate",
  "topics": [
    "как ускорить Python код",
    "профилирование Python",
    "оптимизация кода с помощью ИИ",
    "как найти узкие места в коде"
  ],
  "entities": [
    {
      "id": "E1",
      "name": "как ускорить Python код",
      "type": "тема/инструмент",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E2",
      "name": "профилирование Python",
      "type": "тема/инструмент",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E3",
      "name": "оптимизация кода с помощью ИИ",
      "type": "тема/инструмент",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E4",
      "name": "как найти узкие места в коде",
      "type": "тема/инструмент",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    },
    {
      "id": "E5",
      "name": "Python",
      "type": "платформа/технология",
      "description": "упоминается в заголовке, TL;DR или разделах гайда",
      "url": null
    }
  ],
  "claims": [
    {
      "id": "AR-GUIDE-KAKUSKORIT-001",
      "statement": "Время выполнения: 40–60 минут на первый проход (профиль + одна правка + проверка)",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/kak-uskorit-python-kod-s-pomoschyu-ii-agenta-profilirov.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "Время выполнения: 40–60 минут на первый проход (профиль + одна правка + проверка)"
    },
    {
      "id": "AR-GUIDE-KAKUSKORIT-002",
      "statement": "Уровень сложности: Intermediate",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/kak-uskorit-python-kod-s-pomoschyu-ii-agenta-profilirov.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "Уровень сложности: Intermediate"
    },
    {
      "id": "AR-GUIDE-KAKUSKORIT-003",
      "statement": "Понадобится: Python 3.9+ (cProfile, pstats — входят в стандартную библиотеку), py-spy, line_profiler, pytest, доступ ИИ-агента к репозиторию (модель и версия агента — сверьтесь с документацией вашего инструмента), тесты проекта, если они есть",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/kak-uskorit-python-kod-s-pomoschyu-ii-agenta-profilirov.html",
      "article_anchor": "#tldr",
      "evidence_excerpt": "Понадобится: Python 3.9+ (cProfile, pstats — входят в стандартную библиотеку), py-spy, line_profiler, pytest, доступ ИИ-агента к репозиторию (модель и версия агента — сверьтесь с документацией вашего инструмента), тесты проекта, если они есть"
    },
    {
      "id": "AR-GUIDE-KAKUSKORIT-004",
      "statement": "ОС: Linux/macOS (в примерах bash) или Windows 10/11 с PowerShell — команды профилирования одинаковые, отличается только активация venv: .venv\\Scripts\\Activate.ps1.",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/kak-uskorit-python-kod-s-pomoschyu-ii-agenta-profilirov.html",
      "article_anchor": "#requirements",
      "evidence_excerpt": "ОС: Linux/macOS (в примерах bash) или Windows 10/11 с PowerShell — команды профилирования одинаковые, отличается только активация venv: .venv\\Scripts\\Activate.ps1."
    },
    {
      "id": "AR-GUIDE-KAKUSKORIT-005",
      "statement": "Python 3.9+ и рабочий venv. Минимальную версию для ваших пакетов сверьте с документацией проекта.",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/kak-uskorit-python-kod-s-pomoschyu-ii-agenta-profilirov.html",
      "article_anchor": "#requirements",
      "evidence_excerpt": "Python 3.9+ и рабочий venv. Минимальную версию для ваших пакетов сверьте с документацией проекта."
    },
    {
      "id": "AR-GUIDE-KAKUSKORIT-006",
      "statement": "Права на запись в каталог проекта: профиль пишется в profile.out в текущей папке.",
      "claim_type": "guide_fact",
      "confidence": "not_assessed",
      "source_type": "заявление источника",
      "verification_status": "reported_unverified",
      "source_url": "https://ai-release.org/guides/kak-uskorit-python-kod-s-pomoschyu-ii-agenta-profilirov.html",
      "article_anchor": "#requirements",
      "evidence_excerpt": "Права на запись в каталог проекта: профиль пишется в profile.out в текущей папке."
    },
    {
      "id": "AR-GUIDE-KAKUSKORIT-007",
      "statement": "Ошибка: error: externally-managed-environment",
      "claim_type": "guide_fact",
      "confidence": "editorial_assessment",
      "source_type": "анализ AI Release",
      "verification_status": "editorial_analysis",
      "source_url": "https://ai-release.org/guides/kak-uskorit-python-kod-s-pomoschyu-ii-agenta-profilirov.html",
      "article_anchor": "#problems",
      "evidence_excerpt": "Ошибка: error: externally-managed-environment"
    },
    {
      "id": "AR-GUIDE-KAKUSKORIT-008",
      "statement": "Причина: в Debian/Ubuntu новые версии Python блокируют установку пакетов в системное окружение (механизм PEP 668).",
      "claim_type": "guide_fact",
      "confidence": "editorial_assessment",
      "source_type": "анализ AI Release",
      "verification_status": "editorial_analysis",
      "source_url": "https://ai-release.org/guides/kak-uskorit-python-kod-s-pomoschyu-ii-agenta-profilirov.html",
      "article_anchor": "#problems",
      "evidence_excerpt": "Причина: в Debian/Ubuntu новые версии Python блокируют установку пакетов в системное окружение (механизм PEP 668)."
    }
  ],
  "relationships": [
    {
      "subject": "Гайд",
      "predicate": "описывает",
      "object": "Как ускорить Python-код с помощью ИИ-агента: профилирование и переписывание горячих 5%",
      "claim_id": "AR-GUIDE-KAKUSKORIT-001"
    },
    {
      "subject": "Гайд",
      "predicate": "содержит шаг",
      "object": "Шаг 1. Профилирование: найти горячие 5%",
      "claim_id": "AR-GUIDE-KAKUSKORIT-001"
    }
  ],
  "questions_and_answers": [
    {
      "question": "Что это за материал?",
      "answer": "Практическое руководство: как найти узкие места профайлером, отдать агенту только медленные участки и портировать их без переписывания всего проекта целиком.",
      "claim_ids": [
        "AR-GUIDE-KAKUSKORIT-001"
      ],
      "article_anchor": "#suschnost"
    },
    {
      "question": "Что понадобится?",
      "answer": "ОС: Linux/macOS (в примерах bash) или Windows 10/11 с PowerShell — команды профилирования одинаковые, отличается только активация venv: .venv\\Scripts\\Activate.ps1.; Python 3.9+ и рабочий venv. Минимальную версию для ваших пакетов сверьте с документацией проекта.; Права на запись в каталог проекта: профиль пишется в…",
      "claim_ids": [
        "AR-GUIDE-KAKUSKORIT-003"
      ],
      "article_anchor": "#requirements"
    },
    {
      "question": "Как это сделать?",
      "answer": "Шаг 1. Профилирование: найти горячие 5% → Шаг 2. Переписывание горячей функции агентом → Шаг 3. Проверка результата: тесты и замер",
      "claim_ids": [
        "AR-GUIDE-KAKUSKORIT-004"
      ],
      "article_anchor": "#step-1"
    },
    {
      "question": "Что может пойти не так?",
      "answer": "Ошибка: error: externally-managed-environment",
      "claim_ids": [
        "AR-GUIDE-KAKUSKORIT-006"
      ],
      "article_anchor": "#problems"
    }
  ],
  "limitations": [
    "Ошибка: error: externally-managed-environment",
    "Причина: в Debian/Ubuntu новые версии Python блокируют установку пакетов в системное окружение (механизм PEP 668).",
    "Решение: не ставьте пакеты глобально — активируйте venv и повторите:",
    "Ошибка: ValueError: operands could not be broadcast together with shapes (1000000,) (999999,)"
  ],
  "citation": {
    "preferred_citation": "AI Release. Как ускорить Python-код с помощью ИИ-агента: профилирование и переписывание горячих 5%. https://ai-release.org/guides/kak-uskorit-python-kod-s-pomoschyu-ii-agenta-profilirov.html",
    "canonical_url": "https://ai-release.org/guides/kak-uskorit-python-kod-s-pomoschyu-ii-agenta-profilirov.html",
    "publisher": "AI Release"
  }
}