API を介して Alibaba Cloud Model Studio のアプリケーション (例: エージェント や ワークフロー) を呼び出すには、リクエストにアプリケーション ID を含めます。アプリケーションが サブワークスペース にある場合は、ワークスペース ID も含めてください。
| ワークスペースタイプ | 必要な認証情報 |
|---|---|
| デフォルトワークスペース | アプリケーション ID |
| サブワークスペース | アプリケーション ID + ワークスペース ID |
アプリケーション ID とワークスペース ID は、API や CLI ではなく、コンソールからのみ取得できます。
前提条件
Model Studio コンソール にアクセスできる Alibaba Cloud アカウント
アプリケーション ID の取得
My Applications ページに移動します。
対象のアプリケーションを見つけて、その Application ID をコピーします。
アプリケーションが [デフォルトワークスペース] にある場合は、必要なものがすべて揃っています。「次に実行する操作」にスキップします。
ワークスペース ID の取得
ワークスペース ID は、サブワークスペース 内のアプリケーションを呼び出す場合にのみ必要です。ご利用のロールに基づいて、以下のいずれかの方法を選択してください。
現在のワークスペース
現在作業しているワークスペースの ID を見つけるには:
コンソール ホームページ (シンガポール | 中国 (北京) | 米国 (バージニア)) に移動します。
左下隅の
アイコンをクリックし、次に ワークスペースの詳細情報 をクリックします。ダイアログボックスから Workspace ID をコピーします。
デフォルトでは、RAM ユーザーは参加しているワークスペースの ID のみを表示できます。
すべてのワークスペース
Alibaba Cloud アカウント配下のすべてのワークスペースを照会または管理するには、ワークスペース管理ページを使用します。スーパー管理者 のみがこのページにアクセスできます。
Alibaba Cloud アカウント または 認可された RAM ユーザー で Model Studio コンソールにログインします。
右上隅の
アイコンをクリックして、ワークスペース管理ページ (シンガポール | 中国 (北京) | 米国 (バージニア)) を開きます。Workspace ID 列で、対象のワークスペースの ID をコピーします。
この操作には、AliyunBailianFullAccess または AliyunBailianControlFullAccess 権限を持つ Alibaba Cloud アカウントまたは RAM ユーザーが必要です。これらの権限がない場合、「権限不足」エラーが発生します。詳細については、「権限管理」をご参照ください。
次のステップ
アプリケーション ID (および該当する場合はワークスペース ID) を取得したら、「DashScope API リファレンス」をご参照ください。ワークスペースと権限の詳細については、「ワークスペース権限管理」をご参照ください。
よくある質問
Q: RAM ユーザーとしてワークスペース管理ページにアクセスするとエラーが発生するのはなぜですか？
A: RAM ユーザーは スーパー管理者 ロールを持っている必要があります。設定手順については、「ワークスペース権限管理」をご参照ください。
Q: アプリケーション ID とワークスペース ID をコードにハードコードすべきですか？
A: いいえ。認証情報は環境変数またはシークレットマネージャーに保存してください。これにより、バージョン管理での偶発的な漏洩を防ぎ、環境間での認証情報のローテーションを簡素化できます。