Berikan izin untuk LangStudio - Platform For AI - Alibaba Cloud Documentation Center

Sebelum menggunakan LangStudio di Platform for AI (PAI), Anda harus menyelesaikan dua langkah: mengotorisasi LangStudio untuk mengakses layanan cloud yang menjadi dependensinya dan memberikan izin yang sesuai kepada akun operasi Anda.

Catatan

Karena penyesuaian strategi produk, PAI-LangStudio akan dihentikan pada 9 Maret 2027 pukul 16.00. Setelah tanggal tersebut, Anda tidak akan dapat lagi menggunakan fitur LangStudio di Konsol PAI, dan semua layanan pendukung terkait juga akan dihentikan. Untuk informasi lebih lanjut, lihat Panduan penghentian dan migrasi PAI-LangStudio.

Persiapan minimum yang diperlukan

Jika Anda menyiapkan LangStudio untuk pertama kalinya, selesaikan langkah-langkah berikut secara berurutan:

Aktifkan layanan dependensi — LangStudio bergantung pada Object Storage Service (OSS), Simple Log Service (SLS), Managed Service for OpenTelemetry, dan Elastic Algorithm Service (EAS) dari PAI. Aktifkan layanan-layanan ini dari Konsol PAI saat diminta.
Otorisasi peran layanan LangStudio — Di Konsol PAI, klik Authorize pada halaman Quick Authorization untuk menetapkan peran layanan AliyunPAILangStudioDefaultRole ke Akun Alibaba Cloud Anda. Sistem menangani proses ini secara otomatis; tidak diperlukan konfigurasi peran manual.
Berikan izin akun operasi — Jika Anda menggunakan RAM user untuk mengelola LangStudio, tetapkan peran anggota ruang kerja yang sesuai di PAI. Jika Anda menggunakan Akun Alibaba Cloud secara langsung, tidak diperlukan izin tambahan.

Untuk prosedur otorisasi lengkap, lihat Otorisasi LangStudio untuk pertama kalinya.

Layanan cloud dependensi

LangStudio terintegrasi dengan layanan cloud berikut. Setiap layanan harus diaktifkan sebelum Anda dapat menggunakan fitur LangStudio yang sesuai. Jika Anda mengaktifkan layanan menggunakan RAM user, sambungkan kebijakan RAM yang diperlukan ke pengguna tersebut terlebih dahulu.

Modul PAI — LangStudio

Akun operasi	Detail	Referensi
Akun Alibaba Cloud	Tidak diperlukan otorisasi tambahan.	N/A
RAM user (disarankan)	PAI menyediakan peran anggota ruang kerja dengan cakupan izin berbeda. Tetapkan peran anggota yang sesuai untuk setiap RAM user.	Kelola anggota ruang kerja

Untuk daftar lengkap izin peran anggota, lihat Daftar peran dan izin — LangStudio.

Object Storage Service (OSS)

OSS menyimpan file kode dan konfigurasi, log pengembangan dan debugging, serta file snapshot layanan yang dihasilkan saat Anda menerapkan alur aplikasi.

Skenario	Detail	Referensi
Aktifkan OSS	Gunakan Akun Alibaba Cloud — tidak diperlukan otorisasi tambahan. Untuk mengaktifkan dengan RAM user, sambungkan AliyunOSSFullAccess ke RAM user tersebut.	Console quick start / RAM policy overview
Gunakan OSS	OSS mendukung kebijakan RAM detail halus. Buat bucket untuk menyimpan objek yang digunakan oleh LangStudio.	Console quick start

Managed Service for OpenTelemetry

Managed Service for OpenTelemetry menyediakan analisis jejak saat Anda mengembangkan dan menerapkan alur aplikasi LLM.

Skenario	Detail	Referensi
Aktifkan Managed Service for OpenTelemetry	Gunakan Akun Alibaba Cloud — tidak diperlukan otorisasi tambahan. Untuk mengaktifkan dengan RAM user, sambungkan AliyunARMSFullAccess ke RAM user tersebut.	Quick start / Gunakan RAM user untuk mengelola izin
Lihat analisis jejak	Lihat log jejak dari Konsol LangStudio atau Konsol Managed Service for OpenTelemetry.	—

Simple Log Service (SLS)

SLS merupakan dependensi tidak langsung — layanan ini menyimpan data log untuk Managed Service for OpenTelemetry.

Skenario	Detail	Referensi
Aktifkan Simple Log Service	Gunakan Akun Alibaba Cloud — tidak diperlukan otorisasi tambahan. Untuk mengaktifkan dengan RAM user, sambungkan AliyunLogFullAccess ke RAM user tersebut.	Storage resource hierarchy / Buat dan otorisasi RAM user

Virtual Private Cloud (VPC)

Saat penerapan alur aplikasi, LangStudio meminta konfigurasi VPC Anda untuk menerapkan Elastic Algorithm Service (EAS) secara tepat.

Skenario	Detail	Referensi
Aktifkan VPC	Gunakan Akun Alibaba Cloud — tidak diperlukan otorisasi tambahan. Untuk mengaktifkan dengan RAM user, sambungkan AliyunVPCFullAccess ke RAM user tersebut.	Buat dan kelola VPC / Gunakan RAM untuk kontrol akses

PAI

Akses ruang kerja PAI diperlukan untuk menggunakan modul LangStudio.

Skenario	Detail	Referensi
Aktifkan PAI	Gunakan Akun Alibaba Cloud — tidak diperlukan otorisasi tambahan. Untuk mengaktifkan dengan RAM user, sambungkan AliyunPAIFullAccess ke RAM user tersebut.	Aktifkan PAI dan buat ruang kerja default / Masuk sebagai peran RAM dan gunakan PAI

DataWorks

DataWorks diperlukan untuk pembaruan basis pengetahuan terjadwal. Aktifkan hanya jika Anda menggunakan fitur ini.

Skenario	Detail	Referensi
Aktifkan DataWorks	Gunakan Akun Alibaba Cloud — tidak diperlukan otorisasi tambahan. Untuk mengaktifkan dengan RAM user, sambungkan AliyunDataWorksFullAccess ke RAM user tersebut.	Best practices for managing RAM user permissions

Otorisasi LangStudio untuk pertama kalinya

Pertama kali Anda mengakses LangStudio, selesaikan langkah-langkah berikut untuk mengotorisasi peran layanan dan mengaktifkan layanan dependensi.

Catatan

Hanya Akun Alibaba Cloud yang dapat mengotorisasi peran layanan AliyunPAILangStudioDefaultRole. RAM user tidak dapat melakukan langkah ini.

Masuk ke Konsol PAI. Di panel kanan, pilih ruang kerja Anda dan klik Enter LangStudio.
Klik Authorize.
Di halaman Quick Authorization, klik Confirm Authorization dan selesaikan verifikasi keamanan. Sistem secara otomatis menetapkan peran layanan AliyunPAILangStudioDefaultRole ke akun Anda.
Klik Activate For Free untuk mengaktifkan OSS, Simple Log Service, dan Managed Service for OpenTelemetry.

Referensi: Sesuaikan kebijakan peran layanan LangStudio

Penting

Pastikan Anda memahami kebijakan RAM sebelum memodifikasi izin peran layanan. Perubahan yang salah dapat menyebabkan LangStudio tidak tersedia.

Secara default, LangStudio menggunakan peran layanan AliyunPAILangStudioDefaultRole dengan kebijakan AliyunPAILangStudioDefaultRolePolicy. Jika Anda memerlukan kontrol lebih detail atas akses sumber daya cloud, ganti kebijakan default dengan kebijakan kustom.

Lihat kebijakan default

Masuk ke Konsol RAM. Di panel navigasi kiri, pilih Identities > Roles.
Cari AliyunPAILangStudioDefaultRole dan klik nama peran tersebut.
Di tab Permissions, klik nama kebijakan untuk melihat dan menyalin konten kebijakan default.

Kebijakan default memberikan izin berikut:

{
  "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"
    }
  ]
}

Buat kebijakan kustom

Buat kebijakan kustom menggunakan editor skrip. Contoh berikut membatasi akses OSS hanya ke bucket yang memiliki tag Product: PaiLangStudio, menggunakan elemen Condition dalam RAM. Pertahankan semua pernyataan izin lain dari kebijakan default tanpa perubahan.
Catatan
OSS mendukung tag bucket dalam format pasangan kunci-nilai. Tambahkan tag Key: Product dan Value: PaiLangStudio ke bucket mana pun yang ingin diakses oleh LangStudio. Untuk detailnya, lihat Kelola tag bucket.
```
{
    "Version": "1",
    "Statement": [
        {
            "Action": [
                "oss:GetObject",
                "oss:PutObject",
                "oss:DeleteObject",
                "oss:ListObjects"
            ],
            "Resource": "*",
            "Effect": "Allow",
            "Condition": {
                "StringEquals": {
                    "oss:BucketTag/Product": "PaiLangStudio"
                }
            }
        }
    ]
}
```
Beri nama kebijakan baru tersebut CustomAliyunPAILangStudioDefaultRolePolicy.
Sambungkan CustomAliyunPAILangStudioDefaultRolePolicy ke peran AliyunPAILangStudioDefaultRole dan lepaskan AliyunPAILangStudioDefaultRolePolicy darinya. Untuk detailnya, lihat Berikan izin kepada peran RAM dan Cabut izin dari peran RAM.

Setelah pembaruan, LangStudio mengakses sumber daya berdasarkan kebijakan yang telah dimodifikasi.

Referensi: Verifikasi bahwa peran layanan telah ditetapkan

Untuk memastikan bahwa AliyunPAILangStudioDefaultRole telah ditetapkan ke Akun Alibaba Cloud Anda:

Catatan

Hanya Akun Alibaba Cloud yang dapat menetapkan peran layanan ini. RAM user tidak dapat.

Masuk ke Konsol RAM. Di panel navigasi kiri, pilih Identities > Roles.
Di halaman Roles, cari AliyunPAILangStudioDefaultRole.
- Jika peran tersebut muncul dalam hasil pencarian, artinya peran tersebut sudah ditetapkan ke akun Anda.
- Jika tidak muncul, ikuti langkah-langkah di Otorisasi LangStudio untuk pertama kalinya untuk menetapkannya.