Avant d'utiliser LangStudio dans Platform for AI (PAI), vous devez effectuer deux étapes : autoriser LangStudio à accéder aux services cloud dépendants et accorder les autorisations appropriées à votre compte d'exploitation.
En raison d'un ajustement de la stratégie produit, PAI-LangStudio sera retiré le 9 mars 2027 à 16 h 00. Après cette date de retrait, vous ne pourrez plus utiliser les fonctionnalités de LangStudio dans la console PAI et tous les services de support associés seront également interrompus. Pour plus d'informations, consultez le Guide de retrait et de migration de PAI-LangStudio.
Configuration minimale requise
Si vous configurez LangStudio pour la première fois, suivez ces étapes dans l'ordre :
Activez les services dépendants — LangStudio dépend d'Object Storage Service (OSS), de Simple Log Service (SLS), de Managed Service for OpenTelemetry et d'Elastic Algorithm Service (EAS) de PAI. Activez ces services depuis la console PAI lorsque vous y êtes invité.
Autorisez le rôle de service LangStudio — Dans la console PAI, cliquez sur Authorize sur la page Quick Authorization pour attribuer le rôle de service
AliyunPAILangStudioDefaultRoleà votre compte Alibaba Cloud. Le système gère cette opération automatiquement ; aucune configuration manuelle du rôle n'est requise.Accordez des autorisations au compte d'exploitation — Si vous utilisez un utilisateur RAM pour gérer LangStudio, attribuez-lui le rôle de membre d'espace de travail approprié dans PAI. Si vous utilisez directement un compte Alibaba Cloud, aucune autorisation supplémentaire n'est nécessaire.
Pour la procédure d'autorisation complète, consultez la section Autoriser LangStudio pour la première fois.
Services cloud dépendants
LangStudio s'intègre aux services cloud suivants. Chaque service doit être activé avant que vous puissiez utiliser la fonctionnalité LangStudio correspondante. Si vous activez un service à l'aide d'un utilisateur RAM, attachez d'abord la stratégie RAM requise à cet utilisateur.
Module PAI — LangStudio
|
Compte d'exploitation |
Détails |
Référence |
|
Compte Alibaba Cloud |
Aucune autorisation supplémentaire requise. |
S/O |
|
Utilisateur RAM (recommandé) |
PAI propose des rôles de membres d'espace de travail avec différents périmètres d'autorisation. Attribuez le rôle de membre approprié à chaque utilisateur RAM. |
Pour la liste complète des autorisations des rôles de membre, consultez la section Liste des rôles et des autorisations — LangStudio.

Object Storage Service (OSS)
OSS stocke les fichiers de code et de configuration, les journaux de développement et de débogage, ainsi que les fichiers snapshot de service générés lors du déploiement d'un flux d'application.
|
Scénario |
Détails |
Référence |
|
Activer OSS |
Utilisez un compte Alibaba Cloud — aucune autorisation supplémentaire n'est requise. Pour activer avec un utilisateur RAM, attachez la stratégie AliyunOSSFullAccess à l'utilisateur RAM. |
Démarrage rapide via la console / Présentation des stratégies RAM |
|
Utiliser OSS |
OSS prend en charge des stratégies RAM granulaires. Créez un bucket pour stocker les objets utilisés par LangStudio. |
Managed Service for OpenTelemetry
Managed Service for OpenTelemetry fournit une analyse des traces lorsque vous développez et déployez des flux d'applications LLM.
Scénario | Détails | Référence |
Activer Managed Service for OpenTelemetry | Utilisez un compte Alibaba Cloud — aucune autorisation supplémentaire n'est requise. Pour activer avec un utilisateur RAM, attachez la stratégie AliyunARMSFullAccess à l'utilisateur RAM. | Démarrage rapide / Utiliser des utilisateurs RAM pour gérer les autorisations |
Consulter l'analyse des traces | Consultez les journaux de traces depuis la console LangStudio ou la console Managed Service for OpenTelemetry. | — |
Simple Log Service (SLS)
SLS est une dépendance indirecte : il stocke les données de journal pour Managed Service for OpenTelemetry.
|
Scénario |
Détails |
Référence |
|
Activer Simple Log Service |
Utilisez un compte Alibaba Cloud — aucune autorisation supplémentaire n'est requise. Pour activer avec un utilisateur RAM, attachez la stratégie AliyunLogFullAccess à l'utilisateur RAM. |
Hiérarchie des ressources de stockage / Créer et autoriser un utilisateur RAM |
Virtual Private Cloud (VPC)
Lors du déploiement du flux d'application, LangStudio interroge votre configuration VPC pour déployer correctement Elastic Algorithm Service (EAS).
|
Scénario |
Détails |
Référence |
|
Activer VPC |
Utilisez un compte Alibaba Cloud — aucune autorisation supplémentaire n'est requise. Pour activer avec un utilisateur RAM, attachez la stratégie AliyunVPCFullAccess à l'utilisateur RAM. |
Créer et gérer un VPC / Utiliser RAM pour le contrôle d'accès |
PAI
L'accès à l'espace de travail PAI est requis pour utiliser les modules LangStudio.
|
Scénario |
Détails |
Référence |
|
Activer PAI |
Utilisez un compte Alibaba Cloud — aucune autorisation supplémentaire n'est requise. Pour activer avec un utilisateur RAM, attachez la stratégie AliyunPAIFullAccess à l'utilisateur RAM. |
Activer PAI et créer un espace de travail par défaut / Se connecter avec un rôle RAM et utiliser PAI |
DataWorks
DataWorks est requis pour les mises à jour planifiées de la base de connaissances. Activez-le uniquement si vous utilisez cette fonctionnalité.
|
Scénario |
Détails |
Référence |
|
Activer DataWorks |
Utilisez un compte Alibaba Cloud — aucune autorisation supplémentaire n'est requise. Pour activer avec un utilisateur RAM, attachez la stratégie AliyunDataWorksFullAccess à l'utilisateur RAM. |
Bonnes pratiques pour la gestion des autorisations des utilisateurs RAM |
Autoriser LangStudio pour la première fois
La première fois que vous accédez à LangStudio, effectuez les étapes suivantes pour autoriser le rôle de service et activer les services dépendants.
Seuls les comptes Alibaba Cloud peuvent autoriser le rôle de service AliyunPAILangStudioDefaultRole . Les utilisateurs RAM ne peuvent pas effectuer cette étape.
Connectez-vous à la console PAI. Dans le volet de droite, sélectionnez votre espace de travail et cliquez sur Enter LangStudio.
Cliquez sur Authorize.
Sur la page Quick Authorization, cliquez sur Confirm Authorization et effectuez la vérification de sécurité. Le système attribue automatiquement le rôle de service
AliyunPAILangStudioDefaultRoleà votre compte.Cliquez sur Activate For Free pour activer OSS, Simple Log Service et Managed Service for OpenTelemetry.
Référence : Personnaliser la stratégie du rôle de service LangStudio
Assurez-vous de bien comprendre les stratégies RAM avant de modifier les autorisations du rôle de service. Des modifications incorrectes peuvent rendre LangStudio indisponible.
Par défaut, LangStudio utilise le rôle de service AliyunPAILangStudioDefaultRole avec la stratégie AliyunPAILangStudioDefaultRolePolicy . Si vous avez besoin d'un contrôle plus granulaire sur l'accès aux ressources cloud, remplacez la stratégie par défaut par une stratégie personnalisée.
Afficher la stratégie par défaut
Connectez-vous à la console RAM. Dans le volet de navigation de gauche, choisissez Identities > Roles.
Recherchez AliyunPAILangStudioDefaultRole et cliquez sur le nom du rôle.
Dans l'onglet Permissions, cliquez sur le nom de la stratégie pour afficher et copier le contenu de la stratégie par défaut.
La stratégie par défaut accorde les autorisations suivantes :
{
"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"
},
{
"Action": [
"paidlc:CreateJob",
"paidlc:DeleteJob",
"paidlc:StopJob",
"paidlc:GetJob",
"paidlc:UpdateJob",
"paidlc:ListJobs"
],
"Resource": "*",
"Effect": "Allow"
},
{
"Action": [
"paidsw:CreateInstance",
"paidsw:DeleteInstance",
"paidsw:UpdateInstance",
"paidsw:StartInstance",
"paidsw:StopInstance",
"paidsw:GetInstance",
"paidsw:ListInstances"
],
"Resource": "*",
"Effect": "Allow"
},
{
"Action": "pai:AssumeUser",
"Resource": "acs:pai:*:*:users/*",
"Effect": "Allow"
},
{
"Action": "ram:CreateServiceLinkedRole",
"Resource": "*",
"Effect": "Allow",
"Condition": {
"StringEquals": {
"ram:ServiceName": "eas.pai.aliyuncs.com"
}
}
},
{
"Action": [
"dataworks:CreateWorkflowDefinition",
"dataworks:UpdateWorkflowDefinition",
"dataworks:GetWorkflowDefinition",
"dataworks:ListWorkflowDefinitions",
"dataworks:DeleteWorkflowDefinition",
"dataworks:CreateDeployment",
"dataworks:GetDeployment",
"dataworks:ExecDeploymentStage",
"dataworks:GetJobStatus",
"dataworks:ImportWorkflowDefinition"
],
"Resource": "*",
"Effect": "Allow"
},
{
"Action": [
"paiflow:CreatePipelineRun",
"paiflow:GetPipelineRun",
"paiflow:DeletePipelineRun",
"paidataset:CreateDataset",
"paidataset:GetDataset",
"paidataset:UpdateDataset",
"paidataset:ListDatasets",
"paidataset:DeleteDataset",
"paidataset:CreateDatasetVersion",
"paidataset:GetDatasetVersion",
"paidataset:UpdateDatasetVersion",
"paidataset:DeleteDatasetVersion",
"paidataset:ListDatasetVersions"
],
"Resource": "*",
"Effect": "Allow"
}
]
}
Créer une stratégie personnalisée
-
Créez une stratégie personnalisée à l'aide de l'éditeur de script. L'exemple suivant restreint l'accès OSS aux buckets tagués avec
Product: PaiLangStudio, en utilisant l'élément Condition dans RAM. Conservez toutes les autres instructions d'autorisation de la stratégie par défaut sans modification.RemarqueOSS prend en charge les tags de bucket au format clé-valeur. Ajoutez le tag
Key: ProductetValue: PaiLangStudioà tout bucket auquel vous souhaitez que LangStudio accède. Pour plus de détails, consultez la section Gérer les tags de bucket.{ "Version": "1", "Statement": [ { "Action": [ "oss:GetObject", "oss:PutObject", "oss:DeleteObject", "oss:ListObjects" ], "Resource": "*", "Effect": "Allow", "Condition": { "StringEquals": { "oss:BucketTag/Product": "PaiLangStudio" } } } ] } Nommez la nouvelle stratégie
CustomAliyunPAILangStudioDefaultRolePolicy.Attachez la stratégie
CustomAliyunPAILangStudioDefaultRolePolicyau rôleAliyunPAILangStudioDefaultRoleet détachez-en la stratégieAliyunPAILangStudioDefaultRolePolicy. Pour plus de détails, consultez les sections Accorder des autorisations à un rôle RAM et Révoquer des autorisations d'un rôle RAM.
Après la mise à jour, LangStudio accède aux ressources en fonction de la stratégie modifiée.
Référence : Vérifier que le rôle de service est attribué
Pour confirmer que le rôle AliyunPAILangStudioDefaultRole est attribué à votre compte Alibaba Cloud :
Seuls les comptes Alibaba Cloud peuvent attribuer ce rôle de service. Les utilisateurs RAM ne le peuvent pas.
Connectez-vous à la console RAM. Dans le volet de navigation de gauche, choisissez Identities > Roles.
-
Sur la page Roles, recherchez AliyunPAILangStudioDefaultRole.
Si le rôle apparaît dans les résultats, il est déjà attribué à votre compte.
S'il n'apparaît pas, suivez les étapes de la section Autoriser LangStudio pour la première fois pour l'attribuer.