> For the complete documentation index, see [llms.txt](https://tinyhumans.gitbook.io/openhuman/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tinyhumans.gitbook.io/openhuman/zh/kai-fa/embed.md).

# 嵌入

在 Rust 应用中运行 OpenHuman 核心，使用一个 Runtime 和独立配置的 Agents。

`openhuman-embed` 在你的 Rust 程序中运行 OpenHuman 核心。你的宿主负责用户界面、服务器传输和认证流程；核心负责代理轮次、记忆、工具、审批和执行策略。调用其类型化外观无需 JSON-RPC 服务器或桌面外壳。

构建一个 `运行时` 每个进程一个，并注册你的产品所需的代理。每个代理都可以选择自己的提供方、提示词、工作文件夹、工具范围、技能和 MCP 服务器。代理共享运行时凭据；如需使用 `ProfileRuntime` 当不同客户需要不同的凭据和工作区时。

## 从这里开始

* [安装](/openhuman/zh/kai-fa/embed/installation.md)：依赖项、Cargo gates、运行时设置和配置。
* [快速入门](/openhuman/zh/kai-fa/embed/quickstart.md)：先运行一次经过验证的离线轮次，然后显式选择一个在线提供方。
* [架构](/openhuman/zh/kai-fa/embed/architecture.md)：所有权、生命周期和库链。
* [概念](/openhuman/zh/kai-fa/embed/concepts.md)：18 个公共 API 概念及其运行时/代理作用域。
* [指南](/openhuman/zh/kai-fa/embed/guides.md)：聊天机器人、多代理、SaaS、服务器部署和测试。
* [集成](/openhuman/zh/kai-fa/embed/integrations.md)：推理、MCP、连接器、存储和通道。
* [食谱](/openhuman/zh/kai-fa/embed/cookbook.md)：可执行示例的生成目录。
* [API 参考](/openhuman/zh/kai-fa/embed/api-reference.md)：本地 rustdoc、源代码链接和生成的构建器选项。

## 选择合适的入口

| 需求                          | 从以下开始                  |
| --------------------------- | ---------------------- |
| 一个代理加一个轻量宿主                 | `测试框架`                 |
| 多个独立配置的代理                   | `运行时` 和 `AgentSpec`    |
| 无状态模型生成                     | `补全器`                  |
| 具有隔离凭据和状态的已认证用户             | `ProfileRuntime`       |
| 公开的 JSON-RPC 服务器或随产品提供的桌面宿主 | 这个 `openhuman-rpc` 宿主层 |

本节中的代码片段来自已编译、经离线测试的 Rust 示例的注入内容。其完整源文件包含周边设置。 `pnpm docs:check` 检查源代码漂移、本地链接、生成的 API 清单以及已发布的英文镜像。

参见 [FAQ](/openhuman/zh/kai-fa/embed/faq.md) 了解设计取舍，以及 [故障排除](/openhuman/zh/kai-fa/embed/troubleshooting.md) 中的设置失败。