核心概念

GDK 提供的是构建智能体的组件，而不是一个带有若干配置项的固定智能体。你的应用决定允许做哪些工作、如何存储状态、使用哪些模型，以及智能体如何与外部世界交互。

执行模型是由操作组合而成的状态机。操作可以运行工具、添加上下文、强制执行限制，或暂停等待输入。推理是一种特殊的步骤，通过提供商访问模型。状态机通过你的运行时应用由此产生的效果，然后重新加载更新后的会话，再决定下一步做什么。

从这里开始

• 状态机：执行循环如何运作、让出（yield）是什么意思，以及持久化如何使恢复成为可能。
• 操作：组合进状态机的各个单元、一个完整示例、目前可用的操作，以及何时需要自己编写。
• 提供商：模型接口、内置实现与声明式实现，以及本地推理和连接本地模型服务器之间的区别。
• 身份验证：提供商如何获得凭据、GDK 自带哪些机制，以及如何提供你自己的机制。

想看这些部分如何组装在一起，请阅读 Hello World。这些页面讲解设计思路；参考文档链接到完整的 API。这里的示例遵循当前代码库中的 GDK API（0.1.0-alpha.13）；Hello World 则遵循示例所固定的 alpha.12 版本。

如果你想让现成的智能体运行在自己的界面之后，可以通过 ACP 用 goose 构建应用，无需自己组装运行时。