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

hallucination-investigator — субагент Codex

Субагент hallucination-investigator для Codex, который анализирует причины ошибок в ответах ИИ: не хватило контекста, неверный поиск, неправильный промпт или неподдержанный вывод.

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

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

Что делает hallucination-investigator

Работает пошагово: воссоздаёт ошибку и доступные системе данные, определяет, пришла ли беда из контекста, retrieval, промпта, инструментов или логики рабочего процесса, рекомендует точечный fix. Отличает настоящие галлюцинации (ответ без доказательств) от плохого поиска или устаревших данных — важно, потому что рекомендации будут разными.

Фокусируется на том, превысил ли ответ имеющиеся факты, был ли упущен результат поиска или проранжирован неправильно, подталкивает ли формулировка промпта к самоуверенному заполнению, скрывают ли форматы неопределённость. Возвращает диагноз с корневой причиной, предложение fix'а, идеи для обнаружения и проверочные примеры.

Установка в Codex: добавь файл hallucination-investigator.toml в папку .codex/agents/.

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

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

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

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

Как установить hallucination-investigator

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

.codex/agents/hallucination-investigator.toml

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

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

Вопросы о hallucination-investigator

Как установить hallucination-investigator в Codex?

Добавь файл hallucination-investigator.toml в папку .codex/agents/. Субагент будет доступен в Codex как инструмент для анализа ошибок.

Что делает hallucination-investigator?

Разбирает, почему ИИ выдал неверный или необоснованный ответ: упущены ли факты при поиске, неправильный ли промпт, или система попросту вывела что-то без доказательств. Предлагает конкретный fix и примеры для проверки.

Чем hallucination-investigator отличается от просто запрета на вымышленные ответы?

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

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

hallucination-investigator.toml · MIT
# hallucination-investigator

Use when a task needs root-cause analysis for factuality failures, unsupported claims, or context breakdowns in AI outputs.

Own hallucination investigation as root-cause analysis across context, retrieval, prompts, tools, and workflow design.

Working mode:
1. Reconstruct the failing example and the evidence the system actually had available.
2. Determine whether the failure came from missing context, bad retrieval, prompt framing, tool misuse, or unsupported inference.
3. Recommend the smallest change that most directly reduces recurrence.
4. Note how to verify the fix with targeted cases.

Focus on:
- whether the answer exceeded available evidence
- retrieval misses, ranking issues, or stale context effects
- prompt wording that encourages overconfident completion
- output formats that hide uncertainty or source gaps
- detection opportunities for unsupported claims before user delivery

Quality checks:
- verify the diagnosis uses the actual failing path, not generic speculation
- separate no-evidence failures from evidence-ignored failures
- recommend fixes that address the root cause rather than only suppressing wording
- include at least one targeted regression case

Return:
- failure reconstruction and likely root cause
- highest-leverage fix and why
- supporting detection or guardrail ideas
- targeted verification cases
- residual risk if only the recommended fix is applied

Do not label every wrong answer a hallucination when the true issue is poor retrieval, stale data, or tool failure unless explicitly requested by the parent agent.

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

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

Все субагенты по теме «ИИ и ML» →
ns-investigator nextstage-brasil Скилл ns-investigator для Claude Code анализирует стек-трейсы, логи и упавшие тесты, находит корневую причину и предлагает минимальный фикс без реализации. CX Codex +1 153установок debug-like-expert Lex Christopherson Скилл debug-like-expert активирует протокол методической отладки для сложных ошибок, когда стандартные методы не работают. Собирает доказательства, тестирует гипотезы и ищет корневую причину вместо быстрых исправлений. CX Codex +1 ★ 1 988звёзд репо glassbox-framework TheBarmaEffect MCP-сервер glassbox-framework проверяет ответы языковых моделей через разбор утверждений, оценку уверенности и состязательные тесты. Сервер формирует отчёт Trust Card с проверяемым вердиктом. CX Codex +1 ★ 10звёзд репо investigator shinpr Субагент investigator собирает факты о баге: читает код, историю git, конфиги и документацию, строит карту путей исполнения и матрицу доказательств для поиска причины. CX Codex ★ 720звёзд репо systematic-debugging Jesse Vincent Скилл systematic-debugging для Claude Code и Codex блокирует фиксы до завершения анализа первопричины. Включается при падении тестов, баге или неожиданном поведении. CX Codex +1 306 118установок error-detective VoltAgent Community Субагент error-detective для Claude Code, который разбирает ошибки в распределённых системах: коррелирует сбои между сервисами, ищет корневые причины и предлагает меры, чтобы сбои не повторялись. CX Codex 7 557установок

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

Весь набор →
ponder-reviewer Субагент ponder-reviewer для Codex запускает многопроходный ревью-протокол с проверкой покрытия и отсевом ложных срабатываний. CX Codex ★ 6 505звёзд репо prompt-regression-tester prompt-regression-tester — субагент для Codex, который подбирает регрессионные тесты для изменений в ИИ-системе. Он оценивает риски для промптов, моделей, инструментов и рабочих процессов. CX Codex ★ 6 505звёзд репо eval-engineer Субагент eval-engineer для Codex, который проектирует оценку качества промптов, поиска, вызова инструментов и сложных агентов. CX Codex ★ 6 505звёзд репо ai-observability-engineer Субагент ai-observability-engineer для Codex проектирует сбор трейсов, метрик и журналов для агентных систем и LLM в продакшене. Запускается при настройке наблюдаемости пайплайнов. CX Codex ★ 6 505звёзд репо platform-product-manager Субагент platform-product-manager для работы над внутренней платформой: превращает боли команд в дорожную карту с метриками внедрения и явными компромиссами. CX Codex ★ 6 505звёзд репо idp-architect Субагент idp-architect проектирует архитектуру внутренних платформ разработки (IDP), границы сервисов и модель self-service управления для инженерных команд. CX Codex ★ 6 505звёзд репо golden-path-designer Субагент golden-path-designer для Codex проектирует стандартный путь создания, развёртывания и эксплуатации сервисов. Определяет настройки по умолчанию и правила для исключений. CX Codex ★ 6 505звёзд репо backstage-specialist Субагент backstage-specialist помогает спроектировать внутренний портал разработчика на Backstage: каталог сервисов, шаблоны scaffolder, выбор плагинов и план внедрения. CX Codex ★ 6 505звёзд репо

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

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