Skip to main content
hakimi 是使用托管智能体的第三条路径：创建资源不需要手写 API 请求，也不用在控制台里逐项配置。它由 hakimi skill（技能包）和 hakimi CLI 组成——hakimi skill 引导 agent（AI 编程助手）完成查模型、确认配置、创建资源的流程，hakimi CLI 负责调用托管智能体 API。hakimi 不绑定特定的 agent：Kimi Code、Claude Code、Codex 等支持技能包的工具都可以安装使用。 三条入门路径按需选择： 本页会演示利用 hakimi 创建一个金融投研助手。

​
开始前准备

  • 已安装一个支持技能包（skill）的 agent，例如 Kimi Code、Claude Code 或 Codex；
  • 使用 macOS 或 Linux（hakimi CLI 目前没有 Windows 版本）；
  • 已在 Kimi 开放平台 创建 API Key。

​
安装 hakimi

下载 hakimi 技能包：
把压缩包解压到 agent 的用户级技能目录下的 hakimi 文件夹中。压缩包内没有顶层目录，需要先创建这个文件夹。以 Kimi Code 为例：
使用其他 agent 时，把 ~/.kimi-code/skills 替换为对应的技能目录： 更简单的方式是让 agent 自己装，直接发消息：
安装完成后新开一个会话，agent 就能识别 hakimi skill。首次使用时，hakimi skill 会引导你安装 hakimi CLI：安装脚本从发布地址下载对应平台的二进制文件、校验 SHA256 后安装到 ~/.local/bin。装好后可以验证：

​
配置 API Key

hakimi CLI 的每次调用都需要显式传入 API Key。在终端中设置环境变量：

​
创建金融投研助手

在 agent 中直接描述你要的智能体：
hakimi skill 接到请求后会按固定流程执行：
  1. 根据你的描述生成智能体配置——名称、描述、模型和系统提示词，并在创建前完整展示；
  2. 等你明确确认后才创建，创建成功后返回智能体 ID 和版本。
展示配置时重点检查系统提示词。hakimi skill 生成的提示词通常类似这样：
如果不满意，直接说明要改的地方（比如「再加一条：引用数据时标明来源」），确认无误后再让它创建。创建成功后，保存返回的智能体 ID 和版本。

​
选择或创建执行环境

智能体配置完成后，hakimi skill 会先列出你现有的执行环境，只推荐状态为 ready 的候选环境。你可以选择一个复用；如果没有合适的，它会替你新建一个云沙箱环境，配置项全部使用默认值，无需手动干预。 执行环境的镜像是异步构建的，状态从 building 变为 ready 后才能创建会话；如果创建会话时收到环境未就绪的错误，稍等片刻用原请求重试即可，不要重复创建环境。环境的网络、依赖等更多配置见 执行环境。

​
创建会话

环境就绪后，hakimi skill 会展示本次会话的完整配置——智能体、版本、执行环境——确认后创建会话并返回会话 ID。 hakimi 只负责创建资源，不会替你发送消息。会话创建成功后，打开 控制台 找到这个会话，就可以开始对话了。

​
故障排查

agent 没有使用 hakimi skill：确认解压后的 SKILL.md 在技能目录的 hakimi 文件夹里，而不是直接放在技能目录下，然后新开一个会话再试。 找不到 hakimi 命令：hakimi CLI 还没安装，或 ~/.local/bin 不在 PATH 中。让 hakimi skill 引导你安装，或手动执行 export PATH="$HOME/.local/bin:$PATH" 后用 hakimi version 验证。 401 / 403：API Key 无效或没有托管智能体访问权限。检查环境变量是否设置正确、API Key 是否过期，不要把 API Key 粘贴到对话里排查。 创建会话时报环境未就绪：环境镜像还在构建。等状态变为 ready 后用原配置重试，不要新建另一个环境。

​
下一步

快速开始

改用 API 跑通同一条入门链路。

智能体

智能体字段、不可变版本与更新规则。

控制台

在网页上管理资源和继续会话。