Skip to content
AstrBot
Main Navigation HomeBlogRoadmapHTTP API

English

简体中文

English

简体中文

Toggle dark mode

Intro & DeployMessaging PlatformsAI IntegrationUsageDevelopment
Sidebar Navigation

Introduction

What is AstrBot

Community

FAQ

Deployment

Package Manager

Desktop Client

One-click Launcher

Docker

Kubernetes

BT Panel

1Panel

Manual

Other Deployments

CasaOS

Compshare GPU

Community-provided Deployment

Support Us

Messaging Platforms

Quick Start

QQ Official Bot

Websockets

Webhook

OneBot v11

WeCom Application

WeCom AI Bot

WeChat Official Account

Personal WeChat

Lark

DingTalk

Telegram

LINE

Slack

Mattermost

Misskey

Discord

KOOK

Satori

Connect Satori

Using server-satori

Community-provided

Matrix

VoceChat

AI Integration

✨ Model Providers

MiraRouter

NewAPI

ShengSuanYun

AIHubMix

PPIO Cloud

SiliconFlow

TokenPony

302.AI

Ollama

LMStudio

⚙️ Agent Runners

Built-in Agent Runner

Dify

Coze

Alibaba Bailian

DeerFlow

Usage

WebUI

CLI Commands

Plugins

Built-in Commands

Tool Use

Anthropic Skills

Computer Use

SubAgent Orchestration

Proactive Tasks

MCP

Web Search

Knowledge Base

Custom Rules

Agent Runner

Unified Webhook Mode

Auto Context Compression

Agent Sandbox

Development

Plugin Development

🌠 Getting Started

Minimal Example

Listen to Message Events

Send Messages

Plugin Configuration

Plugin Pages

Plugin Internationalization

AI

Storage

HTML to Image

Session Control

Publish Plugin

Plugin Market Specification

Versions

2026-06-27

Platform Adapter Integration

AstrBot HTTP API

API Scope–Endpoint Reference

AstrBot Configuration File

Others

Diagnostics

Self-hosted HTML to Image

Open Source Summer

OSPP 2025

On this page

AstrBot Knowledge Base ​

TIP

Requires AstrBot version >= 4.5.0.

Knowledge Base Preview

Configuring Embedding Model ​

Open Providers (/providers), switch to the Embedding tab, click Add, and select a provider type.

Currently, AstrBot supports embedding vector services compatible with OpenAI API and Gemini API.

Select the provider in the left panel and fill in its API endpoint, API key, model name, and other settings in the right panel.

After completing the configuration, click Save.

Configuring Reranker Model (Optional) ​

A reranker model can improve the precision of final retrieval results to some extent.

Similar to configuring the embedding model, open Providers, switch to the Rerank tab, click Add, select a provider type, and save its configuration.

Creating a Knowledge Base ​

AstrBot supports multiple knowledge base management. During chat, you can freely specify which knowledge base to use.

Open Knowledge Base (/knowledge-base) from the sidebar and click Create Knowledge Base.

Fill in the name and other details. Select the embedding model under Embedding Model and, optionally, select a reranker in the separate Rerank Model (Optional) field. Then click Create.

TIP

Once you've selected an embedding model for a knowledge base, do not modify the model or vector dimension information of that provider, as this will seriously affect the retrieval accuracy of the knowledge base or even cause errors.

Uploading Files ​

After creating a knowledge base, you can upload documents to it. Up to 10 files can be uploaded simultaneously, with a maximum size of 128 MB per file.

Upload Files

Using the Knowledge Base ​

Open Config, select the profile to edit, choose the knowledge bases under AI → Capabilities → Knowledge Base, and click Save Configuration at the bottom right. Each profile can use different knowledge bases.

Edit this page on GitHub

Last updated:

Pager
PreviousWeb Search
NextCustom Rules

Deployed on Rainyun Logo