Struct KnowledgeItem 

pub struct KnowledgeItem {
    pub id: String,
    pub name: String,
    pub description: String,
    pub triggers: Vec<String>,
    pub category: String,
    pub core_content: String,
    pub references: Vec<KnowledgeReference>,
    pub metadata: HashMap<String, String>,
    pub enabled: bool,
    pub priority: u32,
}

A knowledge item represents a specialized area of expertise that can be loaded on-demand to provide context to the agent.

Fields

id: String

Unique identifier for this knowledge item

name: String

Human-readable name

description: String

Brief description with trigger keywords

triggers: Vec<String>

Keywords that trigger this knowledge item

category: String

Category for organization (e.g., “language”, “framework”, “tool”)

core_content: String

Core content (lean, ~80 lines max)

references: Vec<KnowledgeReference>

Reference files that can be loaded on-demand

metadata: HashMap<String, String>

Metadata for filtering and search

enabled: bool

Whether this knowledge is enabled

priority: u32

Priority for conflict resolution (higher = more important)

Implementations

impl KnowledgeItem

pub fn new( id: impl Into<String>, name: impl Into<String>, description: impl Into<String>, ) -> Self

Create a new knowledge item with minimal required fields

pub fn with_trigger(self, trigger: impl Into<String>) -> Self

Add a trigger keyword

pub fn with_triggers( self, triggers: impl IntoIterator<Item = impl Into<String>>, ) -> Self

Add multiple trigger keywords

pub fn with_category(self, category: impl Into<String>) -> Self

Set the category

pub fn with_content(self, content: impl Into<String>) -> Self

Set the core content

pub fn with_metadata( self, key: impl Into<String>, value: impl Into<String>, ) -> Self

Set a metadata key/value pair (used for attribution, source tracking, filtering, etc.)

pub fn with_enabled(self, enabled: bool) -> Self

Set whether this item is enabled (note: session-scoped enablement is handled separately).

pub fn with_priority(self, priority: u32) -> Self

Set priority for conflict resolution (higher = more important)

pub fn with_reference(self, reference: KnowledgeReference) -> Self

Add a reference

pub fn matches(&self, query: &str) -> Option<KnowledgeMatch>

Check if this knowledge item matches a query

Trait Implementations

impl Clone for KnowledgeItem

fn clone(&self) -> KnowledgeItem

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for KnowledgeItem

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for KnowledgeItem

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for KnowledgeItem

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.