Руководство по созданию локального ИИ-агента в Codex App

Руководство по созданию локального ИИ-агента в Codex App

Автоматизация рутины — ключ к эффективности современного бизнеса. Предприниматели и создатели контента могут собрать персонального ассистента на базе Codex App — официального десктопного приложения от OpenAI. Агент работает локально с файлами на компьютере, а вычисления производятся на серверах OpenAI. Это избавляет от необходимости покупать дорогое оборудование, но требует правильной настройки, структурирования папок и соблюдения правил безопасности.

Установка и подготовка к работе

Для запуска локального агента выполните следующие шаги:

1. Загрузка приложения: Скачайте установочный файл с сайта OpenAI Developers Codex App. Официальные версии приложения доступны для macOS (отдельно для процессоров Apple Silicon и Intel) и Windows. Настольная версия для Linux сейчас не поставляется — на странице можно лишь оставить заявку на уведомление («Get notified for Linux»).
2. Требования к аккаунту: Войдите под учетной записью ChatGPT с подпиской Plus, Pro, Business, Edu или Enterprise. Допускается авторизация через секретный ключ OpenAI API, но при этом часть функций интерфейса Codex App может быть недоступна.
3. Сетевой доступ: Поскольку вычисления облачные, пользователям в регионах с ограничениями потребуется VPN на уровне устройства (активный на уровне операционной системы ПК, а не просто плагин для браузера).
4. Выбор каталога: После установки выберите проектную папку (Project Folder), в пределах которой будет работать агент. Нажмите «Local», чтобы активировать режим локального взаимодействия с файлами, и отправьте первое сообщение.

Архитектура папок проекта

Организуйте строгую структуру папок в рабочем каталоге для точного управления контекстом:

• Workspace — основная папка для результатов работы. Здесь ИИ будет сохранять готовые тексты, планы и таблицы.
• Inbox — папка для исходных материалов (черновиков, заметок, примеров, ссылок и выгрузок для анализа).
• Memory — папка для долгосрочного контекста. Поместите сюда файл user_profile.md с описанием ваших проектов, аудитории и стиля.
• Skills — каталог подключаемых навыков. Каждый навык создается как отдельная подпапка в Skills и обязательно содержит файл SKILL.md с полями name и description, а также может содержать каталоги scripts/, references/, assets/ и agents/.

Для автоматической сборки структуры создайте в корне файл setup.md с инструкцией для агента прочитать правила, создать каталоги Workspace, Inbox, Memory, Skills, разместить в каждой из них по одному файлу README.md с описанием папки, а затем удалить setup.md. Отправьте запрос на создание структуры, выбрав максимальный уровень рассуждений модели.

Конфигурация правил: файл AGENTS.md

Для задания правил поведения агента используется механизм файлов AGENTS.md.

• Глобальные правила: Хранятся в домашнем каталоге пользователя ~/.codex/ в файле AGENTS.md (или AGENTS.override.md). Они действуют на все проекты.
• Проектные правила: Размещаются в корне рабочей папки проекта в файле AGENTS.md. Они имеют приоритет над глобальными, так как загружаются в prompt позже.

Примечание: Хотя в любительских схемах файл называют agent.md, официальный Codex автоматически распознает только имя AGENTS.md. Для проверки применимости правил отправьте агенту запрос с просьбой резюмировать текущие инструкции — он должен процитировать правила из глобального и локального файлов.

Использование и тестирование навыков (Skills)

Навыки позволяют адаптировать модель под конкретные бизнес-сценарии. Без них агент решает задачи поверхностно, но с ними качество резко возрастает.

Рассмотрим работу навыка генерации каруселей для соцсетей — Carousel Builder:

1. В папке Skills создается папка carousel_builder/.
2. В ней размещается SKILL.md с промптом, описывающим структуру слайдов и правила призыва к действию (CTA).
3. Навык активируется автоматически (если задача совпадает с описанием в SKILL.md) или принудительно (через упоминание названия навыка в чате).

Разрабатывать навыки лучше самостоятельно. Это защищает от промпт-инъекций — вредоносных скрытых команд в чужих файлах. Опишите агенту задачу, попросите задать уточняющие вопросы, оформите итог в файл SKILL.md и протестируйте на коротком задании, проверив по логам, что выполнился именно этот навык.

Безопасность и уровни доступа

Официальная архитектура безопасности Codex App включает два уровня защиты: песочницу операционной системы (OS-enforced sandbox), которая по умолчанию работает без доступа к сети (Offline mode), и политику подтверждения действий.

С помощью команды /permissions можно настроить один из трех профилей доступа:

• :read-only — только чтение файлов и ответы в чате. Безопасен для анализа готовых отчетов.
• :workspace — агент может изменять файлы только внутри папки проекта. При попытке редактирования внешних файлов или запроса в сеть потребуется ваше ручное подтверждение. Это оптимальный выбор для личного компьютера.
• :danger-full-access — полный доступ без ограничений песочницы. Подходит только для выделенных серверов, где нет конфиденциальных данных.

Важное предупреждение: Никогда не сохраняйте пароли, личные токены и API-ключи в файлах проекта или профиле пользователя. Передавайте их через переменные окружения.

Настройка памяти (Memories)

Механизм сквозной памяти (Memories) переносит контекст и предпочтения между диалогами. В странах ЕЭЗ, Великобритании и Швейцарии эта функция отключена по умолчанию. Для ее активации включите ее в настройках или пропишите memories = true в секции [features] конфигурационного файла ~/.codex/config.toml. Для управления сохраненным контекстом используйте команду /memories.

Помните, что память является лишь ассоциативным дополнением. Важные правила совместной работы всегда должны быть жестко зафиксированы в AGENTS.md.

В ручной профиль Memory/user_profile.md запишите:

• Сферу деятельности и ключевые продукты;
• Стилистические требования (писать по-русски, избегать канцеляризмов, давать сначала суть);
• Предпочтительный формат вывода (markdown-списки, таблицы).

Сценарии практического применения

Настроенный ИИ-помощник позволяет автоматизировать ключевые задачи:

• Для авторов контента: Поместите базу старых постов в Inbox, опишите стиль в user_profile.md и с помощью навыка генерации идей создайте контент-план из 10 публикаций с высокой вероятностью отклика.
• Для экспертов: Создайте навык Carousel Builder со структурой презентации. Отправьте тезисы в Inbox, и агент скомпонует готовый постраничный текст слайдов, сохранив его в Workspace.
• Для владельцев бизнеса: Разработайте навык Competitor Analysis. Загружайте отчеты о конкурентах в Inbox, и агент без риска утечки данных составит выводы по ценообразованию и отстройке в папке Workspace.