工程開發
Add V4 Tool avatar

Add V4 Tool

指導如何透過 ToolRegistry 註冊自定義工具,以擴充 Agent V4 系統的自動化執行能力。

簡介

此技能為開發人員提供了一套完整的開發流程,用於擴展 Agent V4 系統的功能。它概述了在現有的多代理(Multi-agent)架構中定義、註冊和整合新工具函數的技術需求。主要目標受眾包含正在開發 Pi Crypto Insight 平台的後端工程師與 AI 開發者,這些開發者需要為市場數據處理、社群互動或系統管理引入新的功能模組。

  • 將工具定義為 core/agents/tools.py 中的標準 Python 函數,並使用正確的類型提示(Type Hints)與描述性 docstrings,以便 LLM 準確識別功能。

  • 透過 core/agents/bootstrap.py 中的 ToolRegistry 註冊函數,並配置包含 schema 定義與針對特定 Agent 的訪問權限控制的元數據。

  • 更新 AgentMetadata 以確保 Manager Agent 能將任務有效地路由至新功能,維持工具可用性與 Agent 配置的一致性。

  • 利用內部 self._use_tool 介面進行 Agent 間的溝通與任務執行,確保在 LangGraph 架構中維持流暢的邏輯流。

  • 確保所有工具參數包含明確的類型提示,以便系統進行正確的輸入 Schema 驗證。

  • 務必撰寫詳盡的 docstrings,因為這是 LLM 判斷工具是否適用於特定用戶查詢的主要依據。

  • 使用提供的 bootstrap 診斷指令來驗證新工具的實作狀況,並檢查其在註冊表中的狀態。

  • 在整合進正式環境前,請確保自定義工具符合平台既有的安全與性能標準。

  • 系統嚴格區分工具定義與 Agent 邏輯,開發者必須同步更新 ToolMetadata 與 AgentMetadata 註冊表以保證功能可被調用。

倉庫統計

Star 數
4
Fork 數
0
Open Issue 數
0
主要語言
Python
預設分支
main
同步狀態
閒置
最近同步時間
2026年5月3日 下午10:30
在 GitHub 查看