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

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

Source: https://eggent.ai/r/docs/agent-tools/

Инструмент — это действие, которое агент может выполнить сам. Ниже — все инструменты воркспейса в полном режиме чата. В режиме [«диалог и файлы»](https://eggent.ai/r/docs/chats.md#modes) остаются только чтение файлов и переключение проектов, в режиме «просто диалог» инструментов нет.

## Файлы и команды {#files}

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

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

## Интернет {#web}

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

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

## Помощники и расписания {#subagents}

| Инструмент | Что делает |
| --- | --- |
| `Agent` | Запускает помощника — отдельного агента для части работы — и ждёт его результата. Несколько вызовов в одном сообщении работают одновременно, до шести. С параметром расписания вместо этого создаёт [задачу по расписанию](https://eggent.ai/r/docs/schedules.md) |
| `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. Файлы расписаний нельзя править напрямую: только через этот инструмент.

## Проекты и воркспейс {#workspace}

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

## Память {#memory}

| Инструмент | Что делает |
| --- | --- |
| `eggent_memory_save` | Сохраняет запись в [память](https://eggent.ai/r/docs/memory.md) текущего проекта или оркестратора |
| `eggent_memory_search` | Ищет в памяти |
| `eggent_memory_delete` | Удаляет подходящие записи |

## Общение с человеком {#communication}

| Инструмент | Что делает |
| --- | --- |
| `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` | [Почта агента](https://eggent.ai/r/docs/email.md): `send_email`, `list_emails`, `read_email`, `email_status`, `my_address` |
| `eggent_google` | В облаке — твой [Google](https://eggent.ai/r/docs/google.md): `status`, `connect`, документы, таблицы, презентации, файлы и папки на Диске, `share_link` (ждёт твоего «да») |
| `eggent_calendar_file` | Делает файл календаря (`.ics`) для события, который открывается в любом календаре |

## Модели и картинки {#models}

| Инструмент | Что делает |
| --- | --- |
| `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` | Только в облаке: остаток кредитов, дней и места, текущий тариф |

## Доска задач {#board}

| Инструмент | Что делает |
| --- | --- |
| `eggent_board` | [Доска задач](https://eggent.ai/r/docs/board.md): `list` и `get` читают её; `create` записывает карточки (название, задачу, проект, `after` — карточки, которых она ждёт, `#1` — более ранняя карточка того же списка) во «Входящие»; `update` и `remove` меняют только карточки, которые ещё во «Входящих». Карточку агент никогда не запускает — это делает человек |

## Работа с коллегами {#company}

Только в воркспейсе, который входит в [компанию](https://eggent.ai/r/docs/company.md).

| Инструмент | Что делает |
| --- | --- |
| `eggent_messages` | [Сообщения](https://eggent.ai/r/docs/company.md#messages) с людьми компании: `contacts`, `inbox`, `read`, `send` (с пометкой, что написал агент), `describe` (запоминает, кто чем занимается) |
| `eggent_shares` | [Общие файлы](https://eggent.ai/r/docs/company.md#shares): `people`, `list`, `read` (текст общего файла), `comments`, `comment` (от имени человека, к фрагменту, если он указан), `share` (добавляет людей с ролью — просмотр, комментарии или правка — и ни у кого файл не забирает). Менять чужой файл он не может |
| `eggent_approvals` | [Согласования](https://eggent.ai/r/docs/company.md#approvals): `people`, `waiting`, `sent`, `read`, `text` (текст версии), `send` (файл людям по порядку), `withdraw`. Согласовать или вернуть версию он не может — это делает человек |

## Навыки как команды {#skill-commands}

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