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