Агенты

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

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

Типы

В Dropstone есть два типа агентов: основные агенты и подагенты.

Основные агенты

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

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

Подагенты

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

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

Встроенные

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

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

Режим: primary

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

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

Режим: primary

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

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

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

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

Режим: subagent

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

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

Режим: subagent

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

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

Режим: primary

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

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

Режим: primary

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

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

Режим: primary

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

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

1. Для основных агентов используйте клавишу Tab для переключения между ними во время сеанса. Вы также можете использовать настроенную клавишу switch_agent.

2. Подагенты можно вызывать:

   • Автоматически основными агентами для специализированных задач на основе их описаний.

   • Вручную, упоминая подагента @ в вашем сообщении. Например:

     @general help me search for this function
     

3. Навигация между сеансами: Когда подагенты создают дочерние сеансы, используйте session_child_first (по умолчанию: <Leader>+Down) для входа в первый дочерний сеанс из родительского.

4. Когда вы находитесь в дочернем сеансе, используйте:

   • session_child_cycle (по умолчанию: Right) для переключения на следующий дочерний сеанс
   • session_child_cycle_reverse (по умолчанию: Left) для переключения на предыдущий дочерний сеанс
   • session_parent (по умолчанию: Up) для возврата в родительский сеанс

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

Настройка

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

JSON

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

{
  "$schema": "https://dropstone.io/schema/config.json",
  "agent": {
    "build": {
      "mode": "primary",
      "model": "dropstone/dropstone-pro",
      "prompt": "{file:./prompts/build.txt}",
      "permission": {
        "edit": "allow",
        "bash": "allow"
      }
    },
    "plan": {
      "mode": "primary",
      "model": "dropstone/dropstone-fast",
      "permission": {
        "edit": "deny",
        "bash": "deny"
      }
    },
    "code-reviewer": {
      "description": "Reviews code for best practices and potential issues",
      "mode": "subagent",
      "model": "dropstone/dropstone-pro",
      "prompt": "You are a code reviewer. Focus on security, performance, and maintainability.",
      "permission": {
        "edit": "deny"
      }
    }
  }
}

Markdown

Вы также можете определить агентов с помощью файлов markdown. Поместите их в:

• Глобально: ~/.config/dropstone/agents/
• По проекту: .dropstone/agents/

---
description: Reviews code for quality and best practices
mode: subagent
model: dropstone/dropstone-pro
temperature: 0.1
permission:
  edit: deny
  bash: deny
---

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"
    }
  }
}

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

Температура

Контролируйте случайность и творчество ответов ИИ с помощью конфигурации 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}"
    }
  }
}

Если температура не указана, Dropstone использует разумное значение по умолчанию, настроенное для каждого уровня.

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

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

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

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

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

Отключение

Установите значение true для отключения агента.

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

Подсказка

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

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

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

Модель

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

{
  "agent": {
    "plan": {
      "model": "dropstone/dropstone-fast"
    }
  }
}

ID модели использует формат dropstone/<tier>. Используйте dropstone/dropstone-fast, dropstone/dropstone-pro или dropstone/dropstone-heavy.

Инструменты (устарело)

tools устарело. Предпочитайте поле permission агента для новых конфигураций, обновлений и более детального контроля.

Позволяет вам контролировать, какие инструменты доступны в этом агенте. Вы можете включить или отключить конкретные инструменты, установив их на true или false. В конфигурации tools агента true эквивалентно {"*": "allow"} разрешению, а false эквивалентно {"*": "deny"} разрешению.

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

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

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

Узнайте больше об инструментах.

Разрешения

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

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

Доступные ключи разрешений:

read, edit, glob, grep, list, bash, task, external_directory, lsp и skill принимают либо сокращенное действие ("allow" | "ask" | "deny"), либо объект глоба/шаблона → действие для детального контроля. Остальные ключи принимают только сокращенное действие.

{
  "$schema": "https://dropstone.io/schema/config.json",
  "permission": {
    "edit": "deny"
  }
}

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

{
  "$schema": "https://dropstone.io/schema/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://dropstone.io/schema/config.json",
  "agent": {
    "build": {
      "permission": {
        "bash": {
          "git push": "ask",
          "grep *": "allow"
        }
      }
    }
  }
}

Это может принимать глоб-шаблон.

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

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

{
  "$schema": "https://dropstone.io/schema/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
    }
  }
}

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

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

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

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

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

Цвет

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

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

Любые другие опции, которые вы указываете в конфигурации агента, передаются напрямую как опции модели. Для уровней Dropstone поддерживаемые сквозные опции — это глубина рассуждений и многословность текста:

{
  "agent": {
    "deep-thinker": {
      "description": "Agent that uses high reasoning effort for complex problems",
      "model": "dropstone/dropstone-heavy",
      "variant": "xhigh",
      "textVerbosity": "low"
    }
  }
}

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

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

dropstone agent create

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

1. Спросить, где сохранить агента; глобально или для конкретного проекта.
2. Описание того, что должен делать агент.
3. Сгенерировать подходящую системную подсказку и идентификатор.
4. Позволить вам выбрать, какие разрешения должны быть у агента (все, что вы не выберете, будет запрещено).
5. Наконец, создать файл markdown с конфигурацией агента.

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

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

• Агент Build: Полная разработка со всеми включенными инструментами
• Агент Plan: Анализ и планирование без внесения изменений
• Агент Review: Проверка кода с доступом только для чтения плюс инструменты документации
• Агент Debug: Сфокусирован на исследовании с включенными инструментами bash и read
• Агент Docs: Написание документации с операциями над файлами, но без системных команд

Примеры

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

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

---
description: Writes and maintains project documentation
mode: subagent
permission:
  bash: deny
---

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
permission:
  edit: deny
---

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