---
title: "🔒 #26680 ИИ-функция «Поиск по смыслу»: запрос в свободной форме против фич, задач и ошибок продукта по фильтрам - до 10 с пояснением. Сбой модели - лучшие кандидаты подбора без пояснений (`degraded`)."
method: POST
path: "/llm/search/semantic"
tags: ["LLM Functions"]
---

# 🔒 #26680 ИИ-функция «Поиск по смыслу»: запрос в свободной форме против фич, задач и ошибок продукта по фильтрам - до 10 с пояснением. Сбой модели - лучшие кандидаты подбора без пояснений (\`degraded\`).

`POST /llm/search/semantic`

## Request

- Base URL: `http://localhost`
- URL: `http://localhost/llm/search/semantic`
- Auth: one of:
  - API key in header `sid` and API key in header `rts` and API key in header `sig`
  - HTTP bearer

#26680 ИИ-функция «Поиск по смыслу»: запрос в свободной форме против фич, задач и ошибок продукта по фильтрам - до 10 с пояснением. Сбой модели - лучшие кандидаты подбора без пояснений (`degraded`).

**Access:** `authorized` (10 ) · **Scope:** `read`

**Allows:** `product:read` (все обязательны; ресурс — `<тип>ID` / `ID` из запроса, `user:*` — `userID` или сам пользователь)

### TypeScript (copy-paste)

**`POST /llm/search/semantic`**

<details open><summary><b>Body</b></summary>

```typescript
export interface LlmSearchSemanticBody {
  productID: string
  query: string
  filters?: {
  types?: Array<llm_search_semantic_Body_filters_types_item> | null
  categories?: Array<llm_search_semantic_Body_filters_categories_item> | null
  versionID?: string | null
  featureID?: string | null
  includeClosed?: boolean | null
  closedWithinDays?: number | null
} | null
}
```

</details>

<details open><summary><b>Response</b></summary>

```typescript
export type LlmSearchSemanticResponse = IServerResponse<LLMSemanticSearch_Result>

export interface IServerResponse<T = any> {
  code: number
  data: T
  srvTS: number
  rkey: string
}
```

</details>

> Полный файл типов: [`/docs/types`](/docs/types) · raw: [`/docs/api-types.ts`](/docs/api-types.ts)

## Headers

- `devID` string, uuid, required
- `tz` string, required
- `app` string, required
- `appVer` string, required
- `rKey` string

## Request body

- LlmSearchSemanticBody: JSON body for `llm/search/semantic`
  - `productID` string, uuid, required
  - `query` string, required
  - `filters` object, nullable
    - `types` LlmSearchSemanticBodyFiltersTypesItem[], nullable
    - `categories` LlmSearchSemanticBodyFiltersCategoriesItem[], nullable
    - `versionID` string, uuid, nullable
    - `featureID` string, uuid, nullable
    - `includeClosed` boolean, nullable
    - `closedWithinDays` integer, nullable

## Response `200`

OK — `IServerResponse<LLMSemanticSearch_Result>`

- object
  - `code` integer, required
  - `data` LLMSemanticSearchResult, required: Schema LLMSemanticSearch_Result (inferred from ResponseData AST)
  - `srvTS` integer, required: Server timestamp (ms)
  - `rkey` string, required: Request key

## Other responses

- `400`: BadRequest / Validation — неверные params/body/headers
- `401`: Authorize — сессия отсутствует, истекла или невалидна
- `403`: AccessNotAllowed: the function is not activated in the company (reason: notActivated) or no access to the product
- `406`: TimeResync — расхождение rts с сервером
- `422`: UnprocessableContent: the query is shorter than 3 characters (reason: tooShort, min)

---

[API](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api.md) · [All operations](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kosmodrom/apis/kosmodrom-backend-api/revisions/a143b51ba29a?raw)
