На этой странице

Генерация ответа и просмотр источников

В разделе Работа выберите Поиск для выдачи фрагментов или Ответ для готового текста с источниками. Ниже приведены те же варианты через API.

Прочитайте результат

  • POST /api/v1/spaces/{space_id}/search возвращает ранжированные sources после преобразований, поиска и переранжирования.

  • POST /api/v1/spaces/{space_id}/query возвращает answer и sources, а при наличии — идентификатор запроса и сведения о выполнении.

  • POST /api/v1/spaces/{space_id}/query/stream возвращает события SSE. Показывайте ход работы по stage и check, промежуточный текст — по token, если они приходят. Итоговый ответ, источники и результат берите из единственного завершающего done. Последнее событие error означает сбой.

Передайте JSON с непустым query и при необходимости top_k (от 1 до 20, по умолчанию 5). Доступ к пространству проверяется при каждом запросе. Учётные данные и примеры запросов см. в Интеграции.

Отфильтруйте документы

metadata_filter отбирает документы по индексируемым полям схемы до ранжирования. Для агентного ответа и генерации graph_global запросы /query и /query/stream с фильтром вернут 409. В обоих случаях используйте /search для поиска фрагментов. Локальный поиск по графу фильтрует исходные фрагменты и отбрасывает описания, которые нельзя связать с выбранными документами. Если индекс BM25 или SPLADE для подключённого хранилища не содержит метаданных строк, перестройте дополнительный индекс через POST /api/v1/spaces/{space_id}/storage/index перед поиском с фильтром.

Откройте и процитируйте источник

  • Показывайте text и locator, если адрес доступен. В проверенном адресе могут быть документ, путь к разделу, страница или диапазон символов Unicode с исключённой правой границей. Показывайте доступную библиографию в метаданных, отдельно от ссылки на скачивание.

  • Отделяйте от цитаты parent_text из иерархической нарезки и graph_context из поиска по графу. Балл относится к конкретному ранжированию и может отсутствовать.

  • Полный канонический чанк читайте через метод карточки чанка или MCP fetch_source. Для внешних записей и источников, созданных графом, показывайте текст и идентификатор из ответа.

В разделе Работа нажмите Открыть фрагмент 1 или выберите другой номер. Показать контекст раскрывает parent_text, если он есть. Скачать исходник доступно, когда есть документ. Показать на карте открывает карту эмбеддингов для вопроса.

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

Поддержка фильтров · Поля источника · События потока

Ответ по фрагментам (llm)

Настройте LLM в пространстве и укажите ноду llm в поле generate. Она получает исходный вопрос и найденные фрагменты. generation_instruction задаёт правила ответа. Пустое значение включает стандартный промпт. Поля model, api_base и temperature переопределяют настройки генерации, а авторизация у провайдера и остальные параметры наследуются из пространства.

{
  "node": "llm",
  "params": {
    "generation_instruction": "Укажи требуемое действие и срок на отдельных строках."
  }
}

При изменении generate сохраните остальные шаги конвейера. С "generate": null обычный запрос может вернуть источники и пустое поле answer. Если этапу нужна модель, которую не удаётся выбрать из настроек, запрос может вернуть 409. Режим поиска пропускает генерацию и выполняет настроенные преобразования и переранжирование, в том числе с вызовом модели.

Для вопросов о темах всего корпуса см. Глобальный ответ по графу (graph_global) в разделе Построение и использование графа знаний.

Реализация

Проверка ответа перед выдачей (rubric)

Нода привязывает к конвейеру один критерий опубликованной версии рубрики. Создайте и опубликуйте рубрику, затем добавьте проверку в postgeneration. Для неё задаются уникальный UUID id, rubric_version_id и criterion_key. Проверка выполняется при генерации в конвейере. Когда за ответ отвечает граф агентов, проверки postgeneration из конвейера для него не выполняются. Версия рубрики неизменна, переход на новую версию требует явного изменения привязки.

Если опубликован критерий JSON Schema с ключом deadline_format, добавьте в конвейер элемент из примера. Задайте новый id и замените пример rubric_version_id на UUID опубликованной версии. Поля проверки задаются непосредственно в элементе списка postgeneration.

{
  "postgeneration": [
    {
      "node": "rubric",
      "id": "3d875fca-1d6f-4016-bae9-4b4ab8ba23f7",
      "rubric_version_id": "8d45cd86-8281-4a68-99ee-9b80ecbef22c",
      "criterion_key": "deadline_format",
      "on_failure": "observe"
    }
  ]
}

Выберите способ оценки критерия:

  • llm проверяет правило, выраженное словами. Укажите настройки модели-судьи в judge.

  • regex проверяет Unicode-текст по регулярному выражению. Задайте pattern, mode (поиск или полное совпадение), expect_match и при необходимости флаги ignore_case, multiline и dotall.

  • json_schema проверяет ответ как чистый JSON. Схема передаётся строкой в schema_json для диалекта 2020-12. Оформление блоком кода и некорректный JSON не проходят проверку. Ссылочные ключевые слова JSON Schema отклоняются, а format используется как аннотация. Оба способа проверки формата работают без модели.

Результат проверки — pass, fail или unevaluable. Начните с политики по умолчанию on_failure="observe" и изучите результаты. Необязательные критерии не останавливают ответ. Для обязательного критерия можно заблокировать выдачу (block), повторить генерацию на тех же материалах (regenerate) или получить новые материалы по изменённому запросу (retrieve_regenerate). Лимит max_retries действует для каждой ноды на весь исходный запрос и по умолчанию равен нулю. Если обязательная проверка с политикой остановки не смогла выполнить оценку или исчерпан бюджет исправлений, ответ удерживается. Проверьте итоговое поле outcome="blocked". Политика остановки может удерживать события token, пока результат проверки неизвестен.

Проверьте пример на типовых ответах. Если клиент всегда ожидает JSON, сделайте критерий обязательным и выберите политику block. Для проверки качества на всём наборе используйте Оцените качество поиска и ответов.

Настройки проверки · Условия выдачи

Несколько поисков с агентом

Агентные шаблоны используют отдельный путь генерации с поисковым конвейером пространства. Настройте языковую модель для пространства. Шаблон agent позволяет одному агенту повторять поиск по мере необходимости. agent-wide добавляет поиск по точным словам и чтение соседних фрагментов. agent-multistep распределяет маршрутизацию, поиск, синтез и проверку между агентами, добавляя вызовы модели. Источники могут прийти из разных вызовов инструментов, поэтому общей оценки ранжирования у них может не быть. В потоке можно получить сообщения об этапах, а полный текст — только в конце. Прежде чем менять способ ответа, сравните источники, задержку и стоимость с обычным конвейером.

После входа в систему получите три шаблона через GET /api/v1/pipeline/presets. Каждый содержит гибридный pipeline и agent_graph. Передайте объект pipeline в теле запроса PUT /api/v1/spaces/{space_id}/config и дождитесь перестроения индекса, если оно требуется. Затем передайте объект agent_graph целиком в теле запроса PUT /api/v1/spaces/{space_id}/agent-graph. Для инструментов поиска по ключевым словам нужен лексический ретривер. Чтобы получить только граф с одним агентом по умолчанию, используйте GET /api/v1/agent-graph/preset.

Настройка графа агентов · Выполнение графа агентов

ContextBase0.1.0

Поиск в документации