示例

Koog 框架提供了示例，帮助您理解如何为不同的用例实现 AI 代理。这些示例展示了关键特性和模式，您可以将其适配到自己的应用程序。

浏览以下示例，点击链接可在 GitHub 上查看源代码。

Example	Description
Attachments	了解如何在提示中使用结构化 Markdown 和附件。构建包含图片并使用 OpenAI 模型为 Instagram 帖子生成创意内容的提示。
Banking	构建一个全面的 AI 银行助手，它具有路由能力，可以通过复杂的图策略处理资金转账和交易分析。包括领域建模、工具创建和代理组合模式。
BedrockAgent	使用 Koog 框架与 AWS Bedrock 集成来创建智能 AI 代理。了解如何定义自定义工具、设置 AWS Bedrock，并构建能够理解自然语言命令以控制设备的交互式代理。
Calculator	构建一个计算器代理，使用加法、减法、乘法和除法的工具执行算术操作。展示了并行工具调用、事件日志记录以及多执行器支持 (OpenAI 和 Ollama)。
Chess	构建一个智能国际象棋对弈代理，它具有复杂的领域建模、自定义工具、内存优化技术和交互式选择。展示了高级代理策略、游戏状态管理和人机协作模式。
GoogleMapsMcp	通过 Docker 将 Koog 连接到 Google Maps MCP 服务器。在 Kotlin Notebook 环境中，使用 AI 代理通过真实世界的地理 API 发现工具、对地址进行地理编码以及获取海拔数据。
Guesser	构建一个数字猜谜代理，它使用工具实现二分搜索策略来提出有针对性的问题。该代理通过策略性提问有效地缩小用户的数字范围，并展示了基于工具的交互模式。
Langfuse	了解如何使用 OpenTelemetry 将 Koog 代理追踪导出到 Langfuse。设置环境变量、运行代理，并在您的 Langfuse 实例中探查 span 和 trace 以实现全面的可观测性。
MCP	模型上下文协议 (Model Context Protocol) 的集成示例，其中 GoogleMapsMcpClient 用于地理数据，PlaywrightMcpClient 用于浏览器自动化。
Memory	一个客户支持代理，展示了内存系统的使用情况。该代理使用加密本地存储以及通过主题和作用域进行的适当内存组织，追踪用户对话偏好、设备诊断和组织特有信息。
OpenTelemetry	将基于 OpenTelemetry 的追踪添加到 Koog AI 代理。学习如何将 span 发送到控制台进行调试，并将 trace 导出到 OpenTelemetry Collector 以在 Jaeger 中查看。包括 Docker 设置和故障排除指南。
Planner	一个任务规划系统，它构建具有并行和顺序执行节点的执行树，动态构建复杂工作流的执行计划。
PlaywrightMcp	使用 Playwright MCP 和 Koog 驱动浏览器。启动 Playwright MCP 服务器，通过 SSE 连接，并让 AI 代理通过自然语言命令自动化 Web 任务，例如导航、Cookie 接受和 UI 交互。
SimpleAPI	演示聊天代理和单次运行代理的基本示例，采用简单的 API 模式，帮助您开始使用 Koog。
StructuredData	演示基于 JSON 的结构化数据输出，包含复杂的嵌套类、多态性以及天气预报示例，展示了如何在代理响应中使用类型化数据。
SubgraphWithTask	项目生成工具，展示了文件和目录操作，包括使用子图策略进行创建、删除和命令执行。
Tone	一个文本语气分析代理，它使用专用工具识别输入文本中的积极、消极或中性语气，展示了情感分析能力。
UnityMcp	使用 Unity MCP 服务器集成，通过 AI 代理驱动 Unity 游戏开发。通过 stdio 连接到 Unity，发现可用工具，并让代理通过自然语言命令修改场景、放置对象和执行游戏开发任务。
VaccumAgent	使用 Koog 框架实现一个基本的反射代理。涵盖了在一个简单的双格世界中，用于自动化清洁任务的环境建模、工具创建和代理行为。
Weave	了解如何使用 OpenTelemetry (OTLP) 将 Koog 代理追踪到 W&B Weave。设置环境变量、运行代理，并在 Weave UI 中查看丰富的 trace，以实现全面的监控和调试。