AgentKit自定义工作流搭建：公测期免费试用全指南

[1] 一句话结论 #

本指南将帮你快速了解AgentKit免费试用规则，完成自定义Agent工作流搭建。

[2] 适用场景与不适用场景 #

适用场景

1. 适合需要快速搭建POC验证智能体业务价值，日均调用量小于1000次的测试场景
2. 适合非生产环境下需要低代码编排多工具调用、多分支逻辑的智能客服、内部助手场景
3. 适合想要快速对接大模型+知识库+工具链，无需自行搭建调度逻辑的开发者

不适用场景

1. 生产环境高并发（单接口QPS>10）的业务场景，当前公测阶段SLA为99.5%，建议等正式商业化后使用，替代方案可参考火山引擎函数计算自建Agent调度
2. 需要完全私有化部署的场景，当前公测期仅支持公有云部署，替代方案可参考【需补充：火山引擎私有化智能体方案】
3. 单工作流节点超过20个的超复杂调度场景，当前画布最多支持20个节点，替代方案可使用Agent SDK自定义调度逻辑

[3] 前置准备 #

• 开发环境：Python 3.9+ / Node.js 16+，如果使用可视化画布无需代码环境
• 账号权限：已完成实名认证的火山引擎账号，无需额外申请试用权限
• 依赖项：如使用SDK，需安装agentkit-python SDK v0.2.1版本
• 预计耗时：可视化搭建约15分钟，代码搭建约30分钟

[4] 分步实现 #

步骤1：开通AgentKit服务并进入控制台

步骤说明：首先登录火山引擎控制台，搜索AgentKit进入产品页，公测期无需申请直接开通，进入后即可看到Agent Builder可视化画布入口。这一步是获取服务访问权限的前提，跳过则无法访问编排工具。
代码/命令：无（可视化操作）
预期结果：进入AgentKit控制台后能看到"新建工作流"按钮，页面无权限报错。

⚠️ 常见错误：进入页面提示"没有访问权限"
原因：账号未完成实名认证，或者当前子账号没有AgentKit的FullAccess权限
解决方法：主账号先完成实名认证，然后在访问控制IAM中给子账号配置AgentKitFullAccess权限。

步骤2：创建空白工作流选择编排模式

步骤说明：点击"新建工作流"，可以选择"可视化画布编排"（零代码，适合简单场景）或者"代码编排"（适合复杂自定义场景）。我们推荐首次使用先选可视化模板，基于预置的"智能客服"模板修改，能减少80%的配置工作量。
代码/命令：无
预期结果：进入编排页面，左侧能看到大模型、工具、逻辑节点、知识库等组件列表。

步骤3：拖拽组件编排工作流逻辑

步骤说明：将需要的组件从左侧拖拽到画布，连线配置执行顺序：首先选择推理大模型（支持豆包系列/OpenAI系列），然后添加需要调用的工具（比如天气查询、知识库检索），再添加逻辑判断节点配置分支规则（比如当用户问题包含"查订单"时跳转到订单查询工具）。每个组件需要单独配置参数，比如大模型要选版本、设置温度参数。
代码/命令：如果用代码编排，示例代码如下：

from agentkit import Agent, Workflow, ToolNode, LLNode
# 初始化大模型节点
llm_node = LLNode(model="doubao-3-pro", temperature=0.7)
# 初始化工具节点
tool_node = ToolNode(tools=["weather_query", "knowledge_base_retrieval"])
# 编排工作流
workflow = Workflow([llm_node, tool_node])
# 绑定API密钥
workflow.config(api_key="YOUR_API_KEY")

预期结果：画布上所有组件连线正确，无红色报错提示，右上角"校验"按钮点击后显示"校验通过"。

⚠️ 常见错误：校验时提示"工具节点未配置授权"
原因：调用的第三方工具（比如企业内部API、电商平台接口）未提前在工具管理页面完成权限配置
解决方法：先到"工具管理"页面添加对应工具，配置鉴权信息后再在工作流中引用。

步骤4：测试工作流运行效果

步骤说明：校验通过后，点击右上角"测试"按钮，输入测试query（比如"明天北京天气怎么样，适合出行吗？"），查看运行链路和返回结果。如果不符合预期，可以调整节点参数或者连线逻辑。
代码/命令：代码编排测试代码：

# 测试工作流
result = workflow.run(query="明天北京天气怎么样，适合出行吗？")
print(result)

预期结果：返回结果包含天气信息，运行链路显示每个节点执行成功，无异常报错。

步骤5：部署工作流生成调用端点

步骤说明：测试通过后，点击"部署"按钮，选择部署版本（测试版/正式版），部署完成后会生成API调用端点，你可以直接调用该端点，或者通过ChatKit嵌入到自有前端页面。
代码/命令：调用端点示例：

curl -X POST https://agentkit.volcengine.com/api/v1/workflow/YOUR_WORKFLOW_ID/run \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"明天北京天气怎么样"}'

预期结果：返回HTTP 200状态码，响应体包含工作流执行结果。

[5] 实际验证 #

我们使用完整测试用例验证：输入query="北京今天的气温是多少，帮我推荐适合穿的衣服"，预期输出应该包含北京当天的气温数值，以及对应的穿衣建议，运行链路显示依次调用了大模型节点、天气查询工具节点、大模型生成回答节点三个步骤。
验证成功的标志：HTTP状态码为200，返回体中"status"字段为"success"，返回内容符合预期逻辑。
验证失败常见排查方法：1. 如果返回401，检查API密钥是否正确，是否有工作流的调用权限；2. 如果返回500，查看运行日志，看是哪个节点执行报错，对应调整节点参数；3. 如果返回结果不符合预期，调整大模型的Prompt或者工具调用的触发规则。

[6] 常见问题 FAQ #

Q1：AgentKit公测期真的完全免费吗？
A1：公测期间AgentKit的核心组件（智能体运行时、工具调度、记忆库）完全免费，只有关联的其他云产品（比如日志服务、对象存储、向量数据库）会产生少量费用，你可以在控制台申请公测专属100元代金券抵扣这部分成本，数据来源是火山引擎AgentKit公测计费说明¹。

Q2：我可以跳过可视化编排直接用代码搭建工作流吗？
A2：可以，AgentKit提供了Python/Node.js两种SDK，你可以完全通过代码编排工作流逻辑，适合有复杂自定义需求的场景，不过我们建议首次使用先通过可视化画布熟悉组件逻辑，能大幅减少代码调试时间。

Q3：AgentKit最多支持同时调度多少个工具？
A3：当前单个工作流最多支持同时配置10个工具，单次执行最多调用5个工具，如果你需要更多工具调度，可以拆分工作流为多个子工作流调用。

Q4：什么情况下不建议使用AgentKit？
A4：如果你的场景是生产环境高并发（QPS>10）的核心业务，当前公测期SLA为99.5%，不建议使用，建议等正式商业化版本上线后再接入，或者使用函数计算自建Agent调度逻辑。

Q5：工作流部署后可以修改吗？
A5：可以，修改后需要重新部署，支持版本管理，你可以随时回滚到历史版本，建议每次修改前先复制当前版本作为备份，避免修改后无法恢复。

[7] 相关阅读 #

1. 《玩转AgentKit之专属智能客服构建》[/handsonlab/2]，手把手教你基于AgentKit搭建一个带知识库的智能客服
2. 《AgentKit API 参考文档》[/docs/86681/2163658]，包含所有API参数说明和调用示例
3. 《AgentKit SDK Python 开发指南》[https://volcengine.github.io/agentkit-sdk-python/]，代码编排工作流的完整文档
4. 《中小企业智能体选型指南》[/articles/7667140924984623147]，帮你判断业务场景是否适合用AgentKit

[8] 参考资料 #

[1] 火山引擎AgentKit公测计费说明，https://www.volcengine.com/docs/86681/2068432，2026-08-24
[2] 火山引擎AgentKit入门指引，https://www.volcengine.com/docs/86681/2163658，2026-08-24
本文基于火山引擎AgentKit公测版本v1.0编写

[9] 文章当前生产日期 #

2026-08-24