クイックスタート

コマンドラインから最初の Dify アプリを 5 分以内で実行する

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

始める前に、difyctl が インストール されていることを確認してください。

ステップ 1：サインイン

1. Dify ホストにサインインします。

   Dify Cloud の場合は https://cloud.dify.ai を、セルフホスト環境では コンソール API URL を使用します。

   difyctl auth login --host https://cloud.dify.ai
   

   difyctl がワンタイムコードと検証 URL を表示し、待機状態になります。

   ! Copy this one-time code: WDJP-XKLM
     Open: https://cloud.dify.ai/device
   

2. ブラウザでその URL を開き、コードを入力してサインインします。ターミナルに戻ると、次のように表示されます。

   ✓ Logged in to cloud.dify.ai as <your-email> (<your-name>)
     Workspace: <your-workspace>
   

ステップ 2：アプリの確認

ワークスペース内のアプリを一覧表示します。

difyctl get app

次のような出力が表示されます。

NAME          ID                                    MODE      UPDATED
Customer FAQ  0a1b2c3d-4e5f-6789-abcd-ef0123456789  chat      2026-06-08T03:14:27.521839
Daily Report  7f3e9a2b-1c4d-4e8f-9a0b-2d5c8e1f4a7b  workflow  2026-06-05T22:41:09.812016

実行したいアプリの ID をコピーします。以下の例では、この表の 2 つの ID を使用します。

ステップ 3：アプリの実行

入力の渡し方はアプリの種類によって異なります。

チャットボット / チャットフロー / Agent / テキストジェネレーター

メッセージを位置引数として渡します。

difyctl run app 0a1b2c3d-4e5f-6789-abcd-ef0123456789 "What are your business hours?"

応答は stdout に出力されます。チャットボット、チャットフロー、Agent アプリの場合は、同じ会話を後で続けられるように、ヒントが stderr にも出力されます。

Our business hours are Monday through Friday, 9am to 6pm PT.

hint: continue this conversation with --conversation 4f7d8c2a-9b1e-4c6d-8a3f-5e2b7c9d0a1f

ワークフロー

--inputs で入力を単一の JSON オブジェクトとして渡します。

difyctl run app 7f3e9a2b-1c4d-4e8f-9a0b-2d5c8e1f4a7b --inputs '{"topic":"quarterly report","audience":"executives"}'

ワークフローの出力は JSON として stdout に出力されます。

{"summary":"Q3 revenue grew 14% YoY...","sections":["revenue","costs","outlook"]}

次のステップ

• すぐにコピーして使える日常的なコマンド：よくあるタスク
• token の保存場所とセッションの仕組み：認証
• difyctl でできるその他すべて：コマンド一覧