Skip to main content

このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。

Info

Dify 1.18.0 より前から difyctl を使っていた場合、サーバーが 1.18.0 以降になると、古いビルドは動作しなくなります。コマンドとサインイン方法が変わっているため、Dify 1.18.0 へのアップグレード から始めてください。

Tip

このセットアップをコーディングエージェントに任せるには、このページをエージェントに渡してください。その場合も、サインインはブラウザから自分で承認します。

前提条件#

Dify Cloud の場合は、そのままインストールに進めます。

セルフホストのサーバーの場合は、次の点を確認してください：

インストール#

Info

brew install dify でインストールされるのは、difyctl ではなく Dify のプラグイン開発用 CLI です。

インストーラーの実行

x64 と arm64 をサポートしています。

このコマンドは、Dify の最新リリースのビルドをインストールします。セルフホストのサーバーが最新リリースでない場合は、DIFY_VERSION にサーバーのバージョンを指定します：

スクリプトはダウンロードしたファイルのチェックサムを検証し、~/.local/bin/difyctl にインストールします。

Tip

別のフォルダにインストールする場合や、その他のインストール設定を変更する場合は、設定 を参照してください。

インストールの確認

command not found が表示される場合は、インストールディレクトリが PATH に含まれていません。次のように追加します：

サインイン#

サインインの開始

ブラウザで Dify を開く際のアドレスを指定します（Dify Cloud の場合は https://cloud.dify.ai）：

SSH 経由での実行時などブラウザが開かない場合は、difyctl が表示した URL を任意のデバイスで開いてください。

ローカルサーバーが http:// や自己署名証明書を使っている場合は、--insecure を追加します。この設定は、--insecure なしでサインインし直すまで、以降のすべてのコマンドに適用されます。ローカル開発以外では使わないでください。

ブラウザでの承認

difyctl を認証 ページで difyctl が表示したコードを入力し、続ける をクリックします。コードの有効期限は 15 分です。

ページにアカウントとワークスペースが表示されたら、どちらも正しいことを確認してから 認証する をクリックします。difyctl とコーディングエージェントは、このアカウントとして動作します。このアカウントでできることは、すべて実行できます。意図しないアカウントの場合は、キャンセル をクリックし、正しいアカウントで Dify にサインインしてから、もう一度サインインを開始します。

difyctl は、ページに表示されたワークスペースで動作します。別のワークスペースを使う場合は、サインイン後に difyctl のワークスペースを切り替えます。

後でサインインし直す場合やサインアウトする場合は、サインインの管理 を参照してください。サインインに失敗した場合は、トラブルシューティング を参照してください。

アプリの一覧表示#

サインインしたワークスペース内のアプリを一覧表示して、difyctl が動作することを確認します：

一覧に表示されるのは、サービス API アクセスがオンになっているアプリだけです。

コーディングエージェントのセットアップ#

difyctl スキルは、コーディングエージェントに difyctl の使い方を教えます。使用するコーディングエージェントごとに、そのエージェントのスキルフォルダにスキルをインストールします：

その他のエージェントの場合は、スキルフォルダの場所をそのエージェントのドキュメントで確認してください。エージェントがスキルを認識しない場合は、再起動してください。

コマンドと API キーの管理#

シェルコマンドの実行前に承認を求めるエージェント側の設定は、オンのままにしておいてください。difyctl 自体は、コマンドを実行する前に確認を求めません。スキルは、削除、統合のインストール、アプリの公開を行う前にあなたに確認するよう、エージェントに指示しています。ただし、実際に確認するかどうかは、エージェントが使う AI モデル次第です。

Tip

エージェントに確認なしで情報を調べさせるには、difyctl get、difyctl describe、difyctl knowledge_fs Cloud を許可します。いずれもサーバーからの読み取りしか行いません。

モデルプロバイダーの API キーなど、チャットに入力した内容はすべてエージェントのモデルを経由します。キーをモデルに渡したくない場合は、事前に自分で Dify にキーを追加しておくか、求められた時点で自分で追加するとエージェントに伝えてください。

自分でコマンドを探す方法#

作業内容を短い言葉で help に伝えると、一致するコマンドが一覧表示されます。たとえば、アプリを公開するコマンドを探すには、次のように実行します：

一覧から探す場合は、difyctl help を実行します。コマンドへの値の渡し方や、結果に含まれるヒントに従う方法については、コマンドの検索と実行 を参照してください。

次のステップ#

次の作業は、エージェントに依頼することも、自分で行うこともできます：

トラブルシューティング#

メッセージ対処方法
only https:// hosts are acceptedhttps:// のアドレスを使う。ローカルの http:// サーバーでは、--insecure を追加する。
network error calling POST <server>/openapi/v1/oauth/device/codeサーバーのアドレスとネットワークを確認する。

サーバーの証明書を difyctl が検証できない場合も、同じエラーで失敗する。自己署名証明書を使うローカルサーバーでは、--insecure を追加する。
this Dify host does not implement the OAuth device flowサーバーのアドレスを確認する。Dify Cloud では https://cloud.dify.ai を使う。

セルフホストのサーバーでアドレスが正しい場合は、OPENAPI_ENABLED が true に設定されていることを確認する。
ブラウザ：こちら側で問題が発生しました。しばらくしてからもう一度お試しください。セルフホストのサーバーでは、ENABLE_OAUTH_BEARER が true に設定されていることを確認する。
authorization deniedブラウザで キャンセル がクリックされた。もう一度 login を実行する。
code expired before authorization15 分以内にコードが承認されなかった。もう一度 login を実行する。
OS keychain is unreachable--no-keyring を付けてサインインし直し、トークンをファイルに保存する。