На этой странице
Генерация ответа и просмотр источников¶
В разделе Работа выберите Поиск для выдачи фрагментов или Ответ для готового текста с источниками. Ниже приведены те же варианты через 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.