範例

Koog 框架提供了範例，以幫助您理解如何在不同的使用情境中實作 AI 代理。 這些範例展示了您可以應用於自己應用程式的關鍵功能和模式。

瀏覽以下範例，並點擊連結以在 GitHub 上查看原始碼。

範例	描述
Attachments	了解如何在提示詞中使用結構化 Markdown 和附件。建構包含圖片的提示詞，並使用 OpenAI 模型為 Instagram 貼文生成創意內容。
Banking	建構一個全方位的 AI 銀行助理，具備路由功能，能夠透過精密的基於圖形的策略處理資金轉帳和交易分析。包含領域建模、工具建立和代理組合模式。
BedrockAgent	使用 Koog 框架結合 AWS Bedrock 整合來建立智慧型 AI 代理。了解如何定義自訂工具、設定 AWS Bedrock，並建構能理解自然語言指令以控制裝置的互動式代理。
Calculator	建構一個計算器代理，使用用於加法、減法、乘法和除法的工具執行算術運算。展示了並行工具呼叫、事件日誌記錄和多執行器支援（OpenAI 和 Ollama）。
Chess	建構一個智慧型西洋棋代理，具備複雜的領域建模、自訂工具、記憶體優化技術和互動式選擇。展示了進階代理策略、遊戲狀態管理和人機 AI 協作模式。
GoogleMapsMcp	透過 Docker 將 Koog 連接到 Google Maps MCP 伺服器。在 Kotlin Notebook 環境中，使用 AI 代理探索工具、地理編碼地址並透過真實世界的地理 API 獲取海拔數據。
Guesser	建構一個數字猜測代理，實作二元搜尋策略，使用工具來詢問目標問題。該代理透過策略性提問有效地縮小使用者數字的範圍，並展示基於工具的互動模式。
Langfuse	了解如何使用 OpenTelemetry 將 Koog 代理的 traces 匯出到 Langfuse。設定環境變數、執行代理，並在您的 Langfuse 實例中檢查 spans 和 traces，以實現全面的可觀察性。
MCP	模型上下文協定 (Model Context Protocol) 的整合範例，包含用於地理資料的 GoogleMapsMcpClient 和用於瀏覽器自動化的 PlaywrightMcpClient。
Memory	一個客戶支援代理，展示記憶系統的使用。該代理追蹤使用者對話偏好、裝置診斷和組織特定資訊，並使用加密的本機儲存，透過主體 (subjects) 和範圍 (scopes) 進行適當的記憶體組織。
OpenTelemetry	為 Koog AI 代理新增基於 OpenTelemetry 的追蹤。了解如何將 spans 輸出到控制台進行除錯，以及如何將 traces 匯出到 OpenTelemetry Collector 以便在 Jaeger 中查看。包含 Docker 設定和疑難排解指南。
Planner	一個任務規劃系統，建立了包含並行和序列執行節點的執行樹，動態建構複雜工作流程的執行計畫。
PlaywrightMcp	使用 Playwright MCP 和 Koog 驅動瀏覽器。啟動 Playwright MCP 伺服器，透過 SSE 連接，並讓 AI 代理透過自然語言指令自動執行網路任務，例如導航、Cookie 接受和 UI 互動。
SimpleAPI	展示聊天代理和單次執行代理的基本範例，具有簡單的 API 模式，以便開始使用 Koog。
StructuredData	展示了基於 JSON 的結構化資料輸出，包含複雜的巢狀類別、多型性以及天氣預報範例，說明如何在代理回應中處理型別化資料。
SubgraphWithTask	專案生成工具，展示檔案和目錄操作，包括建立、刪除和命令執行，使用子圖策略。
Tone	一個文本語氣分析代理，使用專用工具來識別輸入文本中的正面、負面或中性語氣，展示情感分析能力。
UnityMcp	透過 Unity MCP 伺服器整合，使用 AI 代理驅動 Unity 遊戲開發。透過 stdio 連接到 Unity，探索可用工具，並讓代理透過自然語言指令修改場景、放置物件和執行遊戲開發任務。
VaccumAgent	使用 Koog 框架實作一個基本的反射代理。涵蓋環境建模、工具建立和代理行為，用於簡單的兩單元世界中的自動清潔任務。
Weave	了解如何使用 OpenTelemetry (OTLP) 將 Koog 代理的 traces 匯出到 W&B Weave。設定環境變數、執行代理，並在 Weave UI 中查看豐富的 traces，以實現全面的監控和除錯。