Перейти к документации
API

Поиск по базе знаний

Фрагменты, которые лучше всего отвечают на вопрос, найденные так, как их находит ИИ.

POST/knowledge/search

Выполняет настоящий запрос в вашем рабочем пространстве.

POST /knowledge/search

Фрагменты, которые лучше всего отвечают на вопрос, найденные так, как их находит ИИ.

Пример

Требует knowledge:read. query длиной до 500 символов. С address поиск идёт по уровням, которые ИИ использует для этого адреса, причём самый конкретный ставится чуть выше. С scope поиск идёт по одному этому уровню. Без них по всем уровням, которые вы видите. limit доходит до 25 и по умолчанию равен 8.

curl
curl -X POST "$OE/knowledge/search" -H "$AUTH" -H "Content-Type: application/json" \  -d '{ "query": "How long do refunds take?", "address": "[email protected]" }'
Ответ
{  "object": "knowledge_search",  "query": "How long do refunds take?",  "hits": [    {      "sourceId": "kb_8c1f4a2b9d7e3f60a5c7b21d",      "title": "Refunds",      "kind": "note",      "scope": "@acme.com",      "level": "domain",      "url": null,      "heading": "",      "text": "Refunds are paid within 14 days of the return reaching our warehouse.",      "score": 0.83    }  ]}

Он ничего не меняет, поэтому его можно безопасно отправить снова. Из одного элемента берётся не больше трёх фрагментов, а score лишь упорядочивает результаты одного ответа.

Элемент попадает в поиск, как только прочитан его текст. Пока изменённый элемент читается заново, поиск идёт по его прежнему тексту.

Справочник