Kimi Hosted Agents 解析：核心能力与企业应用接入流程

本文依据 2026 年 11 月 6 日可查阅的 Kimi 官方文档整理。Hosted Agents 目前标注为 Beta，接口和产品能力可能继续调整。文中的企业资料分析助手为通用设计示例。

一、消息摘要

11 月 5 日，IT之家报道，月之暗面推出 Kimi Hosted Agents，将支撑智能体运行的 Harness 作为云端服务提供，面向企业和开发者开放。

官方文档将其定位为预构建、可配置的托管智能体服务，适用于长时间运行、异步执行以及多智能体协作任务。

Harness 可以理解为智能体运行所需的一组基础设施。模型负责理解任务和生成决策，Harness 则负责管理会话、组织工具调用、保存执行状态，以及处理权限、重试和中断恢复。

对于企业开发者，这类服务的价值在于减少运行基础设施的开发与维护工作，让团队能够集中精力建设业务能力、数据接口和产品体验。

参考来源：当日报道、官方产品概览。

二、Hosted Agents 提供哪些能力？

1. 智能体配置与版本管理

企业可以为 Agent 配置模型、系统提示词、工具、技能、插件和 MCP 服务，将任务目标、业务规则与输出要求组织为可复用的配置。

创建会话时，平台会固定该会话使用的智能体版本、执行环境版本和绑定资源。企业可以据此开展版本测试，并控制配置升级对已有任务的影响。

参考文档：快速开始、启动会话。

2. 会话持久化与执行恢复

平台以事件形式保存会话历史，应用可以查询历史事件，也可以通过 SSE 订阅实时进度和输出。

官方说明，平台承担执行层的重试、调度和故障恢复。应用继续会话时，无需重新提交完整消息列表。

接入方仍需要实现应用侧的连接恢复。后端应保存 SSE 恢复游标，在重新连接时原样传回，并按事件对象 ID 去重。历史查询的分页 token 与实时事件流的恢复游标分别使用。

参考文档：迁移指南、事件流。

3. 沙箱与工具执行

Hosted Agents 支持三种工具执行方式。

工具类型	执行位置	典型用途
内置工具	平台沙箱	读取文件、执行代码、联网搜索、生成产物
MCP 工具	接入的 MCP 服务	查询业务数据，复用已有工具服务
自定义工具	接入方的客户端程序	调用企业接口，执行受控业务操作

这里的“客户端程序”可以是企业后端服务。

模型决定调用自定义工具后，平台通过事件流发送工具名称和输入参数。企业后端完成鉴权和执行，再把结果提交给平台，智能体随后继续处理任务。

参考文档：工具。

4. 技能、插件与跨会话记忆

官方文档列出了 140 多个技能、30 多个插件，覆盖资料检索、专业数据查询、办公文档处理和内容生成，也支持自定义扩展。

跨会话信息可以通过记忆库组织。创建会话时，应用需要显式绑定记忆库，并指定只读或可读写权限。

企业可以根据业务范围划分记忆库，例如公共知识、部门资料和用户偏好，并控制不同会话的访问范围。

参考文档：产品概览、记忆库。

5. 权限控制与自托管环境

工具可以配置为自动执行，或在执行前等待客户端确认。

设置 always_ask 后，平台会暂停对应工具调用。企业应用可以向用户展示操作内容，再通过事件接口提交允许或拒绝的结果。

企业认证用户还可以使用自托管执行环境，在自有主机上执行沙箱工具。模型调用、智能体编排和会话管理仍由平台负责，接入时应明确任务输入和工具结果进入云端推理的范围。

参考文档：权限策略、企业执行环境说明。

三、企业应用如何接入？

以一个通用的“企业资料分析助手”为例。

用户提交分析需求后，智能体检索有权访问的资料、提取关键信息，并生成附有来源的报告。涉及正式发布、修改业务记录等操作时，接入企业已有的审批流程。

第一步：准备账号、项目和调用凭证

企业可以在 Kimi 开放平台注册账号，完成企业认证，并分别创建测试项目和生产项目。

随后为项目创建 API Key，设置预算、限速及服务出口 IP 白名单。API Key 保存在企业后端，前端通过业务接口提交任务。

平台支持按项目统计消费，便于分别核算测试与生产费用。

参考文档：组织与项目管理。

第二步：确定工具与数据接入方式

建议从少量职责明确的工具开始。

示例工具	作用
search_documents	检索当前用户有权访问的资料
get_document	获取指定文档的内容
save_report_draft	保存分析报告草稿
submit_review_request	将报告提交至审核流程

以下是一个自定义工具的配置示意。

{
  "type": "custom",
  "name": "search_documents",
  "description": "检索当前用户有权访问的资料，返回文档标识、标题和相关摘要。",
  "input_schema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string"
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 10
      }
    },
    "required": [
      "query"
    ]
  }
}

企业后端收到调用请求后，应根据已认证的用户身份确定可检索范围，再调用内部系统。租户身份和访问权限由后端校验。

如果仅使用自定义业务工具，可以显式关闭默认内置工具集，再按需开放能力。

{
  "type": "agent_toolset",
  "name": "default_toolset_20260901",
  "default_config": {
    "enabled": false
  }
}

以上对象按需要放入 Agent 配置的 tools 数组。官方文档说明，未显式配置内置工具集时，默认会加载相应沙箱工具。

参考文档：自定义工具与默认工具行为。

第三步：配置 Agent 和执行环境

Agent 的系统提示词可以约定以下行为。

• 优先使用工具获取资料。
• 在结论中引用文档名称或来源标识。
• 将资料中的事实、分析推断和待确认事项分别说明。
• 资料不足时，说明缺失信息及其影响。
• 正式发布和业务修改遵循审批流程。

随后创建执行环境，配置依赖和网络访问范围。完成测试后，在创建业务会话时指定 Agent 版本，便于控制升级影响。

参考文档：快速开始、会话版本配置。

第四步：接入会话和事件流

Hosted Agents 使用 HTTP 与 SSE 接口。当前官方示例的服务地址为：

https://api.moonshot.cn

请求头包含以下字段。

Authorization: Bearer <KIMI_API_KEY>
kimi-api-version: 2026-09-01-beta
Content-Type: application/json

最短业务调用链如下。

顺序	接口或事件	接入方处理
1	POST /v1/sessions	创建会话，绑定 Agent 和执行环境
2	GET /v1/sessions/{id}/events/stream	订阅执行进度和输出
3	POST /v1/sessions/{id}/events	发送 user.message，启动任务
4	接收 agent.custom_tool_use	校验权限并执行自定义工具
5	提交 user.custom_tool_result	回传工具结果
6	接收消息和状态事件	展示结果，保存业务记录

创建会话后，需要发送用户消息，任务才会开始。

企业后端可以保存以下关联信息。

租户 ID
用户 ID
业务任务 ID
Kimi session ID
Agent 版本
执行状态
事件恢复游标

每次读取或继续会话时，都应检查当前用户是否有权操作对应任务。

参考文档：启动会话、工具调用流程。

第五步：处理审批、重连和幂等

平台的执行恢复需要与企业业务接口配合。

例如，报告已经保存成功，但后端在回传工具结果前断线。连接恢复后，后端可以根据工具调用 ID 查询执行记录，复用已保存的报告结果，避免重复创建。

对于保存、修改、提交等操作，建议设计可查询的执行状态和幂等标识。

平台工具需要确认时，应用展示待执行内容，再提交 user.tool_confirmation。自定义工具涉及的权限与审批，也应由企业后端在执行前校验。

参考文档：权限确认、事件恢复。

第六步：测试与灰度上线

可以准备一批具有明确预期结果的任务，验证以下维度。

验收维度	检查内容
内容质量	结论准确性、引用完整性、缺失信息识别
工具调用	工具选择、参数和业务权限
执行恢复	断网、超时和重复事件后的处理
数据隔离	不同用户及租户的资源访问范围
产品体验	首次反馈时间、总耗时、取消与继续
使用成本	token、沙箱时长和插件调用费用

Hosted Agents 的费用由模型 token、沙箱运行时长和插件调用构成。企业可以先开放资料检索、分析和报告草稿等任务，再根据验收结果扩展业务范围。

参考文档：官方产品与计费说明。

对于已有智能体系统的团队，可以先增加一条可切换的 Hosted Agents 执行路径，用相同任务比较质量、恢复能力和成本。业务授权、关键操作审批和最终结果归档，也应一并纳入接入设计。