--- title: Агенты в OpenCode: создание, типы и автоматизация задач slug: opencode-agenty description: Как создать агентов в OpenCode: типы агентов, конфигурация, инструкции и инструменты. Практические примеры автоматизации задач с агентами opencode. keywords: [opencode агенты, агенты в opencode, создать агента, типы агентов, автоматизация задач] h1: Агенты в OpenCode: создание, типы и автоматизация задач category: OpenCode tags: [opencode, агенты, автоматизация, subagents] date: 2026-08-20 image: /images/articles/opencode-agenty.webp image_alt: Агенты в OpenCode — схема создания и автоматизации задач reading_time: ~8 мин author: Refertur canonical: https://ai-courses.refertur.net/articles/opencode-agenty/ faq: - q: Что такое агенты в OpenCode? a: Агенты в OpenCode — это специализированные конфигурации ИИ-ассистента с собственной ролью, инструкциями и набором инструментов. Например, агент code-reviewer проверяет код, агент writer пишет тексты. Агенты позволяют делегировать разные типы задач разным специалистам. - q: Как создать агента в OpenCode? a: Создать агента в OpenCode можно, создав Markdown-файл в папке .opencode/agent/ с frontmatter: name, description, mode (primary или subagent) и текстом инструкций в теле файла. После перезапуска агент появится в списке доступных. - q: Чем первичный агент (primary) отличается от субагента? a: Первичный агент (primary) запускается в основной сессии, как обычный режим чата, и может вызывать субагентов. Субагент (subagent) — это специалист, которого основной агент вызывает для выполнения конкретной подзадачи. Субагенты работают в изолированном контексте. - q: Какие инструменты доступны агентам OpenCode? a: Инструменты агентов OpenCode включают: чтение и запись файлов, выполнение команд в терминале, работу с Git, поиск по коду, MCP-серверы, браузер (через OpenChamber Web), веб-загрузку. Набор инструментов задаётся в конфигурации агента. - q: Как автоматизировать задачи с агентами OpenCode? a: Автоматизировать задачи можно через автономный режим (opencode run), через создание цепочек субагентов и через планировщик OpenChamber (.agents/loops). Агент выполняет задачу от начала до конца, включая проверку результата. jsonld: {} --- # Агенты в OpenCode: создание, типы и автоматизация задач Агенты в OpenCode позволяют превратить универсального ИИ-ассистента в команду специалистов: каждый агент имеет свою роль, инструкции и инструменты. В этом руководстве разберём типы агентов, как создать агента в OpenCode и как автоматизировать с их помощью рутинные задачи разработки. ## Что такое агент в OpenCode Агент — это конфигурация ИИ-ассистента, которая задаёт: - Роль и специализацию (ревьюер кода, писатель, аналитик) - Системные инструкции (как вести себя, что делать) - Доступные инструменты (файлы, терминал, Git, MCP) - Модель по умолчанию - Возможность вызывать других агентов (субагентов) По умолчанию в OpenCode есть несколько встроенных агентов (build, plan, code-reviewer и другие), но вы можете создавать свои. ## Типы агентов | Тип | Назначение | Запуск | |---|---|---| | Primary | Основной агент для работы в сессии | `opencode --agent build` | | Subagent | Специалист для подзадачи | Вызывается основным агентом | | Agent с MCP | Агент с внешними инструментами | Автоматически при подключении MCP | ### Primary-агенты Primary-агенты — это режимы работы основной сессии. Например: - `build` — пишет и изменяет код - `plan` — планирует и анализирует без изменений - `code-reviewer` — ревью кода Запуск: `opencode --agent code-reviewer` ### Субагенты Субагенты — это специалисты, которых вызывает основной агент для параллельной или последовательной работы: - Изолированный контекст (не загрязняют основную сессию) - Чёткая специализация - Возвращают результат основной сессии ## Как создать агента в OpenCode ### Шаг 1: создайте папку агентов ```bash mkdir -p .opencode/agent ``` ### Шаг 2: создайте файл агента Создайте файл `.opencode/agent/analyst.md`: ```markdown --- name: analyst description: Аналитик данных — анализирует данные, строит отчёты, находит инсайты. Используй для анализа данных и метрик. mode: subagent model: gpt-4o tools: - read - bash - grep --- # Аналитик данных ## Роль Ты — аналитик данных. Твоя задача — анализировать данные проекта, строить отчёты и давать практические рекомендации. ## Инструкции 1. Сначала пойми структуру данных (файлы, схему БД) 2. Выполняй запросы и вычисления через инструменты 3. Формируй выводы с цифрами, а не общими словами 4. Всегда указывай источник данных ## Формат вывода - Краткое резюме с ключевыми цифрами - Таблица с данными, если уместно - Рекомендации по действиям ``` ### Шаг 3: перезапуск и использование ```bash opencode # в сессии: @analyst проанализируй метрики за месяц ``` ## Конфигурация агента: параметры | Параметр | Описание | |---|---| | `name` | Уникальное имя агента (kebab-case) | | `description` | Что делает агент — используется для авто-выбора | | `mode` | `primary` или `subagent` | | `model` | Модель по умолчанию | | `tools` | Список доступных инструментов | | `temperature` | Креативность ответов (0-2) | | `permission` | Уровень разрешений (default, acceptEdits, bypassPermissions) | ## Автоматизация задач с агентами ### Сценарий 1: цепочка субагентов 1. Агент `planner` разбивает задачу на шаги 2. Агент `writer` пишет код/контент 3. Агент `reviewer` проверяет результат 4. Основной агент собирает финальный результат ### Сценарий 2: автономный режим ```bash opencode run --agent analyst "проанализируй логи и найди ошибки" --print ``` ### Сценарий 3: регулярные задачи Используйте планировщик OpenChamber: создайте задачу в `.agents/loops/` — агент будет запускаться по расписанию (ежедневно, еженедельно). ## Примеры готовых агентов | Агент | Роль | Инструменты | |---|---|---| | code-reviewer | Проверка кода на баги и безопасность | read, grep, bash | | researcher | Поиск и исследование в интернете | web, fetch | | writer | Написание контента и документации | read, write | | test-writer | Написание тестов | read, bash | | seo-analyst | Анализ SEO и метрик | read, bash, web | ## Ошибки при создании агентов | Ошибка | Причина | Решение | |---|---|---| | Agent not found | Неверный путь или имя | Проверьте папку .opencode/agent/ и frontmatter | | Mode not recognized | Ошибка в параметре mode | Используйте primary или subagent | | Tools не работают | Инструмент не разрешён | Добавьте инструмент в список tools | | Агент не видит контекст | Нет инструкций | Опишите роль и процесс в теле файла | ## Что дальше Освоив создание агентов, переходите к более глубоким темам: - [Управление контекстом в OpenCode](/articles/opencode-kontekst/) - [Автономный режим OpenCode](/articles/opencode-avtonomnyj-rezhim/) - [Мультиагентные системы](/articles/mulitiagenty/) - [Документация OpenCode (рус.)](/docs/overview/) #### Следующие шаги ## Часто задаваемые вопросы - Что такое агенты в OpenCode? — Специализированные конфигурации ассистента с ролью и инструментами. - Как создать агента? — Markdown-файл в .opencode/agent/ с frontmatter и инструкциями. - Чем primary отличается от subagent? — Primary — основная сессия; subagent — изолированный специалист. - Какие инструменты доступны агентам? — Файлы, терминал, Git, MCP, браузер, веб. - Как автоматизировать задачи? — Автономный режим, цепочки субагентов, планировщик OpenChamber. ## Заключение Создание агентов в OpenCode — ключевой навык для автоматизации разработки. Начните с одного специализированного агента, опишите его роль и инструкции, а затем стройте цепочки из субагентов для сложных задач. Автоматизируйте свой бизнес с нами — от агентов до готовых сервисов. --- *Отчёт создан: refertur@yandex.ru · [refertur.net](https://refertur.net) · [t.me/realhikaz](https://t.me/realhikaz) · [WhatsApp](https://wa.me/+77054384888)* *SEO, продвижение, разработка, сайты, веб-приложения, сервисы, калькуляторы, контент-маркетинг, каталоги, отчёты, аудиты — на заказ. Напишите нам в [WhatsApp](https://wa.me/+77054384888?text=%D0%97%D0%B4%D1%80%D0%B0%D0%B2%D1%81%D1%82%D0%B2%D1%83%D0%B9%D1%82%D0%B5%2C%20%D1%85%D0%BE%D1%87%D1%83%20%D0%B7%D0%B0%D0%BA%D0%B0%D0%B7%D0%B0%D1%82%D1%8C%20%D1%81%D0%B5%D0%BE) — ответим в течение часа.*