帮助
概览
Hive是什么,以及最关键的架构决策。
Aiqbee Hive是一款自托管的知识图谱,专为AI智能体读写而设计。它以单个容器运行,后端使用PostgreSQL,并通过以下两种方式对外提供服务:
- MCP(Model Context Protocol):提供34个可供LLM直接调用的工具。这是主要接口,构建智能体或助手时应首选此方式。
- REST(
/api/v1):一个精简的管理API,用于资源配置和自动化,可创建Brain、列出Brain、修改设置。不适合用于智能体流量。
术语
| 术语 | 是什么 |
|---|---|
| Brain | 一个知识图谱。访问权限按Brain授予,每个MCP连接只对应一个Brain。 |
| 神经元 | 一个知识单元:标题加内容,可附带日期。写入时生成向量嵌入,以支持语义搜索。 |
| 神经元类型 | 一种分类(Decision、Meeting Note、Standard)。可在“高级安全”中为类型设置独立的访问规则。 |
| 突触 | 两个神经元之间带描述的连接。描述很重要,智能体正是靠它来解释两者为何相关。 |
| 服务账号 | 拥有独立客户端凭据的非人类身份。您的集成应以该身份进行身份验证。 |
Brain的结构如何形成
神经元类型就是Brain的结构定义,且每个Brain各自独立。写入前,智能体应先调用aiqbee_get_neuron_types并使用真实的类型ID:类型ID无法猜测,错误的ID会被拒绝。可以使用aiqbee_add_neuron_type即时创建类型,但一个Brain有四十个近乎重复的类型,远不如只有八个精心设计的类型,因此请优先复用已有类型。