opencode/packages/web/src/content/docs/ru/agents.mdx at 31ea7fde6855cc2cead5cb90cf528841e82ad974 · anomalyco/opencode

title	Агенты
description	Настройте и используйте специализированные агенты.

Агенты — это специализированные ИИ-помощники, которых можно настроить для конкретных задач и рабочих процессов. Они позволяют создавать специализированные инструменты с настраиваемыми подсказками, моделями и доступом к инструментам.

:::tip Используйте агент плана для анализа кода и просмотра предложений без внесения каких-либо изменений в код. :::

Вы можете переключаться между агентами во время сеанса или вызывать их с помощью упоминания @.

Типы

В opencode есть два типа агентов; Первичные агенты и субагенты.

Первичные агенты

Первичные агенты — это основные помощники, с которыми вы взаимодействуете напрямую. Вы можете переключаться между ними, используя клавишу Tab или настроенную привязку клавиш switch_agent. Эти агенты ведут ваш основной разговор. Доступ к инструментам настраивается с помощью разрешений — например, при сборке все инструменты включены, а при планировании — ограничены.

:::tip Вы можете использовать клавишу Tab для переключения между основными агентами во время сеанса. :::

opencode поставляется с двумя встроенными основными агентами: Build и Plan. Мы рассмотрим их ниже.

Субагенты

Субагенты — это специализированные помощники, которых основные агенты могут вызывать для выполнения определенных задач. Вы также можете вызвать их вручную, @ упомянув их в своих сообщениях.

opencode поставляется с двумя встроенными субагентами: General и Explore. Мы рассмотрим это ниже.

Встроенные агенты

opencode поставляется с двумя встроенными основными агентами и двумя встроенными субагентами.

Использование Build

Режим: primary

Build — основной агент по умолчанию со всеми включенными инструментами. Это стандартный агент для разработки, где вам необходим полный доступ к файловым операциям и системным командам.

Использование Plan

Режим: primary

Агент с ограниченным доступом, предназначенный для планирования и анализа. Мы используем систему разрешений, чтобы предоставить вам больше контроля и предотвратить непреднамеренные изменения. По умолчанию для всех следующих параметров установлено значение ask:

file edits: Все записи, исправления и изменения.
bash: все команды bash.

Этот агент полезен, если вы хотите, чтобы LLM анализировал код, предлагал изменения или создавал планы без внесения каких-либо фактических изменений в вашу кодовую базу.

Использование General

Режим: subagent

Универсальный агент для исследования сложных вопросов и выполнения многоэтапных задач. Имеет полный доступ к инструментам (кроме задач), поэтому при необходимости может вносить изменения в файлы. Используйте это для параллельного выполнения нескольких единиц работы.

Использование Explore

Режим: subagent

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

Использование Compaction

Режим: primary

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

Использование Title

Режим: primary

Скрытый системный агент, генерирующий короткие заголовки сессий. Он запускается автоматически и не может быть выбран в пользовательском интерфейсе.

Использование Summary

Режим: primary

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

Использование

Для основных агентов используйте клавишу Tab для переключения между ними во время сеанса. Вы также можете использовать настроенную привязку клавиш switch_agent.
Субагенты могут быть вызваны:
- Автоматически основными агентами для выполнения специализированных задач на основе их описаний.
- Вручную, @ упомянув субагента в своем сообщении. Например.
```
@general help me search for this function
```
Навигация между сеансами. Когда субагенты создают свои собственные дочерние сеансы, вы можете перемещаться между родительским сеансом и всеми дочерними сеансами, используя:
- <Leader>+Right (или настроенная вами комбинация клавиш session_child_cycle) для перехода вперед через родительский элемент → дочерний элемент1 → дочерний элемент2 → ... → родительский элемент.
- <Leader>+Left (или настроенная вами комбинация клавиш session_child_cycle_reverse) для перехода назад по родительскому элементу ← дочерний элемент1 ← дочерний элемент2 ← ... ← родительский элемент
Это позволяет плавно переключаться между основным разговором и работой специализированного субагента.

Настройка

Вы можете настроить встроенные агенты или создать свои собственные посредством настройки. Агенты можно настроить двумя способами:

JSON

Настройте агентов в файле конфигурации opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "agent": {
    "build": {
      "mode": "primary",
      "model": "anthropic/claude-sonnet-4-20250514",
      "prompt": "{file:./prompts/build.txt}",
      "tools": {
        "write": true,
        "edit": true,
        "bash": true
      }
    },
    "plan": {
      "mode": "primary",
      "model": "anthropic/claude-haiku-4-20250514",
      "tools": {
        "write": false,
        "edit": false,
        "bash": false
      }
    },
    "code-reviewer": {
      "description": "Reviews code for best practices and potential issues",
      "mode": "subagent",
      "model": "anthropic/claude-sonnet-4-20250514",
      "prompt": "You are a code reviewer. Focus on security, performance, and maintainability.",
      "tools": {
        "write": false,
        "edit": false
      }
    }
  }
}

Markdown

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

Глобальный: ~/.config/opencode/agents/
Для каждого проекта: .opencode/agents/

---
description: Reviews code for quality and best practices
mode: subagent
model: anthropic/claude-sonnet-4-20250514
temperature: 0.1
tools:
  write: false
  edit: false
  bash: false
---

You are in code review mode. Focus on:

- Code quality and best practices
- Potential bugs and edge cases
- Performance implications
- Security considerations

Provide constructive feedback without making direct changes.

Имя Markdown файла становится именем агента. Например, review.md создает агент review.

Параметры

Давайте рассмотрим эти параметры конфигурации подробно.

Описание

Используйте опцию description, чтобы предоставить краткое описание того, что делает агент и когда его использовать.

{
  "agent": {
    "review": {
      "description": "Reviews code for best practices and potential issues"
    }
  }
}

Это обязательный параметр конфигурации.

Температура

Контролируйте случайность и креативность ответов LLM с помощью конфигурации temperature.

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

{
  "agent": {
    "plan": {
      "temperature": 0.1
    },
    "creative": {
      "temperature": 0.8
    }
  }
}

Значения температуры обычно находятся в диапазоне от 0,0 до 1,0:

0,0–0,2: очень целенаправленные и детерминированные ответы, идеальные для анализа кода и планирования.
0,3–0,5: сбалансированные ответы с некоторой креативностью, подходят для общих задач разработки.
0,6–1,0: более творческие и разнообразные ответы, полезные для мозгового штурма и исследования.

{
  "agent": {
    "analyze": {
      "temperature": 0.1,
      "prompt": "{file:./prompts/analysis.txt}"
    },
    "build": {
      "temperature": 0.3
    },
    "brainstorm": {
      "temperature": 0.7,
      "prompt": "{file:./prompts/creative.txt}"
    }
  }
}

Если температура не указана, opencode использует значения по умолчанию, специфичные для модели; обычно 0 для большинства моделей, 0,55 для моделей Qwen.

Максимальное количество шагов

Управляйте максимальным количеством агентных итераций, которые агент может выполнить, прежде чем ему придется отвечать только текстом. Это позволяет пользователям, желающим контролировать расходы, устанавливать лимит на агентские действия.

Если этот параметр не установлен, агент будет продолжать выполнять итерацию до тех пор, пока модель не решит остановиться или пока пользователь не прервет сеанс.

{
  "agent": {
    "quick-thinker": {
      "description": "Fast reasoning with limited iterations",
      "prompt": "You are a quick thinker. Solve problems with minimal steps.",
      "steps": 5
    }
  }
}

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

:::caution Устаревшее поле maxSteps устарело. Вместо этого используйте steps. :::

Отключение

Установите true, чтобы отключить агент.

{
  "agent": {
    "review": {
      "disable": true
    }
  }
}

Промпт

Укажите собственный файл системных приглашений для этого агента с помощью конфигурации prompt. Файл подсказки должен содержать инструкции, специфичные для целей агента.

{
  "agent": {
    "review": {
      "prompt": "{file:./prompts/code-review.txt}"
    }
  }
}

Этот путь указан относительно того, где находится файл конфигурации. Таким образом, это работает как для глобальной конфигурации opencode, так и для конфигурации конкретного проекта.

Модель

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

:::tip Если вы не укажете модель, основные агенты будут использовать глобально настроенную модель](/docs/config#models), а субагенты будут использовать модель основного агента, вызвавшего субагент. :::

{
  "agent": {
    "plan": {
      "model": "anthropic/claude-haiku-4-20250514"
    }
  }
}

Идентификатор модели в вашей конфигурации opencode использует формат provider/model-id. Например, если вы используете OpenCode Zen, вы должны использовать opencode/gpt-5.1-codex для кодекса GPT 5.1.

Инструменты

Контролируйте, какие инструменты доступны в этом агенте, с помощью конфигурации tools. Вы можете включить или отключить определенные инструменты, установив для них значение true или false.

{
  "$schema": "https://opencode.ai/config.json",
  "tools": {
    "write": true,
    "bash": true
  },
  "agent": {
    "plan": {
      "tools": {
        "write": false,
        "bash": false
      }
    }
  }
}

:::note Конфигурация, специфичная для агента, переопределяет глобальную конфигурацию. :::

Вы также можете использовать подстановочные знаки для одновременного управления несколькими инструментами. Например, чтобы отключить все инструменты с сервера MCP:

{
  "$schema": "https://opencode.ai/config.json",
  "agent": {
    "readonly": {
      "tools": {
        "mymcp_*": false,
        "write": false,
        "edit": false
      }
    }
  }
}

Подробнее об инструментах.

Разрешения

Вы можете настроить разрешения, чтобы управлять действиями, которые может выполнять агент. В настоящее время разрешения для инструментов edit, bash и webfetch можно настроить на:

"ask" — Запросить подтверждение перед запуском инструмента.
"allow" — Разрешить все операции без одобрения.
"deny" — отключить инструмент

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "deny"
  }
}

Вы можете переопределить эти разрешения для каждого агента.

{
  "$schema": "https://opencode.ai/config.json",
  "permission": {
    "edit": "deny"
  },
  "agent": {
    "build": {
      "permission": {
        "edit": "ask"
      }
    }
  }
}

Вы также можете установить разрешения в агентах Markdown.

---
description: Code review without edits
mode: subagent
permission:
  edit: deny
  bash:
    "*": ask
    "git diff": allow
    "git log*": allow
    "grep *": allow
  webfetch: deny
---

Only analyze code and suggest changes.

Вы можете установить разрешения для определенных команд bash.

{
  "$schema": "https://opencode.ai/config.json",
  "agent": {
    "build": {
      "permission": {
        "bash": {
          "git push": "ask",
          "grep *": "allow"
        }
      }
    }
  }
}

Это может использовать glob pattern.

{
  "$schema": "https://opencode.ai/config.json",
  "agent": {
    "build": {
      "permission": {
        "bash": {
          "git *": "ask"
        }
      }
    }
  }
}

Вы также можете использовать подстановочный знак * для управления разрешениями для всех команд. Поскольку последнее правило сопоставления имеет приоритет, сначала поместите подстановочный знак *, а затем конкретные правила.

{
  "$schema": "https://opencode.ai/config.json",
  "agent": {
    "build": {
      "permission": {
        "bash": {
          "*": "ask",
          "git status *": "allow"
        }
      }
    }
  }
}

Подробнее о разрешениях.

Режим

Управляйте режимом агента с помощью конфигурации mode. Опция mode используется для определения того, как можно использовать агент.

{
  "agent": {
    "review": {
      "mode": "subagent"
    }
  }
}

Опция mode может быть установлена на primary, subagent или all. Если mode не указан, по умолчанию используется all.

Скрытый

Скройте субагент из меню автозаполнения @ с помощью hidden: true. Полезно для внутренних субагентов, которые другие агенты должны вызывать только программно с помощью инструмента Task.

{
  "agent": {
    "internal-helper": {
      "mode": "subagent",
      "hidden": true
    }
  }
}

Это влияет только на видимость пользователя в меню автозаполнения. Скрытые агенты по-прежнему могут быть вызваны моделью с помощью инструмента «Задачи», если разрешения позволяют.

:::note Применяется только к агентам mode: subagent. :::

Разрешения задач

Управляйте тем, какие субагенты агент может вызывать с помощью инструмента задач с помощью permission.task. Использует шаблоны glob для гибкого сопоставления.

{
  "agent": {
    "orchestrator": {
      "mode": "primary",
      "permission": {
        "task": {
          "*": "deny",
          "orchestrator-*": "allow",
          "code-reviewer": "ask"
        }
      }
    }
  }
}

Если установлено значение deny, субагент полностью удаляется из описания инструмента «Задача», поэтому модель не будет пытаться его вызвать.

:::tip Правила оцениваются по порядку, и побеждает последнее подходящее правило. В приведенном выше примере orchestrator-planner соответствует как * (запретить), так и orchestrator-* (разрешить), но поскольку orchestrator-* идет после *, результатом будет allow. :::

:::tip Пользователи всегда могут вызвать любой субагент напрямую через меню автозаполнения @, даже если разрешения задач агента запрещают это. :::

Цвет

Настройте внешний вид агента в пользовательском интерфейсе с помощью параметра color. Это влияет на то, как агент будет отображаться в интерфейсе.

Используйте допустимый шестнадцатеричный цвет (например, #FF5733) или цвет темы: primary, secondary, accent, success, warning, error, info.

{
  "agent": {
    "creative": {
      "color": "#ff6b6b"
    },
    "code-reviewer": {
      "color": "accent"
    }
  }
}

Top P

Управляйте разнообразием ответов с помощью опции top_p. Альтернатива температуре для контроля случайности.

{
  "agent": {
    "brainstorm": {
      "top_p": 0.9
    }
  }
}

Значения варьируются от 0,0 до 1,0. Низкие значения делают ответы более целенаправленными, высокие — более разнообразными.

Дополнительно

Любые другие параметры, указанные вами в конфигурации вашего агента, будут передаваться напрямую поставщику в качестве параметров модели. Это позволяет использовать функции и параметры, специфичные для поставщика.

Например, с помощью моделей рассуждения OpenAI вы можете контролировать усилия по рассуждению:

{
  "agent": {
    "deep-thinker": {
      "description": "Agent that uses high reasoning effort for complex problems",
      "model": "openai/gpt-5",
      "reasoningEffort": "high",
      "textVerbosity": "low"
    }
  }
}

Эти дополнительные параметры зависят от модели и поставщика. Проверьте документацию вашего провайдера на наличие доступных параметров.

:::tip Запустите opencode models, чтобы просмотреть список доступных моделей. :::

Создание агентов

Вы можете создать новых агентов, используя следующую команду:

opencode agent create

Эта интерактивная команда:

Спрашивает, где сохранить агента: глобально или в проекте.
Запрашивает описание того, что должен делать агент.
Создает соответствующий системный промпт и идентификатор.
Позволяет выбрать, к каким инструментам агент будет иметь доступ.
Наконец, создает файл Markdown с конфигурацией агента.

Варианты использования

Вот несколько распространенных случаев использования различных агентов.

Агент сборки: полная работа по разработке со всеми включенными инструментами.
Агент планирования: анализ и планирование без внесения изменений.
Агент проверки: проверка кода с доступом только для чтения и инструментами документирования.
Агент отладки: сосредоточен на исследовании с включенными инструментами bash и чтения.
Агент документов: запись документации с помощью файловых операций, но без системных команд.

Примеры

Вот несколько примеров агентов, которые могут оказаться вам полезными.

:::tip У вас есть агент, которым вы хотели бы поделиться? Отправьте PR. :::

Агент документации

---
description: Writes and maintains project documentation
mode: subagent
tools:
  bash: false
---

You are a technical writer. Create clear, comprehensive documentation.

Focus on:

- Clear explanations
- Proper structure
- Code examples
- User-friendly language

Аудитор безопасности

---
description: Performs security audits and identifies vulnerabilities
mode: subagent
tools:
  write: false
  edit: false
---

You are a security expert. Focus on identifying potential security issues.

Look for:

- Input validation vulnerabilities
- Authentication and authorization flaws
- Data exposure risks
- Dependency vulnerabilities
- Configuration security issues

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Типы

Первичные агенты

Субагенты

Встроенные агенты

Использование Build

Использование Plan

Использование General

Использование Explore

Использование Compaction

Использование Title

Использование Summary

Использование

Настройка

JSON

Markdown

Параметры

Описание

Температура

Максимальное количество шагов

Отключение

Промпт

Модель

Инструменты

Разрешения

Режим

Скрытый

Разрешения задач

Цвет

Top P

Дополнительно

Создание агентов

Варианты использования

Примеры

Агент документации

Аудитор безопасности

FilesExpand file tree

agents.mdx

Latest commit

History

agents.mdx

File metadata and controls

Типы

Первичные агенты

Субагенты

Встроенные агенты

Использование Build

Использование Plan

Использование General

Использование Explore

Использование Compaction

Использование Title

Использование Summary

Использование

Настройка

JSON

Markdown

Параметры

Описание

Температура

Максимальное количество шагов

Отключение

Промпт

Модель

Инструменты

Разрешения

Режим

Скрытый

Разрешения задач

Цвет

Top P

Дополнительно

Создание агентов

Варианты использования

Примеры

Агент документации

Аудитор безопасности