组织知识 API
组织知识是单个组织下的共享记忆读模型。
这些路由用来做什么
当记忆需要在同一个 org_id 下被多个用户或 agent 复用时，就应该使用这组接口。
这一层适合承载：
- 共享政策
- 术语体系
- 可复用工作流
- 通用最佳实践
- 组织级洞察汇总
接口
| 方法 | 路径 | 作用 |
|---|---|---|
GET | /v1/organizations/:org_id/knowledge | 返回组织知识列表 |
GET | /v1/organizations/:org_id/knowledge/:id | 按 UUID 返回单条组织知识 |
GET | /v1/organizations/:org_id/knowledge/metrics | 返回组织知识指标和汇总 |
列表查询参数
| 参数 | 含义 |
|---|---|
q | 按内容或关键词做自由文本匹配 |
contributor | 按贡献用户过滤 |
source_type | 按源记忆类型过滤 |
sort | 排序方式，例如 published_desc、contributions_desc、active_desc、topic_asc |
示例
GET /v1/organizations/default/knowledge?q=rust&sort=published_desc
Authorization: Bearer <token>
实践说明
- 这组 API 同时也被 dashboard 使用。
- 应把组织知识理解为“策展后的共享记忆”，而不是原始用户事件存储。
- 当个人记忆或 agent 记忆需要演化成组织级可复用知识时，就该进入这一层。