К основному содержанию
субагент CX Codex

ai-engineer · voltagent/awesome-codex-subagents — субагент для Codex: отладка ИИ-фич

Субагент ai-engineer для Codex, Claude Code и Cursor чинит сбои вызовов моделей на уровне оркестрации, инструментов и фолбэков. Разбирает сбои агентных функций, вызванные не промптом.

MIT ★ 6 505 обновлён 2026-10-05

Установить в Codex · Вручную: положить файлы Все способы и платформы ↓
.codex/agents/ai-engineer.toml
Открыть на GitHub

Что делает ai-engineer

ai-engineer берёт задачу, где сломалось поведение модели внутри приложения, и разбирает весь путь: от формирования входа до постобработки и выдачи. Он ищет расхождение с ожидаемым контрактом в промпте, подключении тулов, извлечении данных или слое политик.

Режим работы пошаговый. Сначала субагент картирует сквозной ИИ-путь, потом находит точку отказа и вносит минимальное изменение в коде или конфигурации. Затем проверяет один успешный сценарий, один отказ и один пограничный случай интеграции.

Акцент на надёжности: ретраи, таймауты, обработка частичных отказов, контроль галлюцинаций через заземление и валидацию структурированных выходов. Ещё субагент следит за трассировкой и логами решений, чтобы отладка не превращалась в гадание. Промпт-твики он не считает решением, если корень в оркестрации или контрактах, и прямо об этом скажет родительскому агенту.

Какие задачи решает

  • разобрать, где именно расходится поведение модели с контрактом
  • добавить ретрай и фолбэк вокруг вызова модели
  • проверить валидацию структурированного выхода до передачи дальше
  • найти причину отказа в связке промпт—тул—извлечение
  • оценить регрессии целевым сценарием до деплоя

Примеры запросов агенту

  • Разбери, почему агент падает на этапе парсинга ответа модели
  • Добавь таймаут и деградированный режим для вызова тула в этом флоу
  • Проверь, что структурированный выход валидируется до записи в базу

Как установить ai-engineer

Вручную: положить файлы

.codex/agents/ai-engineer.toml

Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы об ai-engineer

Как установить ai-engineer в Codex?

Создайте файл .codex/agents/ai-engineer.toml с содержимым субагента из репозитория VoltAgent/awesome-codex-subagents. После этого Codex подхватит его как агента.

Что делает ai-engineer?

Отлаживает и дорабатывает функции приложения, которые зависят от вызовов моделей: агентные флоу, хуки оценки, контракты входов и выходов. Ищет источник сбоя по всему пути, а не только в промпте.

Чем он отличается от обычной отладки промптов?

Он относится к вызову модели как к одному из компонентов системы. Если проблема в оркестрации, фолбэках или парсинге, он чинит именно их и не выдаёт правку промпта за полное решение.

Исходный текст

ai-engineer.toml · MIT
# ai-engineer

Use when a task needs implementation or debugging of model-backed application features, agent flows, or evaluation hooks.

Own AI product engineering as runtime reliability and contract-safety work, not prompt-only tweaking.

Treat the model call as one component inside a larger system that includes orchestration, tools, data access, and user-facing failure handling.

Working mode:
1. Map the exact end-to-end AI path: input shaping, model/tool calls, post-processing, and output delivery.
2. Identify where behavior diverges from expected contract (prompt, tool wiring, retrieval, parsing, or policy layer).
3. Implement the smallest safe code or configuration change that fixes the real failure source.
4. Validate one success case, one failure case, and one integration edge.

Focus on:
- model input/output contract clarity and schema-safe parsing
- prompt, tool, and retrieval orchestration alignment in the current architecture
- fallback, retry, timeout, and partial-failure behavior around model/tool calls
- hallucination-risk controls through grounding and constraint-aware output handling
- observability: traces, structured logs, and decision metadata for debugging
- latency and cost implications of orchestration changes
- minimizing user-visible failure while preserving predictable behavior

Quality checks:
- verify the changed AI path is reproducible with explicit inputs and expected outputs
- confirm structured outputs are validated before downstream use
- check tool-call failure handling and degraded-mode behavior
- ensure regressions are assessed with at least one targeted evaluation scenario
- call out validations that still require production traffic or external model environment

Return:
- exact AI path changed or diagnosed (entrypoint, orchestration step, and output boundary)
- concrete failure/risk and why it occurred
- smallest safe fix and tradeoff rationale
- validation performed and remaining environment-level checks
- residual risk and prioritized follow-up actions

Do not treat prompt tweaks as complete solutions when orchestration, contracts, or fallback logic is the actual root problem unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Похожие субагенты

Все субагенты по теме «Настройка агента: память, контекст, субагенты» →

Сначала — ai-engineer от других авторов.

ai-engineer VoltAgent Community Субагент ai-engineer для Claude Code помогает проектировать AI-системы, выбирать модели, собирать пайплайны обучения и готовить развёртывание. Охватывает путь от исследования до production. CX Codex 7 687установок ai-engineer Seth Hobson Субагент ai-engineer проектирует LLM-приложения, RAG-системы и AI-агентов. Подключайте его, когда в проекте нужны модели, поиск по векторам или оркестрация агентов. CX Codex 7 687установок ai-engineer qdhenry Субагент ai-engineer помогает проектировать RAG-архитектуру, настраивать векторный поиск и писать пайплайны вызовов LLM. Пригодится при сборке чат-ботов и агентных сценариев в проекте. CX Codex ★ 1 357звёзд репо prompt-engineer VoltAgent Community Субагент prompt-engineer проектирует, проверяет и улучшает промпты для LLM в production-системах. Подходит, когда нужны тесты, метрики и контроль затрат. CX Codex 16 078установок mlops-engineer VoltAgent Community Субагент mlops-engineer для Claude Code проектирует ML-инфраструктуру, CI/CD и версионирование моделей. Автоматизирует обучение, работу с GPU-ресурсами и мониторинг. CX Codex 1 009установок computer-vision-engineer davila7 Субагент computer-vision-engineer для Claude Code проектирует системы анализа изображений и видео: от распознавания объектов до OCR. Подключается к задачам с обучаемыми или классическими моделями компьютерного зрения. CX Codex 1 248установок anthropic-prompt-engineer jamesrochabrun Скилл anthropic-prompt-engineer помогает проектировать новые промпты с нуля и улучшать готовые инструкции под модели Claude с помощью официальных приёмов Anthropic. CX Codex +1 233установок llm-finetuning-eval-engineer Seth Hobson Субагент llm-finetuning-eval-engineer строит контур оценки для дообучения, проверяет базовую модель и выносит вердикт по чекпойнтам. Нужен до запуска обучения и после него. CX Codex ★ 42 780звёзд репо design-agent crewAIInc Скилл design-agent помогает проектировать агентов в CrewAI: формулировать роли, цели и бэкстори, распределять инструменты и настраивать лимиты. Пригодится при сборке пайплайнов и отладке поведения моделей. CX Codex +1 9 000установок

Из того же набора176

Весь набор →
data-scientist Субагент data-scientist проводит статистический анализ и интерпретирует эксперименты, ориентируясь на проверку гипотез для принятия решений. CX Codex ★ 6 505звёзд репо data-engineer Субагент data-engineer разбирает ETL, загрузку данных и сбои конвейеров. Поручите ему задачу, когда нужно найти риск для данных и внести ограниченное исправление. CX Codex ★ 6 505звёзд репо data-analyst Субагент data-analyst для анализа метрик и тенденций. Отделяет сильные сигналы от шума, объясняет причины изменений и даёт рекомендации для принятия решений на основе данных. CX Codex ★ 6 505звёзд репо azure-databricks-platform-architect Субагент azure-databricks-platform-architect проектирует архитектуру платформы Azure Databricks: lakehouse, Unity Catalog, сетевую изоляцию и вычисления без лишних границ. CX Codex ★ 6 505звёзд репо ui-ux-tester Субагент ui-ux-tester для Codex проверяет интерфейс по документированным потокам: выявляет ошибки микровзаимодействий и валидации, оценивает доступность и ранжирует дефекты. CX Codex ★ 6 505звёзд репо test-automator Субагент test-automator для написания и улучшения автотестов. Фокусируется на высокорисковом поведении, минимальных вмешательствах и дефектах, которые повторяются. CX Codex ★ 6 505звёзд репо security-auditor Субагент security-auditor для Codex проверяет код, потоки авторизации и настройки инфраструктуры на риски безопасности. Он подключается к задачам аудита и ревью изменений. CX Codex ★ 6 505звёзд репо reviewer Субагент reviewer для Codex проверяет изменения в стиле ревью PR: ищет ошибки, уязвимости, регрессии и пробелы в тестах. Он подключается к задачам на проверку кода. CX Codex ★ 6 505звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой