AI 助理
文档备案控制台
官方文档
首页 检索分析服务 Elasticsearch版 操作指南 AI 服务中心 企业上下文引擎 使用企业上下文引擎

使用企业上下文引擎

更新时间：
复制 MD 格式
产品详情
我的收藏

本文介绍如何初始化企业上下文引擎。

初始化企业上下文引擎

在使用企业上下文引擎前，需要先在目标实例上完成初始化。

前提条件

  • 已创建一个引擎增强版实例，实例版本为 8.17 或 9.4，且实例状态为正常。

    • 说明：其他版本（如 9.99）暂不支持企业上下文引擎，进入功能页会提示“当前实例版本暂不支持企业上下文引擎场景”。

  • 已获取该实例的 elastic 管理员账号及密码。初始化时需要填写该凭证，用于企业上下文引擎访问集群。

    如果忘记密码，可在实例的安全配置页重置 elastic 访问密码。

操作步骤

  1. 登录阿里云 Elasticsearch 控制台，在左侧导航栏单击 Elasticsearch实例，单击目标实例进入实例详情页。

  2. 在左侧导航栏选择 AI服务中心 > 企业上下文引擎。

  3. 在初始化引导页，阅读并勾选《Agentic Search 服务初始化协议》。

  4. 单击立即初始化。

  5. 在弹出的配置 Elasticsearch 集群访问凭证对话框中，填写以下信息，然后单击确认并初始化。

    参数

    说明

    账号

    ES 集群管理员账号，默认填入 elastic。

    密码

    该管理员账号的密码。密码将通过阿里云密钥管理服务（KMS）加密存储，不会传递给 Agent，后续可在企业上下文引擎的设置中修改。
    企业上下文引擎需要以管理员账号访问当前 ES 实例，用于创建索引与向量字段以存储知识库切片、写入记忆与技能的元数据，以及执行知识库检索与精排等运行时操作。

  6. 初始化完成后，页面进入企业上下文引擎功能页，顶部状态显示为已初始化，并展示工作空间列表。

创建工作空间与成员

工作空间（Workspace）是按业务隔离知识库、成员与调用凭证的基本单元。每个成员在工作空间内拥有独立的 API Key，用于该工作空间的全部 API 调用。

创建工作空间

  1. 在企业上下文引擎功能页，单击新建工作空间。

  2. 在对话框中填写以下信息，然后单击确定。

    参数

    说明

    名称

    必填。字母开头，可包含字母、数字、下划线，最长 30 个字符。例如 sales_prod。

    描述

    选填。最长 128 个字符。

  3. 创建完成后，工作空间显示在列表中，状态为运行中，并展示知识库、技能、记忆、成员四项数量指标。

单击工作空间名称进入其详情页。工作空间详情包含以下页签：

  • 概览：展示工作空间详情、四项数量指标、知识库概览与接入 Agent 入口。

  • 知识库：管理该工作空间下的知识库。

  • 智能记忆：管理 Agent 的长期记忆。

  • 技能：管理可复用的提示词与工具规范。

  • 成员与 API Key：管理成员及其 API Key。

新建成员并获取 API Key

每位成员拥有独立的 API Key，用于本工作空间的全部 API 调用。

  1. 进入工作空间详情页，单击成员与 API Key 页签。

  2. 单击新建成员。

  3. 在对话框中填写以下信息，然后单击确定。

    参数

    说明

    成员名称

    必填。字母或数字开头，可包含字母、数字、下划线、短横线，最长 64 个字符。例如 lisi。

    状态

    默认为启用中。

  4. 创建成功后，系统为该成员生成一个 API Key 并弹框展示。请及时复制并妥善保管。

    • API Key 是成员访问工作空间资源的唯一凭证，请勿转发给他人。

    • 若未在弹框中复制，后续可在成员列表的 API Key 列通过复制图标获取完整值。

成员列表展示成员名称、成员 ID、状态、API Key、创建时间等信息。您可以对成员执行以下操作：

  • 停用：停用后该成员的 API Key 立即失效。

  • 删除：删除成员将同时删除其全部记忆数据，不可恢复。

创建知识库并导入文档

知识库（Knowledge Base）用于收录文档与多模态内容，经解析、切片、向量化后构建可检索的知识底座。

创建知识库

  1. 进入工作空间详情页，单击知识库页签，单击新建知识库。

  2. 基础信息（步骤 1）：填写以下信息，然后单击下一步。

    参数

    说明

    知识库名称

    必填。小写字母开头，可包含小写字母、数字、下划线，最长 30 个字符；创建后不可修改。例如 product_manual。

    描述

    选填。最长 1024 个字符。

  3. 文档处理配置（步骤 2）：按需配置以下项，然后单击下一步。以下开关默认均为开启。

    配置项

    说明

    文件解析模型

    用于解析文档内容的服务，默认 ops-document-analyze-002。不同服务对表格、图片等内容的识别能力有所差异。

    文档切片

    默认开启。开启后将文档按单句进行切片，适合需要精细粒度检索的场景。可通过自定义切片配置分隔符。

    图片内容解析

    默认开启。开启后对文档中的图片进行识别与理解，提升含图文档的检索质量。

    理解增强

    默认开启。启用文本增强、文档摘要与章节摘要，提升检索相关性与全局理解能力。

    Agentic Wiki

    默认开启（推荐）。开启后 Agent 会根据知识库内容自动生成并持续维护 Wiki 页面；关闭后停止更新，已有页面不受影响。

    向量化模型

    默认 text-embedding-v4。

    多模态向量化模型

    默认 qwen3-vl-embedding。

  4. 模型服务配置（步骤 3）：确认 API Key 与连接域名等信息后，单击确认创建。

    • 此处默认使用工作空间成员的 API Key 与 AI 搜索开放平台的连接域名，提供百炼 MaaS 全栈模型服务与自研 AI 搜索模型服务。

    • 页面提示该配置将产生 AI 搜索开放平台相关费用，请确认已了解计费方式与计费项。

创建完成后，知识库显示在列表中，状态为正常。

导入文档

  1. 在知识库列表中，单击目标知识库的上传文档。

  2. 在本地文件上传页签，单击或拖入文件（支持同时上传多个文件）。

    • 支持的文档格式：pdf、doc、docx、html、htm、txt、md、jsonl、csv、ppt、pptx、xls、xlsx。

    • 支持的图片格式：png、jpg、jpeg、jp2、gif、webp、bmp、tiff。

    • 支持的音视频格式：mp3、mp4、avi、mkv、mov。

    • 大小限制：文档与图片单文件不超过 200 MB（其中 PDF 不超过 300 页）；音视频单文件不超过 1 GB。

      以上格式与大小限制请以控制台为准。

    • 您也可以切换到从数据源上传页签，从数据源批量导入。

  3. 确认文件列表后，单击开始上传。

    • 关闭窗口不会中断上传，可在页面右下角的任务托盘查看进度。

上传后文档进入处理流程（解析、切片、向量化、建立索引）。当文档状态显示为成功时，该文档已进入知识库并可被检索；根据知识库内容自动生成的 Wiki 页面会稍有延迟。

此外，知识库内容支持新增、删除、重建索引等操作。

查看知识库

知识库详情页包含以下页签：

  • 概览：展示知识库基本信息与文档数量。

  • 文档处理：展示文档列表，包含文档名称、状态、入库时间等信息，并支持上传文档与查看文档详情。

  • Wiki：查看根据知识库内容自动生成的 Wiki 页面。

  • 知识图谱：查看知识库内容的图谱。

通过 Agent 接入并检索

企业上下文引擎以 MCP 优先的方式将工作空间接入 Agent。接入后，Agent 可通过 MCP 检索工作空间下的知识库、智能记忆与技能，并获得带引用（citation）的上下文。

接入 Agent

  1. 在工作空间概览页，单击接入 Agent。

  2. 选择成员：在下拉列表中选择用于接入的成员。复制接入指令时会自动填充所选成员的完整 API Key，请勿转发给他人。

  3. 选择接入方式：选择目标 Agent（支持 Codex、Claude Code、Hermes、OpenClaw），并选择以下任一方式接入：

    • 自然语言接入（推荐）：向 Agent 发送一句话，由 Agent 读取接入说明自动完成 MCP 配置。

    • 命令行接入：复制命令到终端执行，适合服务器与 CI 场景。命令格式如下：

      npx --yes @aliyun-es/eke@latest install <codex|claude-code|hermes|openclaw> \
  --endpoint <服务地址> \
  --workspace <工作空间名称> \
  --user_id <成员 ID> \
  --api_key <成员 API Key> \
  --json

      命令执行完成后，凭证会写入 Agent 的 MCP 配置，重启 Agent 后生效。

      完整的接入参数说明、分步操作与常见问题，请参见通过插件接入 Agent。

检索企业知识

接入完成后，Agent 即可通过插件能力调用企业上下文引擎的检索能力。检索时，企业上下文引擎按“身份认证 → 意图理解 → 权限过滤 → 多路召回（BM25、向量、稀疏）→ 融合排序 → 精排”的链路处理请求，并返回带引用的上下文，引用包含来源文档、版本、位置等信息，便于溯源。

您可以在 Agent 中用自然语言发起检索，例如提问某个企业知识库中的问题，Agent 会调用企业上下文引擎检索相关内容并结合引用作答。

检索时，企业上下文引擎会结合发起调用的成员身份进行处理。工作空间下的每个成员拥有独立的智能记忆与自定义技能，成员之间天然隔离——每个成员只能访问自己的记忆与自定义技能。该机制既适用于企业部门间的资源共享，也适用于个人记忆与技能的单独隔离。

技能分为系统内置技能与自定义技能：系统内置技能不支持删除，您可以自行启用或停用，其生效范围为工作空间下的全部成员；自定义技能由各成员独立创建与管理，仅对所属成员生效。

上一篇：功能概述下一篇：通过插件接入 Agent