常见问题

Q：如何使用企业身份系统（如 Okta）登录 LangStudio？

LangStudio 基于阿里云 RAM 用户体系，支持企业通过单点登录（SSO）方式接入。

如果您的企业已有身份管理系统（如 Okta、Microsoft Entra ID 等），可以通过配置阿里云 RAM 用户 SSO，实现员工使用企业账号直接登录 LangStudio，无需单独创建阿里云账号。

配置方法请参见企业使用自有身份系统单点登录云。

Q：调用阿里云百炼模型报错：OpenAI API hits APIConnectionError: Connection error

阿里云百炼模型需要通过公网访问，在启动运行时配置专有网络，同时专有网络需要开通公网访问，详情请参见使用公网NAT网关SNAT功能访问互联网。

Q：创建知识库时如何选择向量数据库Faiss或Milvus？

Faiss通常用于测试环境，无需额外创建数据库即可使用。在生产环境中，建议您使用Milvus数据库，支持处理更大规模的数据。

Q：知识库使用Faiss数据库报错：The run failed due to reaching the timeout: 300

• 报错原因：在使用Faiss向量数据库时，向量数据库是保存在OSS中，并且在运行时中加载使用，对机器性能要求比较高。因此，建议运行时配置较大规模的资源，如8/16核CPU，以确保系统能够高效处理相关任务。

• 解决方案：

  • 方法一：修改运行时配置。在运行时列表中单击指定运行时名称，然后单击右上角变更配置，修改资源规格。

  • 方法二：删除已有运行时，重新创建资源规格更高的运行时，并在应用流中引用。

Q：知识库使用Faiss数据库报错：Tool load failed in 'index_lookup': (ToolLoadError) Failed to load package tool 'Index Lookup': (AccessDenied)

• 报错原因：当使用Faiss作为向量数据库时，应用流生成的索引文件没有权限保存至已配置的OSS路径。

• 解决方案：使用PAI默认角色，重新创建知识库索引，并确保将参数输出OSS路径配置为当前工作空间默认存储路径所在的OSS Bucket下的任一目录。然后在应用流中重新配置知识库索引节点，详情请参见知识库索引管理-创建知识库索引。

  

Q：没有创建DSW实例，仅使用了PAI-LangStudio功能，为什么会产生PAI-DSW的计费

LangStudio创建应用流开发模式后，启动运行时会使用DSW资源，启动后会产生费用，需要根据实际使用情况，及时在DSW实例列表中停止对应实例，以免产生不必要的费用。

Q：报错：Execution failure in 'iqs_generic_search': (ClientException) Error: Retrieval.NotActivate code: 403, Please activate AI search service

• 报错原因：联网搜索服务未开通。

• 解决方案：请参考联网搜索开通说明进行开通。

Q：报错：Execution failure in 'iqs_generic_search': (ClientException) Error: Retrieval.NotAuthorised code: 403, No Permission

• 报错原因：无权限使用联网搜索服务。

• 解决方案：应用流支持RAM角色（更加安全）和api_key两种方式使用IQS联网搜索服务。检查您使用的运行时的实例RAM角色配置。

  • 如果您选择PAI默认角色，需通过api_key使用联网搜索服务。

    1. 在连接页签下，选择自定义连接 > 新建连接，自定义键填写api_key，自定义值可通过信息查询服务-凭证管理查看。

       

       

    2. 在标准搜索中配置上一步设置的IQS连接。

  • 如果您选择了自定义角色，检查选择的自定义角色确保满足以下条件：

    • 信任策略内容如下：

      {
        "Statement": [
          {
            "Action": "sts:AssumeRole",
            "Effect": "Allow",
            "Principal": {
              "Service": "pai.aliyuncs.com"
            }
          },
          {
            "Action": "sts:AssumeRole",
            "Effect": "Allow",
            "Principal": {
              "Service": "eas.pai.aliyuncs.com"
            }
          }
        ],
        "Version": "1"
      }

    • 拥有3个权限策略：AliyunIQSFullAccess、AliyunOSSFullAccess、AliyunPAIFullAccess。