Поиск через Serper: web_search — выдача Google, search_images — Google Картинки

- web_search: верх выдачи Google через Serper (ответ, 6 результатов со сниппетами, новости) — ~$0.001 за запрос
  вместо серверного поиска OpenRouter ($0.014) и отдельного агента-поисковика
- search_images: Google Картинки (фото людей, мемы) — прямые ссылки, миниатюры как запасные, подпись, сайт, размер
- attach_media принимает до 20 ссылок: оригиналы и запасные миниатюры
- Оба инструмента включает SERPER_API_KEY; WEB_SEARCH, Wikimedia Commons и prompts/web-search.md убраны

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
yunogasai
2026-10-13 23:39:48 +02:00
parent cce3fca94b
commit 1a7271a491
14 changed files with 164 additions and 216 deletions

View File

@@ -9,9 +9,8 @@ Telegram-бот для групповых чатов с AI-личностями.
- **Контекст из чата**: бот сохраняет сообщения чата в SQLite (последние `HISTORY_LIMIT` на чат). Попросите «посмотри последние 100 сообщений и перескажи» — агент сам вызовет инструмент `read_chat_messages` и загрузит переписку в контекст. Если задать `/ask` ответом на чьё-то сообщение, оно тоже попадёт в контекст.
- **Участники**: бот запоминает имя, фамилию и ник каждого, кто пишет в чат (и тех, кого упомянули по имени-ссылке). Можно спрашивать «что писал @ivan?», «что думает Иван про выручку?», «кто тут самый активный?» — агент найдёт человека по нику или имени (инструменты `list_chat_members`, `read_member_messages`) и обращается к людям по имени.
- **Фото**: пришли фото с подписью, где упомянут бот (в личке — просто фото), или ответь на фото через `/ask` / упоминание — модель посмотрит картинку. Нужна модель со зрением (Gemini через OpenRouter по умолчанию); DeepSeek фото не видит и честно об этом скажет.
- **Интернет и вложения**: «что нового про …», «найди фото капибары», «пришли это файлом». Агент ищет в интернете (`web_search`) и прикрепляет к ответу картинки, GIF, видео, аудио и файлы по ссылке (`attach_media`) или файл, который составил сам (`attach_file`); картинки со страницы по ссылке пользователя — `page_images`. Вложения уходят после текста ответа: фото и видео — альбомом, не больше 10; не принял Telegram как фото — отправляются файлом.
- Картинки: `web_search` с `imageQuery` сам собирает прямые ссылки на картинки — со страниц выдачи (og:image и крупные `<img>`) и из [Wikimedia Commons](https://commons.wikimedia.org) (бесплатно, без ключа); агенту остаётся выбрать и прикрепить.
- Поиск — серверный инструмент OpenRouter [`openrouter:web_search`](https://openrouter.ai/docs/guides/features/server-tools/web-search) (для Gemini — Google Search, ~$0.014 за поиск с баланса OpenRouter, других ключей не нужно). Ищет отдельный агент Mastra без памяти и возвращает основному сводку со ссылками — так найденное остаётся у агента до конца ответа. Только для моделей через OpenRouter; выключить — `WEB_SEARCH=false`.
- **Интернет и вложения**: «что нового про …», «найди фото Илона Маска», «скинь мем с котом», «пришли это файлом». Агент ищет в Google (`web_search`) и в Google Картинках (`search_images`) и прикрепляет к ответу картинки, GIF, видео, аудио и файлы по ссылкам (`attach_media`: битые ссылки пропускает и берёт запасные) или файл, который составил сам (`attach_file`); картинки со страницы по ссылке пользователя — `page_images`. Вложения уходят после текста ответа: фото и видео — альбомом, не больше 10; не принял Telegram как фото — отправляются файлом.
- Поиск — через [Serper.dev](https://serper.dev) (выдача Google по API): нужен `SERPER_API_KEY`, 2500 запросов бесплатно без карты, дальше ~$1 за 1000 (запрос = один поиск или одна страница картинок). Без ключа агент не ищет в интернете, остальное работает.
- Ссылки из интернета бот скачивает сам: только публичные адреса (внутренняя сеть, localhost и редиректы туда запрещены), до 20 МБ, 15 секунд. Файлы в память Mastra не попадают — модели уходит только «прикреплено: фото …».
- **Память — две части**:
- *Контекст диалога* — вопросы к боту и его ответы в этом чате, хранит [Mastra Memory](https://mastra.ai/docs/memory/message-history) (`memory.db` рядом с `DB_PATH`). Подкладывается в каждый запрос, поэтому можно уточнять «а подробнее?». Самые старые реплики Mastra срезает, когда промпт не влезает в `CONTEXT_TOKEN_LIMIT`; результаты инструментов из прошлых ответов (`ToolCallFilter`) и фото в историю не попадают. `/clear` сбрасывает только контекст: в группе — сразу её, в личке с ботом — выбор чата кнопками (или `/clear <ID чата>`) с подтверждением.
@@ -40,7 +39,6 @@ Telegram не отдаёт ботам сообщения, написанные
## Промпты и личности
- `prompts/system.md` — общие правила бота (формат ответа, инструменты). Читается при старте.
- `prompts/web-search.md` — промпт агента, который ищет в интернете для `web_search`.
- `prompts/personas/<id>.md` — промпт личности; список личностей (id и название) — в `src/constants/personas.ts`.
- `pnpm seed` синхронизирует личности с БД (добавляет, обновляет, удаляет лишние). В Docker seed выполняется при каждом старте контейнера, локально — в `pnpm dev`.
@@ -69,7 +67,7 @@ pnpm dev
| `DEEPSEEK_API_KEY` | да* | ключ DeepSeek напрямую (api.deepseek.com); используется по умолчанию, если ключа OpenRouter нет — модель `deepseek/deepseek-flash`, только текст |
| `AI_MODEL` | нет | явная модель Mastra model router `<провайдер>/<модель>`, например `deepseek/deepseek-v4-pro` |
| `AI_IMAGE_INPUT` | нет | `true`/`false` — отправлять ли модели фото. Для моделей по умолчанию выставляется само (Gemini — да, DeepSeek — нет); для своей `AI_MODEL` по умолчанию `false` |
| `WEB_SEARCH` | нет | `true`/`false` — поиск в интернете (серверный инструмент OpenRouter, платный). По умолчанию включён для моделей OpenRouter; с другими провайдерами недоступен |
| `SERPER_API_KEY` | нет | ключ [Serper.dev](https://serper.dev) — поиск в Google и Google Картинках; без него агент не ищет в интернете |
\* нужен ключ того провайдера, чья модель выбрана; бот проверяет это при старте.
| `DB_PATH` | нет | путь к SQLite, по умолчанию `data/bot.db` (в Docker — `/app/data/bot.db`) |