AgentKit企业版:定价说明与自定义技能配置实战指南
[1] 一句话结论
本指南将讲解AgentKit企业版定价规则与自定义Agent技能的完整配置方法。
[2] 适用场景与不适用场景
适用场景
- 适合企业客户需要自定义业务专属智能体、日均工具调用量在5000次以上的生产场景
- 适合需要预置技能+自定义技能混合配置、对智能体运行稳定性有SLA要求的场景
- 适合需要按实际使用量付费、不想承担固定资源成本的中小团队智能体开发场景
不适用场景
- 如果你的场景是个人学习测试、月调用量低于1000次,建议使用AgentKit免费版,无需开通企业版
- 如果你的场景需要完全本地化部署、不允许数据上云,建议参考火山引擎智能体混合云部署方案
- 如果你的场景仅需要使用通用对话能力、无需自定义工具调用,建议直接使用豆包大模型API,成本更低
[3] 前置准备
- 开发环境:Python 3.8+ / Node.js 16+,AgentKit SDK v1.2.0及以上版本
- 账号权限:已开通火山引擎AgentKit企业版权限,拥有控制台操作与API调用权限
- 依赖项:已安装对应语言的volcengine官方SDK
- 预计耗时:全程配置约15分钟,含测试验证时间
[4] 分步实现
步骤1:开通AgentKit企业版并确认计费规则
步骤说明:首先需要在控制台开通企业版权限,明确计费项避免后续产生预期外费用,跳过这一步可能导致资源被限频或冻结。
操作:登录火山引擎控制台,搜索AgentKit进入产品页,点击「开通企业版」,勾选同意服务协议后提交。开通后可在计费中心查看详细计费规则:智能体运行时CPU 0.000097375元/vCPU/秒,内存0.000015456元/GB/秒,公网流量0.8元/GB,工具沙箱计费规则与运行时一致。
预期结果:开通后控制台顶部显示“企业版已开通”标识,可查看所有计费项详情。
⚠️ 常见错误:开通企业版后产生了预期外的知识库关联费用
原因:企业版计费仅包含智能体运行时、工具沙箱费用,关联的向量知识库、安全围栏等其他云服务会单独计费
解决方法:在费用中心-关联服务计费项中关闭不需要的关联服务,或提前预估关联服务使用量做好成本规划。
步骤2:上传自定义技能包到技能空间
步骤说明:自定义技能需要先上传到技能空间才能被Agent关联使用,跳过这一步会无法在Agent配置页找到对应的自定义技能。
操作:左侧菜单选择「技能中心」-「自定义」,点击「上传新技能」,填写技能名称、描述,上传符合规范的技能压缩包(要求入口文件为index.py,包含invoke方法),选择要添加的技能空间后提交。
代码示例(技能入口文件):
# index.py 自定义技能入口文件 from typing import Dict, Any def invoke(params: Dict[str, Any]) -> Dict[str, Any]: """ 自定义技能调用入口 :param params: 调用参数,由Agent推理生成 :return: 技能执行结果 """ # 替换为你的自定义业务逻辑 query = params.get("query", "") result = {"code": 200, "data": f"处理结果:{query}", "msg": "success"} return result
预期结果:上传后技能状态显示“已发布”,可在对应技能空间的技能列表中看到该技能。
步骤3:为目标Agent绑定自定义技能
步骤说明:需要将技能空间中的技能绑定到指定Agent,才能让Agent在推理时调用该技能,跳过这一步Agent无法调用自定义技能。
操作:进入「我的Agent」列表,选择需要配置的Agent进入详情页,点击「编辑技能配置」,在技能列表中勾选需要绑定的自定义技能,设置技能调用优先级(1-10,数值越高优先级越高)后保存。
预期结果:保存后Agent技能配置列表中显示已绑定的自定义技能。
⚠️ 常见错误:绑定技能后Agent调用时返回“技能不存在”错误
原因:技能仅绑定到了技能空间,没有在Agent的技能配置中开启,或技能优先级设置为0被系统忽略
解决方法:进入Agent技能配置页确认目标技能已勾选,且优先级设置为1-10之间的数值,保存后重新测试。
步骤4:测试技能调用效果
步骤说明:配置完成后需要先进行单技能调用测试,确认技能可以正常执行,避免后续上线后出现业务错误。
操作:在Agent详情页的「测试窗口」中输入触发该技能的query,比如“调用自定义查询技能查询订单号12345的状态”,点击发送。
预期结果:测试窗口返回技能执行的正确结果,可在调用日志中看到技能调用的完整链路。
步骤5:发布配置到生产环境
步骤说明:测试通过后需要将配置发布到生产环境,否则生产流量仍然使用旧的技能配置。
操作:在Agent详情页点击「发布」,选择发布环境为生产,填写发布说明后提交。
预期结果:发布状态显示“已上线”,生产流量将使用新的技能配置。
[5] 实际验证
测试用例:输入query“调用自定义订单查询技能,查询订单号OD20260824001的物流状态”,预期返回包含该订单物流状态的结构化结果。
验证成功标志:HTTP状态码返回200,返回体中skill_call字段显示自定义技能被正常调用,data字段包含正确的订单信息。
验证失败常见原因及排查方法:
- 返回技能不存在:排查技能是否已绑定到当前Agent,且优先级设置为1-10之间
- 返回技能执行报错:排查自定义技能代码的invoke方法是否符合规范,参数是否正确接收
- 返回无技能调用:排查Agent的系统提示词是否明确告知可以调用该自定义技能
[6] 常见问题 FAQ
Q1:AgentKit企业版有没有最低消费?
A1:目前没有最低消费限制,完全按实际使用量计费,使用多少付多少。如果当月使用量未达到0.01元,会免除该部分费用。
Q2:自定义技能可以跨账号复用吗?
A2:目前自定义技能仅支持同账号下的不同Agent复用,跨账号暂不支持。如果需要跨账号使用,可将技能包导出后在目标账号重新上传。
Q3:什么情况下不建议使用AgentKit企业版自定义技能?
A3:如果你的技能逻辑非常简单,仅需要调用第三方公开API,建议直接使用AgentKit预置的HTTP调用技能,无需开发自定义技能,节省开发成本。
Q4:我可以跳过测试步骤直接发布到生产吗?
A4:不建议跳过,自定义技能如果存在代码bug,可能导致Agent调用失败甚至返回错误结果影响业务,我们在多个客户实践中都遇到过跳过测试直接上线导致的业务故障。
Q5:自定义技能的执行超时时间是多少?
A5:默认超时时间是30秒,最长可配置到120秒,如果超过超时时间技能还未返回结果,系统会自动终止调用并返回超时错误。
[7] 相关阅读
- 《AgentKit预置技能使用指南》[/docs/86681/2214405] 讲解AgentKit自带的各类预置技能的配置与使用方法
- 《AgentKit计费规则详解》[/docs/86681/2480915] 完整介绍AgentKit所有计费项与计费规则,帮助你做好成本规划
- 《AgentKit SDK开发文档》[/agentkit-sdk-python/content/1.introduction/1.overview.html] 包含各语言SDK的安装与调用示例
- 《AgentKit常见问题汇总》[/docs/86681/2085690] 汇总了用户在使用AgentKit过程中遇到的各类常见问题与解决方案
[8] 参考资料
[1] 火山引擎AgentKit计费项说明,https://docs.volcengine.com/docs/86681/2480915?lang=zh,2026年8月24日[2] 火山引擎AgentKit为我的Agent配置技能指南,https://docs.volcengine.com/docs/87732/2477473?lang=zh,2026年8月24日
本文基于火山引擎AgentKit v2.1版本编写,定价数据来源为火山引擎官方2026年8月公开的定价文档,其中智能体运行时CPU单价为0.000097375元/vCPU/秒。
[9] 文章当前生产日期
2026-08-24

