Открыть в интерактивной справке · markdown для агентов: https://neuraldeep.ru/docs/book-api.md

Книга «Агенты и вайб-кодинг» · поиск и MCP

Практический курс о работе с ИИ-агентами — 42 главы — доступен как поиск для агентов. Нужен твой ключ Hub — тот же sk-, что и для чата. Читалка на сайте открыта всем без ключа — neuraldeep.ru/learn/books/agenty-vajbkoding.

Поиск гибридный: полнотекстовый BM25 плюс векторный по эмбеддингам giga-embeddings (370 чанков, нарезка по абзацам). Они ошибаются по-разному — полнотекстовый находит точное слово, но бессилен, когда спрашивают другими словами; векторный ловит смысл, но промахивается мимо термина. Слияние закрывает обе дыры, поэтому mode=hybrid стоит по умолчанию.

curl -G "https://neuraldeep.ru/api/v1/books/agenty-vajbkoding/search" \
  -H "Authorization: Bearer $YOUR_KEY" \
  --data-urlencode "q=сколько стоит держать много скиллов" \
  --data-urlencode "mode=hybrid" --data-urlencode "limit=5"

{
  "query": "…", "mode": "hybrid", "used_vector": true,
  "hits": [{
    "chapter": "ch12",
    "chapter_title": "Скиллы: механика и жизненный цикл",
    "label": "Глава 12",
    "score": 0.032,
    "text": "Скиллы платные, даже когда не используются…",
    "url": "https://neuraldeep.ru/learn/books/agenty-vajbkoding/ch12"
  }]
}

Эндпоинты

метод что делает
GET /api/v1/books список книг
GET /api/v1/books/{slug}/toc оглавление: главы, приложения, модули
GET /api/v1/books/{slug}/chapter/{id} полный текст главы (ch12, appА)
GET /api/v1/books/{slug}/search поиск: q, mode = hybrid|fts|vector, limit 1–20

MCP-сервер — тот же поиск инструментами для твоего агента:

{
  "mcpServers": {
    "neuraldeep-book": {
      "type": "http",
      "url": "https://neuraldeep.ru/api/mcp/book",
      "headers": { "Authorization": "Bearer $YOUR_KEY" }
    }
  }
}

Инструменты: book_search (гибридный поиск), book_chapter (глава целиком), book_toc (оглавление). Транспорт — JSON-RPC поверх HTTP, состояния сервер не держит. Без ключа — 401.

Ограничения. 60 запросов в минуту на ключ. Счёт идёт по владельцу ключа, а не по адресу, — доп-ключи считаются вместе с основным. Ответы модели по книге остаются в читалке: за ними GPU, и там действует лимит тарифа (free 10 вопросов в сутки).

Книга собрана из полугода переписки сообщества t.me/aostrikov_agents_chat.

Разделы справки (markdown для агентов)