Agent with Knowledge
Create agents with knowledge base capabilities for enhanced information retrieval. Learn the setup patterns, APIs, and practical examples needed to build...
Create agents with knowledge base capabilities for enhanced information retrieval.
Quick Start
Clone the Complete Example
The easiest way to get started is to clone the complete example repository:
git clone https://github.com/astreus-ai/examples
cd examples/agent-with-knowledge
npm installOr Install Package Only
If you prefer to build from scratch:
npm install @astreus-ai/astreusEnvironment Setup
# .env
# LLM API key
OPENAI_API_KEY=sk-your-openai-api-key-here
# Knowledge database (required for RAG)
KNOWLEDGE_DB_URL=postgresql://username:password@localhost:5432/knowledge_db
# Main database for agent persistence
DB_URL=sqlite://./astreus.dbKnowledge Agent
import { Agent } from '@astreus-ai/astreus';
// Create agent with knowledge enabled
const agent = await Agent.create({
name: 'CosmosBot',
model: 'gpt-4o',
embeddingModel: 'text-embedding-3-small', // Specify embedding model directly
knowledge: true,
systemPrompt: 'You can search and retrieve information from scientific knowledge bases about the cosmos and universe.'
});
// Add knowledge from scientific book about the sun and cosmos
await agent.addKnowledgeFromFile(
'./data/The Sun\'s Light and Heat.pdf',
{ category: 'solar-physics', version: '1.0' }
);
// Agent automatically uses knowledge in conversations
const response = await agent.ask("What is Correction for Atmospheric Absorption? Explain.");
console.log(response); // Uses knowledge base automaticallyRunning the Example
If you cloned the repository:
npm run devRepository
The complete example is available on GitHub: examples/agent-with-knowledge
Last updated: July 6, 2026
In this section
Your First Agent
Create your first AI agent with Astreus framework. Learn the setup patterns, APIs, and practical examples needed to build reliable Astreus agent systems.
Basic Sub-Agents
Create and coordinate multiple AI agents for complex task delegation. Learn the setup patterns, APIs, and practical examples needed to build reliable...
Advanced Sub-Agents
Build sophisticated multi-agent workflows with complex coordination patterns and specialized capabilities.
Basic Graphs
Create simple workflow graphs to orchestrate multi-step processes. Learn the setup patterns, APIs, and practical examples needed to build reliable Astreus...