已就绪内容按当前版本翻译;动态数量、项目输入等部分界面仍可能显示中文原文。
智能体与自动化 · 火山引擎

AgentKit API

調用火山引擎AgentKit智能體接口,30分鐘跑通帶工具調用與記憶的對話智能體。

AI 辅助整理
智能體開發工具調用API對話應用串流回應

工具介紹

AgentKit是火山引擎面向智能體開發的API服務,輸入為包含agent_id、query、session_id的POST請求,輸出為含answer欄位的JSON回應。它內建天氣、搜尋、計算器等工具,支援自訂工具與串流回應,並提供會話記憶。適合日均調用量大、需要工具調用和記憶能力的對話類智能體開發,僅做單次大模型推理的場景直接用大模型API成本可能更低。

適合誰用

需要內建工具調用/記憶能力、日均API調用量1萬次以上的對話類智能體開發者;不想自建底層Agent框架、希望快速上線的中小型開發團隊;需要多模型協同調度、自訂工作流的企業級智能體開發場景。僅做單次推理、無工具調用/記憶需求的場景,以及需要完全自主可控底層框架原始碼的二次開發者不適合。

建議使用步驟

  1. 01

    準備Python 3.8+或Node.js 16+環境,完成實名認證的火山引擎帳號開通AgentKit服務權限並取得AK/SK密鑰。

  2. 02

    安裝官方SDK:pip install volcengine-agentkit==1.2.0。

  3. 03

    將AK/SK和地域配置為環境變數,地域目前支援cn-beijing、cn-shanghai。

  4. 04

    用控制台建立的智能體ID初始化AgentKitClient,建構包含agent_id、query、session_id的請求調用run_agent接口驗證基礎連通性。

  5. 05

    登入控制台進入智能體配置頁,在工具管理模組開啟網頁搜尋等工具開關,儲存後重新執行調用驗證工具生效。

  6. 06

    進入控制台調用統計頁查看每次請求耗時、回傳狀態與token消耗,排查問題並統計成本。

使用前了解

需要已完成實名認證的火山引擎帳號並開通AgentKit服務權限,取得AK/SK密鑰;所在地區需開通AgentKit服務且與程式碼region參數一致,否則回傳403。AgentKit所有接口僅支援POST請求,不支援GET請求。地域目前支援cn-beijing、cn-shanghai。需要即時輸出可在請求參數中新增stream:true開啟串流回應。免費試用版的具體條件需查官網核實。

费用与套餐:費用由token消耗費用加工具調用費用組成:基礎對話調用每1000token為0.01元,工具調用每次0.005元(據文章引用的定價頁2026年8月數據)。日均調用量不足100次的小流量測試場景,文章建議優先使用免費試用版或輕量級SDK。價格以官網為準,不保證永久價格。

選型助手

让需求变成可修改的筛选条件

依据已录入参数生成条件,结果可查看和修改。帧率与性能需核对实测,不能仅凭算力数值保证。