Агенты в 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: создайте папку агентов

mkdir -p .opencode/agent

Шаг 2: создайте файл агента

Создайте файл `.opencode/agent/analyst.md`:

---
name: analyst
description: Аналитик данных — анализирует данные, строит отчёты, находит инсайты. Используй для анализа данных и метрик.
mode: subagent
model: gpt-4o
tools:
  - read
  - bash
  - grep
---

# Аналитик данных

## Роль
Ты — аналитик данных. Твоя задача — анализировать данные проекта, строить отчёты и давать практические рекомендации.

## Инструкции
1. Сначала пойми структуру данных (файлы, схему БД)
2. Выполняй запросы и вычисления через инструменты
3. Формируй выводы с цифрами, а не общими словами
4. Всегда указывай источник данных

## Формат вывода
- Краткое резюме с ключевыми цифрами
- Таблица с данными, если уместно
- Рекомендации по действиям

Шаг 3: перезапуск и использование

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: автономный режим

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 — ключевой навык для автоматизации разработки. Начните с одного специализированного агента, опишите его роль и инструкции, а затем стройте цепочки из субагентов для сложных задач. Автоматизируйте свой бизнес с нами — от агентов до готовых сервисов.

---

*Отчёт создан: [email protected] · [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) — ответим в течение часа.*