全部产品
Search
文档中心

人工智能平台 PAI:云产品依赖与授权:LangStudio

更新时间:Nov 08, 2024

首次使用大模型应用开发(LangStudio),需要对LangStudio服务角色进行云资源访问授权,并开通依赖的云产品服务。本文介绍LangStudio依赖的云产品服务和使用LangStudio时所需的授权操作。

背景信息

使用LangStudio前,您需要先为操作账号授权使用LangStudio功能的通用权限,使账号能够操作使用LangStudio功能。如果您需要对不同的RAM用户进行不同的权限细分管控,PAI也支持您通过工作空间对RAM用户进行LangStudio操作权限的细化管控。此外,LangStudio会在后台使用对象存储OSS进行文件存储,使用日志服务SLS和可观测链路OpenTelemetry版进行应用流的开发调试,以及使用PAI的子产品EAS进行应用流的部署,因此,需要您授权LangStudio服务账号对以上产品的访问权限。授权操作详情,请参见下文的操作指导。

  • 操作账号授权

    LangStudio产品为您提供一站式的大模型应用开发能力,依赖阿里云的对象存储OSS、日志服务SLS、可观测链路OpenTelemetry版,以及PAI的子产品EAS等,您需要做好授权操作。

  • PAI服务账号授权

    授权阿里云账号拥有LangStudio的通用操作权限。

操作账号授权

在使用LangStudio时,依赖以下相关云产品,您需要做好授权操作。

  • PAI子产品:LangStudio

    操作账号类型

    使用场景

    操作引导链接

    主账号

    主账号可直接进行LangStudio的所有操作,无需额外授权。

    不涉及

    RAM账号

    (推荐)

    PAI为您提供了不同的成员角色,您可根据需要将RAM用户添加为对应角色的工作空间成员,使其拥有对应子产品的操作权限。e583a87bf51ad615ad429cfdc37d13e6

    管理工作空间成员

  • 对象存储OSS:用于存储您在开发大模型应用流时使用的代码和配置文件,以及开发调试过程产生的日志和部署服务的快照文件。

    细分场景

    场景说明

    操作引导链接

    开通OSS

    建议您使用主账号进行开通操作。使用主账号开通时无需额外授权操作。如果您希望使用RAM账号开通OSS,您需要给RAM账号授予AliyunOSSFullAccess权限。

    使用OSS

    后续使用OSS时:

    • 授权:OSS提供了详细的RAM管控策略,您可根据需要给对应RAM账号授予操作权限。

    • 常见操作:通常需要创建好一个存储空间(Bucket),便于后续上传文件至OSS。

  • 可观测链路OpenTelemetry版:用于大模型工作流开发和部署服务的日志链路追踪。

    细分场景

    场景说明

    操作引导链接

    开通可观测链路OpenTelemetry版

    建议您使用主账号进行开通操作。使用主账号开通时无需额外授权操作。如果您希望使用RAM账号开通可观测链路,您需要给RAM账号授予AliyunARMSFullAccess权限。

    使用可观测链路OpenTelemetry版

    您可以在LangStudio控制台查看开发调试或部署服务产生的链路追踪日志,也可以前往可观测链路 OpenTelemetry 版控制台进行查看。

  • 日志服务SLS(间接依赖,为可观测链路OpenTelemetry版所需:用于可观测链路OpenTelemetry版存储日志数据。

    细分场景

    场景说明

    操作引导链接

    开通日志服务SLS

    建议您使用主账号进行开通操作。使用主账号开通时无需额外授权操作。如果您希望使用RAM账号开通SLS,您需要给RAM账号授予AliyunLogFullAccess权限。

  • 专有网络VPC:在应用流的运行或部署过程中,系统需要查询您的专有网络VPC配置信息,以便正确部署EAS服务。

    细分场景

    场景说明

    操作引导链接

    开通专有网络VPC

    建议您使用主账号进行开通操作。使用主账号开通时无需额外授权操作。如果您希望使用RAM账号开通专有网络VPC,您需要给RAM账号授予AliyunVPCFullAccess权限。

  • PAI:用于访问PAI工作空间及PAI子产品。

    细分场景

    场景说明

    操作引导链接

    开通人工智能平台PAI

    建议您使用主账号进行开通操作。使用主账号开通时无需额外授权操作。如果您希望使用RAM账号开通PAI,您需要给RAM账号授予AliyunPAIFullAccess权限。

PAI服务账号授权

为阿里云账号(主账号)授权LangStudio通用权限

首次开通LangStudio时,您需要为当前阿里云账号授权LangStudio通用权限,以确保LangStudio正常提供服务。具体操作步骤如下:

  1. 登录PAI控制台,在右侧选择目标工作空间后,单击进入LangStudio

  2. 进行云资源访问授权。

    1. 单击去授权

    2. 云资源访问授权页面,单击同意授权

      云资源访问授权页面,系统自动配置LangStudio需要的关联角色,无需手动配置。

  3. 授权AliyunServiceRoleForPaiLLMTrace、AliyunServiceRoleForPaiLangStudio和AliyunServiceRoleForPaiEas角色。

    在LangStudio页面,单击立即授权,大约等待3分钟,即可完成授权。

参考1:如何修改LangStudio服务角色的授权策略

如果您需要对云资源访问授权进行更精细的管控,可以在RAM控制台对已授权的AliyunPAILangStudioDefaultRole角色进行自定义权限策略。

说明

请确保您对RAM权限策略有充分的认识,避免操作不当引起LangStudio功能不可用。

下面以修改OSS的授权策略为例,说明如何对LangStudio默认服务角色进行更精细化的授权,具体操作步骤如下。

说明

OSS支持对Bucket打标签,您可以对授权LangStudio访问的Bucket打上标签(Key-Value键值对),例如Key:Product, Value:PaiLangStudio。具体操作,请参见管理存储空间标签

  1. 查看AliyunPAILangStudioDefaultRole默认权限策略。

    1. 登录RAM控制台,并在左侧导航栏选择身份管理 > 角色

    2. 在角色页面的搜索框中,输入AliyunPAILangStudioDefaultRole进行搜索,并单击目标角色名称。

    3. 权限管理页面单击权限策略名称,查看并拷贝默认策略内容。

      {
          "Version": "1",
          "Statement": [
              {
                  "Action": [
                      "eas:CreateService",
                      "eas:ListServices",
                      "eas:DescribeService",
                      "eas:DeleteService",
                      "eas:UpdateService",
                      "eas:StartService",
                      "eas:StopService"
                  ],
                  "Resource": "*",
                  "Effect": "Allow"
              },
              {
                  "Action": [
                      "oss:GetObject",
                      "oss:PutObject",
                      "oss:DeleteObject",
                      "oss:ListObjects"
                  ],
                  "Resource": "*",
                  "Effect": "Allow"
              },
              {
                  "Action": [
                      "paillmtrace:GetXtraceToken"
                  ],
                  "Resource": "*",
                  "Effect": "Allow"
              }
          ]
      }
  2. 通过脚本编辑模式创建自定义权限策略,其中:

    • 权限策略内容可根据上述拷贝的默认策略内容进行修改。例如修改OSS授权策略内容,为通过Condition指定可访问的OSS Bucket,示例内容如下:

      说明

      在实际使用时,请移除所有的注释内容。

      {
          "Version": "1", 
          "Statement": [
              //其他授权策略,不要修改
      
              //修改OSS授权策略,通过指定Tag限定授权访问的OSS资源
              {
                  "Action": [
                      "oss:GetObject", 
                      "oss:PutObject", 
                      "oss:DeleteObject", 
                      "oss:ListObjects"
                  ], 
                  "Resource": "*", 
                  "Effect": "Allow", 
                  "Condition": {
                      "StringEquals": {
                          "oss:BucketTag/Product": "PaiLangStudio"
                      }
                  }
              }
          ]
      }
    • 名称配置为CustomAliyunPAILangStudioDefaultRolePolicy。

  3. 将新创建的自定义权限策略CustomAliyunPAILangStudioDefaultRolePolicy添加到AliyunPAILangStudioDefaultRole角色,并解除该角色默认的授权策略AliyunPAILangStudioDefaultRolePolicy。具体操作,请参见为RAM角色授权为RAM角色移除权限image

    更新成功后,LangStudio则会按照新增的授权策略访问您的资源。

参考2:检查账号是否关联AliyunPAILangStudioDefaultRole角色

您可以按照以下操作步骤,来确认当前阿里云账号是否拥有AliyunPAILangStudioDefaultRole这一角色。

说明

仅主账号可以进行授权,RAM用户无法授权。

  1. 登录RAM控制台,在左侧导航栏,单击身份管理>角色

  2. 角色页面的搜索框中,输入AliyunPAILangStudioDefaultRole,进行搜索。