Accounts and Permissions
Q: How can I sign in to LangStudio using an enterprise identity system like Okta?
You can integrate enterprise identity systems like Okta or Microsoft Entra ID with LangStudio by configuring Single Sign-On (SSO) through Alibaba Cloud's RAM (Resource Access Management) service. This allows employees to use their existing corporate accounts to sign in, eliminating the need for separate Alibaba Cloud accounts.
For detailed configuration steps, see Enterprise single sign-on to Alibaba Cloud using your own identity system.
After configuring SSO, you must grant the necessary LangStudio permissions to the RAM User. For details, see Cloud service dependencies and authorization: LangStudio.
Model Invocation
Q: Why am I getting an APIConnectionError: Connection error when calling an Alibaba Cloud Model Studio model?
This error occurs because your runtime's Virtual Private Cloud (VPC) does not have the public internet access required to reach Alibaba Cloud Model Studio models.
To fix this, enable internet access for your VPC. For instructions, see Use the SNAT feature of an Internet NAT gateway to access the Internet.
Knowledge Base
Q: What's the difference between Faiss and Milvus when creating a knowledge base?
The choice depends on your environment:
Use Faiss for testing. It is lightweight and does not require a separate database instance.
Use Milvus for production. It is designed for larger-scale data processing and offers better performance and scalability.
Q: Why am I getting a The run failed due to reaching the timeout: 300 error with a Faiss-based knowledge base?
Cause: This timeout error indicates that your runtime has insufficient resources. When using Faiss, vector data is stored in Object Storage Service (OSS) and loaded into the runtime's memory, which is a resource-intensive operation. A low-spec runtime may not be able to handle the load.
Solution: Increase the resource specification of your runtime. You have two options:
Modify the existing runtime: In the runtime list, click the runtime name, then click Change Settings in the upper-right corner to select a larger Instance Type, such as an 8-core or 16-core CPU.
Create a new runtime: Delete the current runtime, create a new one with a higher resource specification, and update your application flow to use the new runtime.
Q: How do I resolve a ToolLoadError... (AccessDenied) when using a Faiss-based knowledge base?
Cause: This error, fully displayed as
Tool load failed in 'index_lookup': (ToolLoadError) Failed to load package tool 'Index Lookup': (AccessDenied), means the application flow does not have the necessary permissions to save the generated index file to the specified Object Storage Service (OSS) path.Solution: To grant the required permissions, follow these steps:
Recreate the knowledge base index using the default PAI role.
During creation, ensure the Output OSS Path is set to a directory within the OSS Bucket that serves as your workspace's default storage path.
Reconfigure the knowledge base index node in your application flow to use the newly created index.
For more details, refer to Knowledge base index management - Create a knowledge base index.
Billing
Q: I haven't created any PAI-DSW instances and have only used LangStudio. Why am I being charged for PAI-DSW?
LangStudio's application flow development mode uses PAI-DSW (Data Science Workshop) resources to power its runtimes. Billing for PAI-DSW begins as soon as you start a runtime.
To avoid unexpected charges, make sure to stop the corresponding DSW instance from the DSW instance list whenever it is not in active use.
