Knowledge Base Extension¶

Manage your knowledge files that DeskAgent uses to answer questions.

What is the Knowledge Base?¶

Your knowledge base is a collection of text files that contain information DeskAgent should know about. This includes:

• Company information
• Product details and pricing
• Frequently asked questions
• Procedures and guidelines
• Contact information

DeskAgent reads these files to give accurate, personalized answers.

What You Can Do¶

View Knowledge Files¶

List all files:

See what knowledge files are available.

Read a file:

View the contents of a specific knowledge file.

Example requests:

• "What knowledge files do I have?"
• "Show me the products knowledge file"
• "Read the company information"

Edit Knowledge Files¶

Create new files:

Add new knowledge that DeskAgent can use.

Update files:

Change existing knowledge content.

Add content:

Append new information to existing files.

Remove files:

Delete outdated knowledge.

Example requests:

• "Create a knowledge file about our return policy"
• "Update the pricing in the products file"
• "Add this FAQ to the knowledge base"
• "Delete the old procedures file"

File Types¶

Knowledge files are simple text files, usually in Markdown format:

# Product Pricing

## Software Licenses
- Professional Edition: EUR 1,098
- Enterprise Edition: EUR 2,500

## Support
- Email support: Included
- Phone support: EUR 150/hour

Where Files Are Stored¶

Knowledge files are stored in the knowledge/ folder in your workspace:

workspace/
  knowledge/
    company.md
    products.md
    faq.md
    ...

What to Include¶

Tips¶

1. Keep it current: Update knowledge files when information changes.

2. Be specific: Concrete facts work better than vague descriptions.

3. Use sections: Organize content with headings for easy reference.

4. Agent focus: Different agents can use different knowledge files.

Example Knowledge File¶

# Company Information

## About Us
realvirtual GmbH is a software company based in Germany,
specializing in digital twin solutions.

## Contact
- Email: info@realvirtual.io
- Phone: +49 123 456789
- Address: Example Street 1, 12345 Berlin

## Business Hours
Monday - Friday: 9:00 - 17:00 (CET)

Security¶

Knowledge files are stored locally on your computer. They are not uploaded anywhere unless you explicitly share them.

Advanced: Agent Configuration¶

You can also manage agent configurations through the knowledge extension:

Add new agent:

Create a new agent definition that appears in DeskAgent's agent list.

Example request:

• "Add a new agent called 'email_summary' that uses Gemini"

This modifies config/agents.json to register new custom agents.

Common Issues¶