确认访问权限和使用前提
创建第一个智能体模板前，先确认当前账号可以进入一体化智能体运行与协同平台（AgentWorks），并且租户中有一个可用的模型凭证和模型。沙箱、MCP、记忆库、知识库、Skill 和渠道都不是首次创建的前提。
获取正确的控制台地址
AgentWorks 的访问地址由当前平台环境决定。请从平台管理员、租户管理员、商务或售后服务人员处获取地址，不要把测试环境、其他租户或 AgentWorks 管理控制台的地址当作通用生产地址。
AgentWorks 有两个相互独立的控制台：
| 控制台 | 主要使用者 | 主要管理内容 |
|---|---|---|
| AgentWorks 控制台 | 智能体构建者、集成开发者 | 智能体模板、智能体实例、模型凭证、Token、渠道和能力资源 |
| AgentWorks 管理控制台 | 获得管理端访问方式的管理员 | 租户、服务账号、租户可用能力、Skills、沙箱规格和沙箱环境 |
AgentWorks 控制台不提供跳转到 AgentWorks 管理控制台的固定入口。需要执行管理员任务时，请向平台交付方确认当前环境的 AgentWorks 管理控制台地址和登录方式。
确认账号和租户
登录前，确认账号由谁分配、属于哪个租户，以及该租户是否已开通 AgentWorks。有关首次登录和账号问题，参见获取账号和登录凭证。
登录后如果租户或账号与预期不符，先停止创建资源。切换到正确租户或让账号分配方修正归属后再继续。
检查首次创建所需入口
完成第一个智能体模板和实例教程至少需要看到以下入口：
- 凭证管理
- 智能体模板
- 智能体实例
如果入口缺失，请让管理员依次检查：
- 当前账号是否属于正确租户并允许登录。
- AgentWorks 是否已对该租户开放。
- 当前账号是否获得执行目标操作所需的权限。
- 调整后是否需要重新登录或刷新页面。
有关平台账号、策略和授权范围的一般规则，参见理解策略和授权范围。可见入口和可执行操作由部署配置及账号授权决定。缺少目标入口时，请让管理员确认租户开通状态和执行该操作所需的权限。
准备模型凭证和模型
创建智能体模板时，模型凭证和模型都是必选项。可以使用租户中已有的模型凭证，也可以在获得凭证管理权限后新建凭证。
开始教程前确认：
- 模型 API Key 仍然有效。
- Base URL 可以从 AgentWorks 服务访问。
- 获取模型列表成功。
- 凭证中至少有一个可选模型。
- 模型服务侧有足够配额完成测试调用。
新建模型凭证时，凭证名称在当前租户内不能与已有模型凭证重复。为不同环境或用途使用可识别且未被占用的名称。
模型凭证属于访问密钥。不要在提示词、描述、聊天消息或工单正文中粘贴 API Key。
暂不准备可选能力
首次教程可以保持以下配置为空：
- 沙箱
- MCP
- 记忆库
- 知识库
- Skill 和技能组
- 飞书、QQ 或 WebSocket 渠道
当智能体实例需要执行代码、调用外部工具、检索企业资料、保留长期记忆或通过渠道服务用户时，再在其来源智能体模板中添加对应能力。租户未开放上述可选能力不会阻止创建只使用模型的智能体模板和实例。
验证可以开始教程
满足以下条件后，可以继续创建第一个智能体并完成基础验证：
- 可以登录普通控制台并确认所属租户。
- 可以打开凭证、智能体模板和智能体实例页面。
- 有一个通过连通性检查的模型凭证。
- 可以从该凭证选择一个模型。
如果其中一项仍不满足，请把缺失入口、当前租户 ID、操作时间和页面错误信息交给管理员处理，不要通过共享他人账号或密钥绕过访问问题。