GDK

构建可以运行在原生应用、服务器和浏览器中的智能体，从持久化状态恢复，并掌控它们的工作方式。

GDK 是构建 goose 所用的一组可复用智能体运行时组件。它提供模型集成、可组合的状态机、工具、上下文管理，以及在你的应用内运行智能体所需的接口。

了解 GDK

入门

构建一个小型 Rust 智能体，它能运行 shell 命令、流式输出响应，并在多次运行之间保存对话。这篇讲解说明如何连接提供商、工具和状态机，以及哪些部分归你的应用所有。在决定如何改造之前，先从这里看看各部分如何协同工作。

演示

了解使用 GDK 的可运行项目，涵盖个人 wiki、电话通话、屏幕理解、语音对话和 goose 的自定义界面。每个演示都链接到源码，并说明背后的架构思路和运行所需的条件。通过它们可以看到同一套组件如何适配截然不同的应用。

概念

理解状态机、操作、提供商和认证，以及它们如何配合。这些指南解释每个组件要解决的问题、设计背后的取舍，以及目前可用的实现。实例展示如何组合智能体行为，以及何时编写自己的操作或提供商。

参考

查阅智能体运行时、提供商和上下文管理的生成 Rust API。通过 Python API 和 Kotlin API 了解共享的提供商绑定，可运行示例见 Python 和 Kotlin。把 goose 用作后端的应用请查阅 ACP 参考。在开发中需要确切的类型、方法和配置细节时，就查参考。

GDK 与 goose

goose 是一个完整的智能体应用，也是 GDK 的主要参考实现。想要开箱即用的智能体，就用 goose。想把智能体行为构建进自己的产品，就用 GDK。

预构建的 goose 二进制文件还可以作为你构建的任何 ACP 应用背后的智能体。goose 桌面版就是这样工作的，它通过 ACP 连接到本地 goose 服务器。