> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dify.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 新しい Agent API

> ストリーミングチャットメッセージ、会話管理、ファイルアップロード、アプリ設定を扱う新しい Agent アプリ向けの API

> このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、[英語版](/en/api-reference/guides/agent) を参照してください。

<Info>
  * 新しい Agent は、[ChatbotとAgent](/ja/api-reference/guides/chat) で扱う Agent アプリ（`agent-chat`）とは別のアプリタイプです。
  * 新しい Agent は現在ベータ版で、Dify [1.16.0-rc1](https://github.com/langgenius/dify/releases) で利用できます。
</Info>

[新しい Agent アプリ](/ja/self-host/use-dify/build/new-agent/overview) は `agent` モードで動作します。メッセージを送信し、生成中の回答をストリーミングで受け取り、会話でマルチターンの文脈を保持します。

モデルは自律的に推論しツールを呼び出し、その過程もストリームに現れます。回答テキストは `agent_message` イベントとして順次届き、各推論ステップとツール呼び出しは `agent_thought` イベントとして並行して届きます。

ターンの最後には、完全な回答を含む `message` イベントが 1 つ届き、続いて `message_end` が届きます。ライブ表示には `agent_message` の差分を使い、最後の `message` は追加のテキストではなく最終回答として扱ってください。

各 `agent_thought` イベントには、そのステップの `thought`、呼び出した `tool` とその `tool_input`、ツールの `observation` が含まれます。ストリーム全体の構造は [チャットメッセージを送信](/ja/api-reference/chat-messages/send-chat-message) を参照してください。

<Info>
  認証、ベース URL、エンドユーザーごとにデータを区分する `user` フィールドについては、[クイックスタート](/ja/api-reference/guides/get-started) と [エンドユーザーの識別](/ja/api-reference/guides/end-user-identity) を参照してください。
</Info>

## メッセージの送信とストリーミング返信

* **[チャットメッセージを送信](/ja/api-reference/chat-messages/send-chat-message)**：新しい Agent アプリに質問を送信します。ストリーミングモードのみに対応し、ブロッキングモードを指定すると 400 `bad_request` が返されます。

  最後の `message_end` イベントは token 使用量を報告します。ナレッジ検索の引用（`retriever_resources`）は含まれません。

* **[生成を停止](/ja/api-reference/chat-messages/stop-chat-message-generation)**：ストリーミング中の返信を完了前に中断します。

## 会話の管理

* **[会話一覧を取得](/ja/api-reference/conversations/list-conversations)**：現在のユーザーの会話を、最終アクティビティの新しい順に返します。
* **[会話履歴メッセージ一覧を取得](/ja/api-reference/conversations/list-conversation-messages)**：1 つの会話のメッセージ履歴を返します。スクロール表示のチャット UI に適しています。各メッセージの `agent_thoughts` 配列には、そのターンの推論ステップが含まれます。

## ファイルのアップロード

* **[ファイルをアップロード](/ja/api-reference/files/upload-file)**：画像、ドキュメント、音声、動画ファイルをアップロードします。ファイルはアップロードしたエンドユーザーのみが利用できます。

  [チャットメッセージを送信](/ja/api-reference/chat-messages/send-chat-message) に渡したファイルは、ダウンロード可能な参照として Agent に渡され、Agent はサンドボックス内で取得して確認できます。

## アプリ情報と設定の取得

* **[アプリケーションの基本情報を取得](/ja/api-reference/applications/get-app-info)**：アプリの名前、説明、タグ、モードを返します。
* **[アプリケーションのパラメータ情報を取得](/ja/api-reference/applications/get-app-parameters)**：呼び出し時に `inputs` で送るフィールド（名前、型、デフォルト値）と、アプリの機能スイッチを返します。リクエストやクライアント UI を構築する際の基礎になります。
* **[アプリケーションのメタ情報を取得](/ja/api-reference/applications/get-app-meta)**：アプリの設定メタデータを返します。新しい Agent アプリでは `tool_icons` は空です。