このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。
- 新しい Agent は、ChatbotとAgent で扱う Agent アプリ（
agent-chat）とは別のアプリタイプです。 - 新しい Agent は現在ベータ版で、Dify 1.16.0-rc1 で利用できます。
agent モードで動作します。メッセージを送信し、生成中の回答をストリーミングで受け取り、会話でマルチターンの文脈を保持します。
モデルは自律的に推論しツールを呼び出し、その過程もストリームに現れます。回答テキストは agent_message イベントとして順次届き、各推論ステップとツール呼び出しは agent_thought イベントとして並行して届きます。
ターンの最後には、完全な回答を含む message イベントが 1 つ届き、続いて message_end が届きます。ライブ表示には agent_message の差分を使い、最後の message は追加のテキストではなく最終回答として扱ってください。
各 agent_thought イベントには、そのステップの thought、呼び出した tool とその tool_input、ツールの observation が含まれます。ストリーム全体の構造は チャットメッセージを送信 を参照してください。
認証、ベース URL、エンドユーザーごとにデータを区分する
user フィールドについては、クイックスタート と エンドユーザーの識別 を参照してください。メッセージの送信とストリーミング返信
-
チャットメッセージを送信：新しい Agent アプリに質問を送信します。ストリーミングモードのみに対応し、ブロッキングモードを指定すると 400
bad_requestが返されます。 最後のmessage_endイベントは token 使用量を報告します。ナレッジ検索の引用（retriever_resources）は含まれません。 - 生成を停止：ストリーミング中の返信を完了前に中断します。
会話の管理
- 会話一覧を取得：現在のユーザーの会話を、最終アクティビティの新しい順に返します。
- 会話履歴メッセージ一覧を取得：1 つの会話のメッセージ履歴を返します。スクロール表示のチャット UI に適しています。各メッセージの
agent_thoughts配列には、そのターンの推論ステップが含まれます。
ファイルのアップロード
- ファイルをアップロード：画像、ドキュメント、音声、動画ファイルをアップロードします。ファイルはアップロードしたエンドユーザーのみが利用できます。 チャットメッセージを送信 に渡したファイルは、ダウンロード可能な参照として Agent に渡され、Agent はサンドボックス内で取得して確認できます。
アプリ情報と設定の取得
- アプリケーションの基本情報を取得：アプリの名前、説明、タグ、モードを返します。
- アプリケーションのパラメータ情報を取得：呼び出し時に
inputsで送るフィールド（名前、型、デフォルト値）と、アプリの機能スイッチを返します。リクエストやクライアント UI を構築する際の基礎になります。 - アプリケーションのメタ情報を取得：アプリの設定メタデータを返します。新しい Agent アプリでは
tool_iconsは空です。