Skip to main content
このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。
個人アクセストークンは Dify 1.20.0 以降で利用できます。
個人アクセストークンを使うと、difyctl はサインインなしで、あなたのアカウントとして動作します。サインインとは、有効な期間と実行できる操作が異なります: アプリの実行や統合のセットアップを行う CI ジョブやコーディングエージェントには、トークンを渡してください。誰もサインインを更新しなくても、動作し続けます。 DSL ファイルからのアプリの更新や公開など、アプリを変更する作業では、代わりにサインインを使います。ジョブには サインインで得たトークン を渡し、コーディングエージェントには 自分のサインイン をそのまま使わせてください。

アカウントとアクセス範囲の選択

個人アクセストークンは、ジョブごとに用意します。そうすれば、ほかのジョブに影響を与えずに、トークンを変更、置き換え、削除できます。 チームの業務に欠かせないジョブには、自動化専用のアカウントでトークンを作成します。こうしておくと、自分のアクセス権が変わってもジョブは動き続け、ジョブの実行も自分の実行と見分けやすくなります。このアカウントは、ジョブが作業する各ワークスペースに追加し、ジョブのコマンドに必要なロールを割り当てます。 アカウントページ でトークンを作成する際は、ジョブに必要なアクセス範囲だけを与えます。アクセス範囲は後から編集できます。変更は、そのトークンで次に実行するコマンドから適用されます。ジョブに新しいトークンを渡す必要はありません。
以下の各コマンドを実行するには、ロールやアプリのサービス API アクセスなど、コマンド索引 に記載された条件も満たす必要があります。

トークンにアプリの実行を許可

次のいずれかを行うジョブには、リソース のアクセス範囲を使います:

トークンに統合のセットアップを許可

次のいずれかを行うジョブには、ワークスペースの管理 のアクセス範囲を使います:

difyctl へのトークンの受け渡し

1

ワークスペース ID の確認

アプリを一覧表示するジョブや統合をセットアップするジョブには、作業する各ワークスペースの ID が必要です。ID を確認するには、difyctl get workspace を実行し、各ワークスペースの id をコピーします。コーディングエージェントは、ID を自分で確認できます。
2

環境変数の設定

  • DIFY_SERVER:ブラウザで Dify を開く際のアドレス(https://dify.example.com など)
  • DIFY_TOKEN:トークン
  • DIFY_WORKSPACE_ID:ワークスペース ID(前の手順で確認した場合) ジョブが複数のワークスペースで作業する場合は、代わりにコマンドごとに --workspace-id でそのワークスペースの ID を指定します。
設定方法は、difyctl の実行元によって異なります:
  • CI ジョブ:ジョブに difyctl をインストール し、トークンを CI システムのシークレットとして保存します。そのシークレットから DIFY_TOKEN を設定します。
  • コーディングエージェント:エージェントを起動するシェルなど、エージェントの起動元で変数を設定します。 トークンはチャットに入力しないでください。チャットに入力した内容は、すべてエージェントのモデルを経由します。
DIFY_TOKEN を設定している間、コマンドは保存済みのサインイン情報の代わりにこれらの変数を使います。
3

トークンの確認

これらの変数を設定したシェルで、ジョブが使うアプリやワークスペースにトークンでアクセスできることを確認します:
  • トークンでアプリを実行できる場合は、ジョブが使うアプリの ID を指定して、そのアプリの情報を表示します:
    アプリの ID は、スタジオで開いたアプリのアドレス(/app/<app-id>/…)からコピーできます。DIFY_WORKSPACE_ID を設定している場合は、difyctl get console_app で一覧表示することもできます。
  • トークンがワークスペースの管理しか許可されていない場合は、difyctl describe account を実行します。トークンで管理できるワークスペースが一覧表示されるので、ジョブのワークスペースが含まれていることを確認します。
確認に失敗した場合は、トラブルシューティング でそのメッセージを探してください。

トラブルシューティング

そのほかのエラーについては、「結果、エラー、終了コード」の トラブルシューティング を参照してください。
Last modified on November 18, 2026