EGGENT документация
Справочник

Инструменты агента

Полный справочник инструментов, которые есть у агента Eggent, — назначение, основные параметры и примеры просьб, которые к ним приводят. Пригодится и людям, и самому агенту.

Инструмент — это действие, которое агент может выполнить сам. Ниже — все инструменты воркспейса в полном режиме чата. В режиме «диалог и файлы» остаются только чтение файлов и переключение проектов, в режиме «просто диалог» инструментов нет.

Файлы и команды

Базовые инструменты среды выполнения. Работают в папке текущего проекта (или оркестратора).

Инструмент Что делает
read Читает файл: текст, код, картинку (для моделей, которые умеют смотреть)
write Создаёт или перезаписывает файл
edit Точечно правит файл
bash Выполняет команду в терминале: запуск Python и Node.js, git, curl, конвертация файлов
ls Показывает содержимое папки (в режиме «диалог и файлы»)

Интернет

Инструмент Что делает
web_search Ищет в интернете по запросу
fetch_content Загружает страницу по ссылке и достаёт из неё текст
get_search_content Достаёт полный текст найденных результатов

Для поиска ключ не нужен: если один бесплатный поисковик отказал, пробуется следующий, всего три по очереди. Чтобы искать через свой сервис, укажите его ключ в data/pi-agent/web-search.json — файл, в котором назван сервис или ключ, остаётся ровно таким, как вы его написали.

Помощники и расписания

Инструмент Что делает
Agent Запускает помощника — отдельного агента для части работы — и ждёт его результата. Несколько вызовов в одном сообщении работают одновременно, до шести. С параметром расписания вместо этого создаёт задачу по расписанию
get_subagent_result Забирает результат помощника
steer_subagent Даёт работающему помощнику уточнение
eggent_manage_schedules Показывает, меняет или отменяет существующие расписания. Действия: list, update (новое время schedule, новое задание prompt и/или enabled, чтобы поставить на паузу или возобновить), clear. Отчёт запуска по расписанию может только list. Область: current или all

Форматы времени для расписаний: cron из 5 или 6 полей (в варианте с 6 полями первое — секунды), интервал (5m, 1h), отложенный запуск (+10m) или дата ISO. Файлы расписаний нельзя править напрямую: только через этот инструмент.

Проекты и воркспейс

Инструмент Что делает
list_projects Список проектов
create_project Создаёт проект: name, description, instructions
switch_project Переключается в проект или к оркестратору (project_id: "none")
eggent_ask_project Поручает задачу другому проекту и ждёт его ответа. Работает только для проекта, который ты назвал через @ в начале сообщения в этом ходе: сам агент запустить его не может. См. Проекты
eggent_manage_chats Другие чаты: list, search, read; switch переводит разговор в другой чат, new — в новый: в Telegram со следующего сообщения, в браузере — ссылкой
create_skill Создаёт навык: skill_name, description, body
upsert_mcp_server Добавляет или меняет MCP-сервер: stdio (command, args, env) или http (url, headers)
delete_mcp_server Удаляет MCP-сервер
mcp Вызывает инструменты подключённых MCP-серверов

Память

Инструмент Что делает
eggent_memory_save Сохраняет запись в память текущего проекта или оркестратора
eggent_memory_search Ищет в памяти
eggent_memory_delete Удаляет подходящие записи

Общение с человеком

Инструмент Что делает
eggent_ask_user Показывает карточку с вопросом: варианты (options), да/нет (confirm) или свободный ответ (free_text). Рядом с кнопками всегда есть поле для своего ответа
telegram_send_message Отправляет текст в Telegram: в свой чат или в канал (chat: @канал, ссылка t.me или числовой id)
telegram_send_file Отправляет файл. Картинка уходит фото с подписью, остальное — документом; as_file — отправить картинку файлом
eggent_manage_telegram Управляет своим ботом: status, connect, disconnect, allow_user, access_code; в облаке link_shared привязывает твой Telegram к общему боту
eggent_email Почта агента: send_email, list_emails, read_email, email_status, my_address
eggent_google В облаке — твой Google: status, connect, документы, таблицы, презентации, файлы и папки на Диске, share_link (ждёт твоего «да»)
eggent_calendar_file Делает файл календаря (.ics) для события, который открывается в любом календаре

Модели и картинки

Инструмент Что делает
eggent_manage_models status — текущая модель и провайдеры; add_provider — подключить OpenAI-совместимого провайдера (provider_id, base_url, models); use_provider — сделать подключённого провайдера основным
eggent_generate_image Рисует или редактирует картинку: prompt, reference_image_paths, aspect_ratio, size, quality, background, n
eggent_usage_status Только в облаке: остаток кредитов, дней и места, текущий тариф

Доска задач

Инструмент Что делает
eggent_board Доска задач: list и get читают её; create записывает карточки (название, задачу, проект, after — карточки, которых она ждёт, #1 — более ранняя карточка того же списка) во «Входящие»; update и remove меняют только карточки, которые ещё во «Входящих». Карточку агент никогда не запускает — это делает человек

Работа с коллегами

Только в воркспейсе, который входит в компанию.

Инструмент Что делает
eggent_messages Сообщения с людьми компании: contacts, inbox, read, send (с пометкой, что написал агент), describe (запоминает, кто чем занимается)
eggent_shares Общие файлы: people, list, read (текст общего файла), comments, comment (от имени человека, к фрагменту, если он указан), share (добавляет людей с ролью — просмотр, комментарии или правка — и ни у кого файл не забирает). Менять чужой файл он не может
eggent_approvals Согласования: people, waiting, sent, read, text (текст версии), send (файл людям по порядку), withdraw. Согласовать или вернуть версию он не может — это делает человек

Навыки как команды

Каждый установленный навык можно вызвать явно: /skill:<имя> в начале сообщения. Список установленных навыков — в Настройки → Навыки.