Агенты в 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
• Автономный режим OpenCode
• Мультиагентные системы
• Документация OpenCode (рус.)

Следующие шаги

Часто задаваемые вопросы

• Что такое агенты в OpenCode? — Специализированные конфигурации ассистента с ролью и инструментами.
• Как создать агента? — Markdown-файл в .opencode/agent/ с frontmatter и инструкциями.
• Чем primary отличается от subagent? — Primary — основная сессия; subagent — изолированный специалист.
• Какие инструменты доступны агентам? — Файлы, терминал, Git, MCP, браузер, веб.
• Как автоматизировать задачи? — Автономный режим, цепочки субагентов, планировщик OpenChamber.

Заключение

Создание агентов в OpenCode — ключевой навык для автоматизации разработки. Начните с одного специализированного агента, опишите его роль и инструкции, а затем стройте цепочки из субагентов для сложных задач. Автоматизируйте свой бизнес с нами — от агентов до готовых сервисов.

---

Отчёт создан: [email protected] · refertur.net · t.me/realhikaz · WhatsApp SEO, продвижение, разработка, сайты, веб-приложения, сервисы, калькуляторы, контент-маркетинг, каталоги, отчёты, аудиты — на заказ. Напишите нам в WhatsApp — ответим в течение часа.