Class DocsRetrievalClient

java.lang.Object

ch.tocco.nice2.optional.aiassistant.impl.function.manual.DocsRetrievalClient

@Component
public class DocsRetrievalClient
extends Object

Client for the docs-retrieval-service, which owns the manual's vector DB and returns the most relevant chunks for a query vector. It generates no answers and hosts no model.

  POST {baseUrl}/retrieve   { vector, version?, language?, topK? } -> { results: [...] }
  GET  {baseUrl}/health     -> { status: "ok", db: true }

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	DocsRetrievalClient.Result
static final record	DocsRetrievalClient.RetrieveRequest
static final record	DocsRetrievalClient.RetrieveResponse

Constructor Summary

Constructors

Constructor	Description
DocsRetrievalClient(ManualParameterProvider parameterProvider)

Method Summary

Modifier and Type	Method	Description
List<DocsRetrievalClient.Result>	retrieve(float[] vector, @Nullable String version, @Nullable String language)

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

DocsRetrievalClient

public DocsRetrievalClient(ManualParameterProvider parameterProvider)

Method Details

retrieve

public List<DocsRetrievalClient.Result> retrieve(float[] vector,
 @Nullable String version,
 @Nullable String language)

Returns:

the relevant manual chunks for the query vector, ordered by relevance

Throws:

AiAssistantException - if the service is unreachable or returns a non-2xx status