API
지식 베이스 검색
질문에 가장 잘 답하는 구절을 AI와 같은 방식으로 찾습니다.
POST/knowledge/search
워크스페이스에 실제 호출을 실행합니다.
POST /knowledge/search
질문에 가장 잘 답하는 구절을 AI와 같은 방식으로 찾습니다.
예시
knowledge:read가 필요합니다. query는 최대 500자입니다. address가 있으면 그 주소를 위해 AI가 쓰는 수준을 검색하며, 가장 구체적인 수준을 조금 더 위에 둡니다. scope가 있으면 그 한 수준만 검색합니다. 둘 다 없으면 볼 수 있는 모든 수준을 검색합니다. limit은 최대 25이고 기본값은 8입니다.
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는 한 응답 안의 결과를 정렬하는 데만 씁니다.
항목은 텍스트를 읽는 즉시 검색 대상이 됩니다. 바뀐 항목을 다시 읽는 동안에는 이전 텍스트가 검색됩니다.