ServerでAIツールを使用する
サービスプリンシパルを使用してServer 2026.1でAIツールを設定し、実行します。このガイドを使用して、Alteryx Oneでサービスプリンシパルを作成し、AIツールを接続します。Alteryx Oneのサービスプリンシパルの詳細については、サービスプリンシパルのページを参照してください。
要件
ワークスペース管理者は、サービスプリンシパルを作成および管理する必要があります。
AIツールを使用するには、フルユーザーまたは生成AIツールの権限を持つカスタムロールが必要です。
ServerのAMPを有効にする必要があります。管理者は、システム設定からAMPを有効にする必要があります。AMPとServerの詳細については、AMP Engineを参照してください。
初回セットアップ
AIツールがAlteryx OneのLLM接続に接続できるようにするには、以下の手順を1回実行します。
Alteryx Oneでサービスプリンシパルを作成する
注記
この手順を完了するには、ワークスペース管理者である必要があります。
Alteryx Oneで、プロファイルメニューを開きます。
[ワークスペース管理者] > [サービスプリンシパル]に移動します。
[新規]を選択します。
値を入力:
名前: 一意の名前を入力します。
説明: 説明を入力します。
シークレットの有効期間(日): 1から365までの値を入力します。
[ロール]で、フルユーザーロールまたは生成AIツールの権限を持つカスタムロールを選択します。
[作成]を選択します。
サービスプリンシパルを作成したら、以下の手順を実行します。
[クライアントID]をコピーします。
[クライアントシークレット]をコピーします。
これらの値を安全に保存します。
Alteryx OneでLLM接続を共有する
[データ]に移動します。
[接続]を選択します。
LLM接続を見つけます。
三点リーダーメニュー(⋮)を選択し、次に[共有]を選択します。
[ユーザーまたはサービスプリンシパルを選択]から、サービスプリンシパルを選択します。
[ロール]ドロップダウンで、[編集者] (または必要なロール)を選択します。
資格情報の共有を[資格情報の共有]に設定します。
[共有]を選択します。
DesignerでプロンプトツールまたはLLM上書き設定ツールを設定する
サービスプリンシパル接続を選択
Designerで、ワークフローを開きます。
プロンプトツールを選択します。
[接続オプション]セクションで、[サービスプリンシパル(Server用)]を選択します。
接続の作成
[新しい接続の作成]を選択します。
データ接続マネージャー(DCM)で、[+新規]を選択します。
[テクノロジーの選択]ドロップダウンから、[Alteryx One OAuthアプリケーション]を選択します。
資格情報を入力する
注記
これらの資格情報を入力するには、サービスプリンシパルのクライアントIDとクライアントシークレットにアクセスできる必要があります。サービスプリンシパルを作成していない場合は、ワークスペース管理者にこれらの値を入力してもらいます。
[データソース名]に名前を入力します。
[クライアントID]に、サービスプリンシパルのクライアントIDを入力します。
[クライアントシークレット]に、サービスプリンシパルのクライアントシークレットを入力します。
[保存]を選択します。
Serverへのワークフローの公開
サービスプリンシパル接続を設定したら、ワークフローをServerに公開します。
ワークフローは、サービスプリンシパルを使用してServerで実行されます。AIツールは共有LLM接続を使用し、ユーザー認証を必要とせずに実行されます。
サービスプリンシパルシークレットのローテーション
サービスプリンシパルのクライアントシークレットは1年で有効期限が切れます。シークレットの有効期限が切れたら、データ接続マネージャーで、サービスプリンシパル接続を新しいクライアントシークレットで更新します。シークレットローテーションの詳細については、サービスプリンシパルのページを参照してください。
注記
サービスプリンシパルを作成していない場合は、ワークスペース管理者に新しいクライアントシークレットの発行を依頼します。
新しいクライアントシークレットの生成
Alteryx Oneから、[ワークスペース管理者] > [サービスプリンシパル]に移動します。
[サービスプリンシパル]ページで、サービスプリンシパルを選択して詳細ページを開きます。
[シークレットの生成]を選択します。
新しいシークレットをコピーして安全に保存します。
Designer Desktopの接続を更新する
Designer Desktopで、[ファイル] > [接続を管理]を選択します。
[接続]ページで、サービスプリンシパル接続を選択します。
[編集]を選択します。
クライアントシークレットを入力し、[保存]を選択します。
ワークフローで接続を使用する前に、接続を確認して想定どおりに機能することを確認してください。