Package com.tnsai.rag

Class ChatKnowledgeBindingValidator

java.lang.Object

com.tnsai.rag.ChatKnowledgeBindingValidator

public final class ChatKnowledgeBindingValidator
extends Object

The one rule a chat knowledge binding must meet before it grounds a conversation, whoever installs it: an agent, its builder or an integration.

A binding is valid for an owner when

• a declaration backs it: it is not undeclared;
• it belongs to that exact owner: its owner id equals the owner's id when the caller knows one, and its exact owner object, when it was created with one, is the owner itself;
• every source it searches is an enabled SEARCH entry of the owner's chat knowledge, as KnowledgeDeclarations.chatScope(List) reads it, so a GRAPH entry never backs a binding;
• it searches the MEMORY entry alone or only the other SEARCH entries, since a chat turn searches the two kinds each on its own; and
• its topK equals the topK the SEARCH entries of its kind declare, merged field by field over KnowledgeDeclarations.chatSearchDefaults() as the agent wires them.

Knowledge an AgentBuilder gives is layered into the same entries first, so it is checked the same way.

Since:

0.18.0

Method Summary

Modifier and Type	Method	Description
static boolean	searchesMemory(ChatKnowledgeBinding binding, List<KnowledgeEntry> knowledge)	Whether a binding searches the MEMORY entry of the given knowledge rather than its other SEARCH entries: whether any of its sources names an enabled MEMORY entry of the chat scope.
static void	validate(ChatKnowledgeBinding binding, Object owner, String ownerId, List<KnowledgeEntry> knowledge, String where)	Checks a binding against the owner's declared knowledge.

Methods inherited from class java.lang.Object

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

Method Details

validate

public static void validate(ChatKnowledgeBinding binding,
 Object owner,
 String ownerId,
 List<KnowledgeEntry> knowledge,
 String where)

Checks a binding against the owner's declared knowledge.

Parameters:

binding - the binding to install

owner - the exact conversation owner

ownerId - the owner's id, or null when the caller has none and the binding must name the owner object

knowledge - the owner's knowledge entries; only the SEARCH ones in its chat scope count

where - the declaration site, used in messages

Throws:

IllegalArgumentException - when the binding breaks the rule or is undeclared

searchesMemory

public static boolean searchesMemory(ChatKnowledgeBinding binding,
 List<KnowledgeEntry> knowledge)

Whether a binding searches the MEMORY entry of the given knowledge rather than its other SEARCH entries: whether any of its sources names an enabled MEMORY entry of the chat scope. A binding that validate(com.tnsai.rag.ChatKnowledgeBinding, java.lang.Object, java.lang.String, java.util.List<com.tnsai.rag.KnowledgeEntry>, java.lang.String) accepts searches one kind only.

Parameters:

binding - a chat binding

knowledge - the owner's knowledge entries

Returns:

whether the binding searches the MEMORY entry

Since:

0.18.6