Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.orkeia.ai/llms.txt

Use this file to discover all available pages before exploring further.

Knowledge Bases are sources of information that expand an agent’s memory and context, ensuring that the agent has access to reliable and domain-specific data. A knowledge base can contain internal documents, FAQs, technical articles, historical records, spreadsheets, manuals, or even web pages.

​
How Agents Use Knowledge Bases

  • An agent can consume a knowledge base in various ways:
    Context retrieval: when a user’s question is asked, the agent searches the knowledge base for relevant excerpts.
  • Integration with the model: the retrieved content is injected into the AI model’s prompt.
  • Evidence-based response: the model generates the output by combining natural language with data from the base.
  • Multimodal support: depending on the configuration (multimodal: true), the base can contain not only text but also images, audio, and video.

​
Types of Knowledge Bases:

  • file: documents such as PDFs, spreadsheets, or presentations.
  • url: links to internal or external websites.
  • text: direct blocks of structured knowledge.

​
Best Practices

  • Use tags to organize and allow the agent to perform quick searches (e.g.: [“finance”, “contracts”]).
  • Security: restrict access by sectors to prevent leakage of sensitive information.
  • Selective enabling: control the enabled status to activate/deactivate bases depending on the environment or project.

​
Orkeia Knowledge Base Interface

Orkeia allows, via API, to pass knowledge bases to our agents, below is an example of the interface: 
export interface KnowledgeBase {
  id?: string;
  name: string;
  description: string;
  enabled: boolean;
  sectors: string[];
  content: string;
  type: 'file' | 'url' | 'text';
  multimodal: boolean;
  tags: string[];
}

​
Example of Orkeia Knowledge Base JSON

{
  "id": "kb_internal_policies",
  "name": "Internal Policies",
  "description": "Knowledge base with company regulations, policies, and internal procedures.",
  "enabled": true,
  "sectors": ["hr", "legal", "management"],
  "content": "https://storage.orkeia.ai/kb/policies.pdf",
  "type": "file",
  "multimodal": false,
  "tags": ["compliance", "employee-handbook", "contracts"]
}