Achilles — Query Engine

Оркестратор пользовательского диалога — не только RAG. Ход ведёт chat-модель, выбранная пользователем; у неё в руках инструмент search_knowledge (когда база непуста), и она решает на каждом сообщении, обращаться ли к базе. Разговор — отвечает из себя; вопрос к знаниям — зовёт поиск и строит ответ на найденном, со стримингом и цитированием. Сам retrieval (поиск и ACL pre-filter) принадлежит Knowledge Store; Query Engine его не делает — вызывает инструментом.

Архитектура

Четыре столпа модуля

⟨ ⟩

Диалог

Query Engine — оркестратор беседы, а не только RAG. Держит состояние; surface'ы — тонкие клиенты.

conversations messages retrieval_trace access_counter

✦

Модель решает

Ход ведёт chat-модель AI — один инструмент в руках.

search_knowledge

↩ Разговор — отвечает из себя, без цитат

⇲ К знаниям — зовёт search_knowledge

▸▸▸

RAG-маршрут

Один вызов — пять шагов. Граница владения проходит по ленте.

◇ точный кэш? → мимо ленты

Embed › Retrieve › Rerank › Augment › Generate

KS·2 QE·3

Grounding

Контракт ответа — три обещания.

✓ Только из найденного — не из памяти модели

¶ Цитата на запись — каждое утверждение

∅ Честное «не нашёл» вместо догадки

↻один опциональный вызов без петли ⤳Agent Engine минует Query Engine ⇉ответ: answer + citations, стриминг

API

POST/api/v1/conversations
GET/api/v1/conversations/{id}
POST/api/v1/conversations/{id}/messages · SSE
PATCH/api/v1/messages/{id}/feedback
GET/api/v1/chat/models

Workzone Проектирование

Детальные решения по проектированию модуля.

RAG-маршрут Диалог Grounding и цитирование Граница с Knowledge Store Защита и приватность Модель данных Стек Тесты

Макеты Surface'ы

Своего фронтенда у модуля нет — диалог и ответ рендерят surface'ы как тонкие клиенты единого API. Экраны чата (ответ с заземлением, состояния ответа) живут в Web App; сам контракт заземления — в workzone, Grounding.