接入云效 Codeup

更新时间:
复制 MD 格式

将云效组织中的代码库接入数字员工后,会话和长期任务可按所选范围访问这些代码库。

适用条件

  • 已创建数字员工。

  • 已有可访问的云效组织,以及该组织下具备代码库只读权限的个人访问令牌(PAT)。

  • 使用 Region 站时,组织已开启公网访问;若组织配置了 IP 白名单,需将 STAROps 出口 IP 加入白名单。

操作步骤

1. 打开代码访问

点击 设置 > 连接器 > 代码访问。

2. 选择云效 Codeup

  1. 点击 添加代码访问。

  2. 选择 云效 Codeup。

  3. 点击 下一步。

3. 填写接入方式

  1. 连接器 ID:用于唯一标识连接器,创建后不可修改。规则:长度 1–64,仅小写字母、数字和短横线,以字母开头,以字母或数字结尾。

  2. 名称:用于在列表中区分连接。

  3. 选择 云效站点:

    • 中心站:接入当前阿里云账号可发现的云效中心站组织。

    • Region 站:选择 Region 后,系统自动加载可接入的组织及其公网访问域名。

      • Region 站需开启公网访问才能被 STAROps 连接,为保证安全性,建议配置 STAROps 出口 IP 白名单。

    • 自定义账号:手动填写其他账号的站点类型、组织、访问域名和账号信息。

4. 配置组织与凭证

  1. 选择要接入的 组织。当前账号下未发现可管理组织时,请核对账号对云效的管理权限。

  2. 填写该组织下的 个人访问令牌(PAT)。

    • 个人访问令牌获取步骤可参考:获取个人访问令牌。建议设置较长的有效期,避免频繁更新连接器;可根据使用诉求按需授予只读或读写权限。

  3. 点击 校验代码库权限。校验通过后,页面会显示当前账号,并可进入接入范围。

    已保存的令牌不会回显。再次校验时需要重新填写 PAT。
    • 注意: PAT 有效但无权访问所选组织时,请更换该组织下的 PAT。Region 站校验失败时,请同时核对 PAT 与组织专属域名。

5. 选择代码库

在 接入范围 中选择该连接器可以访问的代码库,可按名称搜索。确认后点击 下一步。

该 PAT 无法读取所选组织的代码库时,请授予代码库只读权限后重试。

6. 配置数据建模

  • 基础建模:固定开启。连接器创建后,对选中的代码库及其基础关系进行建模。

  • Agentic 关联探索:可选。基础建模后,探索其与应用、基础设施和可观测数据等跨来源关系。建模会发起 Chat,按所选模型及实际用量计费。

确认后点击 下一步。

7. 检查并保存

在 检查并添加 中核对连接器 ID、站点、组织、已选代码库数量和建模配置。确认后点击 完成。

保存后系统会检查连接状态。代码访问列表中出现该连接器。

验证

建议按照下述方案验证连接器是否添加成功:

  1. 在 代码访问 列表中,该连接器的名称、类型 云效 Codeup、状态 成功,以及组织和已选代码库数量与创建时一致。

  2. 打开详情,核对 连接与认证、组织与代码库。

常见问题

加载云效组织失败,或提示没有查看组织的权限

当前阿里云账号无法列出云效组织。请联系管理员授权后重试。Region 站还需确认该账号具备查看 Region 组织的权限。

PAT 无效

请检查令牌是否过期、是否属于所选组织。Region 站还需核对组织专属域名。

连接验证失败

请检查组织域名和公网访问配置。组织提示需要 IP 白名单时,先将 STAROps 出口 IP 加入该组织白名单,再继续。

代码库权限校验失败,或加载可接入范围失败

请确认 PAT 具备代码库只读权限,并检查网络后重试。

保存时提示连接器 ID 已存在

请更换连接器 ID 后重试。

连接器状态为失败

可重新检查连接状态。仍失败时,请删除后重新创建。