- 文档首页
火山引擎 Agent Toolkit
场景指南
创建与调试托管 Agent
创建与调试托管 Agent
使用 Ark 官方的 arkcli-agent Skill,在已授权账号中创建或管理 Managed Agent(托管智能体),配置模型、Skills 与工具,选择运行环境并通过会话验证效果。这里的托管 Agent 是云上资源,与正在帮助你执行任务的 Code Agent 不同。
- 按 Ark 官方说明获取 arkcli-agent 和 arkcli-shared,确认当前 Agent 已加载,所需 Ark CLI 可用。
- 确认目标账号、项目、Managed Agent 服务开通状态,以及创建 Agent、环境和会话所需的权限。
- 准备任务目标、测试输入和预期结果。使用实时可用的模型与 Skill,不凭名称猜测资源 ID;会话与运行环境应属于同一项目。
创建一个用于文档问答的云端智能体:
调整已有智能体:
- 确认账号、项目和目标,核对服务权限、可用模型与同项目环境。控制面操作先检查 Ark 登录;套餐调用凭据不能代替管理权限。
- 按任务核对已有业务 Skill;用户稍后提供时,将挂载标记为待办,不虚构 Skill ID,也不把本地已安装 Skill 当作云端已挂载。
- 展示模型、提示词、工具、Skills、MCP 与环境配置,以及新增资源和费用影响,取得必要确认。
- 创建后记录返回 ID,回读服务端配置;请求受理、资源创建成功与配置正确分别核对。
- 在同项目环境中创建测试会话,发送脱敏输入并检查事件和实际回复。超时先查询会话与事件,避免重复创建或发送。
- 汇总配置、测试结果和未完成项;保留或清理资源由你决定,删除前确认精确对象与影响。
更新 Agent 不等于所有已有会话已经使用新配置。需按当前产品规则核对会话配置或新建测试会话,不把配置保存当作验证通过。
- Agent、项目、环境和会话标识,以及服务端最终配置。
- 测试输入、实际回复、任务完成情况;发生错误时给出相关状态和诊断信息。
- 资源保留或清理清单。创建成功、会话可用和回复符合任务要求分别判断。
安装 Skill 不会自动开通服务或授予资源权限。模型请求、运行环境及相关云服务可能产生费用,以产品计费规则为准。不要把密钥写入提示词、仓库或测试文本;使用外部 MCP 时,还需对应服务的配置与授权。
模型调用、运行环境和外部工具可能分别产生费用。可结合方舟用量与费用分析核对模型侧数据,但没有完整资源关联时,不把某个 Key 或 Endpoint 的费用称作单个 Agent 的全部成本。 测试结束后列出本次创建的 Agent、环境、会话及相关资源,标明共享依赖。只清理你确认的对象;停止会话不等于所有关联资源都已删除或停止计费。
最近更新时间:2026.10.29 15:14:24