# 知识模型与企业资产

## 定位

知识、模型、业务索引、领域和市场资产是 Agent 的企业上下文层。它们不是 Agent Studio 的附属页面，而是让 Agent 能选模型、查知识、引用业务索引、理解领域归属、复用已发布资产的底座。

## 当前已落地

### 模型实例

`ai-model-service` 提供模型调用和实例管理：

- `ModelController`：`/model/chat`、`/model/chat/stream`、`/model/embedding`、`/model/rerank`。
- `OpenAIProxyController`：`/model/openai-proxy/v1/chat/completions`。
- `ModelInstanceController`：`/model/instances`，支持列表、详情、新建、更新、删除、测试。

`ai_model_instance` 是数据库中的模型实例表。管理端入口是 `ModelInstances.vue` 和 `ModelPlayground.vue`。Agent、知识库、业务索引和 Tool Retrieval 都应引用模型实例 ID，而不是在配置里硬编码 provider 模型名。

### 知识库

`ai-skills-service` 的 `KnowledgeController` 提供知识库管理：

- `/knowledge/base/list`、`/knowledge/base`、`/knowledge/base/{code}`：知识库 CRUD。
- `/knowledge/import/file`、`/knowledge/import`：文件导入。
- `/knowledge/kb/{kbCode}/files`、`/chunks`、`/hit-logs`、`/tags`、`/questions`、`/ops-dashboard`：文件、段落、命中、标签、问题和运营面板。
- `/knowledge/preview`：入库预览。
- `/knowledge/chunks/{chunkId}/toggle`、`/reembed`：段落启停和重向量化。

数据表包括 `knowledge_base`、`file_info`、`chunk`、`user_file_permission`、`knowledge_tag`、`knowledge_question`、`knowledge_hit_log`。`knowledge_base` 已具备 `workspace_id`、`project_id`、`project_code`、`environment`、`tenant_id`、`scope`、`search_mode`、`top_k`、`similarity_threshold`、`direct_return_enabled`、`rerank_enabled`、模型实例字段等企业级配置。

管理端入口是 `KnowledgeList.vue`、`KnowledgeDetail.vue`、`KnowledgeImport.vue`、`FileDetail.vue`、`RetrievalTest.vue`。

### RAG 和业务索引

`RagController` 提供 `/rag/query`，`RetrievalController` 提供 `/retrieval/test`，`EmbeddingController` 提供 `/embedding/vectorize`。

业务索引由 `BizIndexController`、`BizIndexDataController`、`BizIndexSearchController` 承载：

- `/biz-index`：索引定义 CRUD。
- `/biz-index/{indexCode}/upsert`、`/batch`、`/record/{bizId}`、`/rebuild`：数据维护。
- `/biz-index/{indexCode}/search`：业务索引检索。

数据表包括 `business_index`、`business_index_record`、`business_index_attachment`。管理端入口是 `BizIndexList.vue`、`BizIndexDetail.vue`。

### Agent 中的使用方式

Agent Studio 中已有知识检索和知识写入节点，对应 `KnowledgeConfigPanel.vue`、`KnowledgeWriteConfigPanel.vue`。GraphSpec 执行时，Runtime 通过节点配置调用 RAG、Tool、HTTP、MCP 或业务索引能力，并把输出写入状态，供后续节点通过变量映射读取。

`tool_retrieval_setting` 保存 Tool 语义检索使用的 Embedding 模型实例。`ToolRetrievalController` 提供 `/api/tool-retrieval/search`、`/rebuild`、`/rebuild/status`、`/health`，前端入口是 `ToolRetrievalTest.vue`。

### 领域和市场

领域治理由 `domain_def`、`domain_assignment` 支撑，可把 Tool、Capability、Agent 挂到业务领域上，并通过分类器辅助归属。市场资产由 `market_item` 支撑，用于 Agent/Capability 的提交、审批、依赖检查和导出。

## 仍待补齐

- 模型实例已经数据库化，但不同资产对 Chat、Embedding、Rerank 模型的引用仍需继续统一到实例 ID。
- 知识库已具备企业级配置和标签运营，但与项目、租户、领域的默认策略仍需要进一步产品化。
- 业务索引已能独立维护和检索，后续需要更清晰地接入 Agent Studio 节点和 Capability 声明。
- 领域和市场已有基础表与页面，但资产生命周期、版本、依赖影响分析和跨项目复用策略还需要继续加强。