### リクエストボディ

<Properties>
  <Property name='query' type='string' key='query'>
    ユーザー入力/質問内容
  </Property>
  <Property name='inputs' type='object' key='inputs'>
      アプリで定義されたさまざまな変数値の入力を許可します。
      `inputs`パラメータには複数のキー/値ペアが含まれ、各キーは特定の変数に対応し、各値はその変数の特定の値です。デフォルトは`{}`
  </Property>
  <Property name='response_mode' type='string' key='response_mode'>
    応答の返却モードを指定します。サポートされているモード：
    - `streaming` ストリーミングモード（推奨）、SSE（[Server-Sent Events](https://developer.mozilla.org/en-US/docs/Web/API/Server-sent_events/Using_server-sent_events)）を通じてタイプライターのような出力を実装します。
    - `blocking` ブロッキングモード、実行完了後に結果を返します。（プロセスが長い場合、リクエストが中断される可能性があります）
    Cloudflareの制限により、100秒後に応答がない場合、リクエストは中断されます。
    <i>注：エージェントアシスタントモードではブロッキングモードはサポートされていません</i>
  </Property>
  <Property name='user' type='string' key='user'>
      ユーザー識別子、エンドユーザーのアイデンティティを定義するために使用されます。
      アプリケーション内で開発者によって一意に定義される必要があります。
  </Property>
  <Property name='conversation_id' type='string' key='conversation_id'>
  会話ID、以前のチャット記録に基づいて会話を続けるには、前のメッセージのconversation_idを渡す必要があります。
  </Property>
  <Property name='files' type='array[object]' key='files'>
      ファイルリスト、モデルが Vision/Video 機能をサポートしている場合に限り、ファイルをテキスト理解および質問応答に組み合わせて入力するのに適しています。
      - `type` (string) サポートされるタイプ：
        - `document` サポートされるタイプには以下が含まれます：'TXT', 'MD', 'MARKDOWN', 'MDX', 'PDF', 'HTML', 'XLSX', 'XLS', 'VTT', 'PROPERTIES', 'DOC', 'DOCX', 'CSV', 'EML', 'MSG', 'PPTX', 'PPT', 'XML', 'EPUB'
        - `image` サポートされるタイプには以下が含まれます：'JPG', 'JPEG', 'PNG', 'GIF', 'WEBP', 'SVG'
        - `audio` サポートされるタイプには以下が含まれます：'MP3', 'M4A', 'WAV', 'WEBM', 'MPGA'
        - `video` サポートされるタイプには以下が含まれます：'MP4', 'MOV', 'MPEG', 'WEBM'
        - `custom` サポートされるタイプには以下が含まれます：その他のファイルタイプ
      - `transfer_method` (string) 転送方法:
        - `remote_url`: ファイルのURL。
        - `local_file`: ファイルをアップロード。
      - `url` ファイルのURL。（転送方法が `remote_url` の場合のみ）。
      - `upload_file_id` アップロードされたファイルID。（転送方法が `local_file` の場合のみ）。
  </Property>
  <Property name='auto_generate_name' type='bool' key='auto_generate_name'>
  タイトルを自動生成します。デフォルトは`true`です。
  `false`に設定すると、会話のリネームAPIを呼び出し、`auto_generate`を`true`に設定することで非同期タイトル生成を実現できます。
  </Property>
  <Property name='workflow_id' type='string' key='workflow_id'>
  （オプション）ワークフローID、特定のバージョンを指定するために使用、提供されない場合はデフォルトの公開バージョンを使用。

  取得方法：バージョン履歴インターフェースで、各バージョンエントリの右側にあるコピーアイコンをクリックすると、完全なワークフローIDをコピーできます。
  </Property>
  <Property name='trace_id' type='string' key='trace_id'>
    （オプション）トレースID。既存の業務システムのトレースコンポーネントと連携し、エンドツーエンドの分散トレーシングを実現するために使用します。指定がない場合、システムが自動的に trace_id を生成します。以下の3つの方法で渡すことができ、優先順位は次のとおりです：

    - Header：HTTPヘッダー <code>X-Trace-Id</code> で渡す（最優先）。

    - クエリパラメータ：URLクエリパラメータ <code>trace_id</code> で渡す。

    - リクエストボディ：リクエストボディの <code>trace_id</code> フィールドで渡す（本フィールド）。

  </Property>
</Properties>

### 応答
response_modeがブロッキングの場合、CompletionResponseオブジェクトを返します。
response_modeがストリーミングの場合、ChunkCompletionResponseストリームを返します。

### ChatCompletionResponse
完全なアプリ結果を返します。`Content-Type`は`application/json`です。
- `event` (string) イベントタイプ、固定で `message`
- `task_id` (string) タスクID、リクエスト追跡と以下のStop Generate APIに使用
- `id` (string) ユニークID
- `message_id` (string) 一意のメッセージID
- `conversation_id` (string) 会話ID
- `mode` (string) アプリモード、`chat`として固定
- `answer` (string) 完全な応答内容
- `metadata` (object) メタデータ
  - `usage` (Usage) モデル使用情報
  - `retriever_resources` (array[RetrieverResource]) 引用と帰属リスト
- `created_at` (int) メッセージ作成タイムスタンプ、例：1705395332

### ChunkChatCompletionResponse
アプリによって出力されたストリームチャンクを返します。`Content-Type`は`text/event-stream`です。
各ストリーミングチャンクは`data:`で始まり、2つの改行文字`\n\n`で区切られます。以下のように表示されます：
<CodeGroup>
```streaming {{ title: '応答' }}
data: {"event": "message", "task_id": "900bbd43-dc0b-4383-a372-aa6e6c414227", "id": "663c5084-a254-4040-8ad3-51f2a3c1a77c", "answer": "Hi", "created_at": 1705398420}\n\n
```
</CodeGroup>
ストリーミングチャンクの構造は`event`に応じて異なります：
- `event: message` LLMはテキストチャンクイベントを返します。つまり、完全なテキストがチャンク形式で出力されます。
  - `task_id` (string) タスクID、リクエスト追跡と以下のStop Generate APIに使用
  - `message_id` (string) 一意のメッセージID
  - `conversation_id` (string) 会話ID
  - `answer` (string) LLMが返したテキストチャンク内容
  - `created_at` (int) 作成タイムスタンプ、例：1705395332
- `event: agent_message` LLMはテキストチャンクイベントを返します。つまり、エージェントアシスタントが有効な場合、完全なテキストがチャンク形式で出力されます（エージェントモードでのみサポート）
  - `task_id` (string) タスクID、リクエスト追跡と以下のStop Generate APIに使用
  - `message_id` (string) 一意のメッセージID
  - `conversation_id` (string) 会話ID
  - `answer` (string) LLMが返したテキストチャンク内容
  - `created_at` (int) 作成タイムスタンプ、例：1705395332
- `event: tts_message` TTSオーディオストリームイベント、つまり音声合成出力。内容はMp3形式のオーディオブロックで、base64文字列としてエンコードされています。再生時には、base64をデコードしてプレーヤーに入力するだけです。（このメッセージは自動再生が有効な場合にのみ利用可能）
  - `task_id` (string) タスクID、リクエスト追跡と以下の停止応答インターフェースに使用
  - `message_id` (string) 一意のメッセージID
  - `audio` (string) 音声合成後のオーディオ、base64テキストコンテンツとしてエンコードされており、再生時にはbase64をデコードしてプレーヤーに入力するだけです
  - `created_at` (int) 作成タイムスタンプ、例：1705395332
- `event: tts_message_end` TTSオーディオストリーム終了イベント。このイベントを受信すると、オーディオストリームの終了を示します。
  - `task_id` (string) タスクID、リクエスト追跡と以下の停止応答インターフェースに使用
  - `message_id` (string) 一意のメッセージID
  - `audio` (string) 終了イベントにはオーディオがないため、これは空の文字列です
  - `created_at` (int) 作成タイムスタンプ、例：1705395332
- `event: agent_thought` エージェントの思考、LLMの思考、ツール呼び出しの入力と出力を含みます（エージェントモードでのみサポート）
  - `id` (string) エージェント思考ID、各反復には一意のエージェント思考IDがあります
  - `task_id` (string)  タスクID、リクエスト追跡と以下のStop Generate APIに使用
  - `message_id` (string) 一意のメッセージID
  - `position` (int) 現在のエージェント思考の位置、各メッセージには順番に複数の思考が含まれる場合があります。
  - `thought` (string) LLMが考えていること
  - `observation` (string) ツール呼び出しからの応答
  - `tool` (string) 呼び出されたツールのリスト、;で区切られます
  - `tool_input` (string) ツールの入力、JSON形式。例：`{"dalle3": {"prompt": "a cute cat"}}`。
  - `created_at` (int) 作成タイムスタンプ、例：1705395332
  - `message_files` (array[string]) message_fileイベントを参照
    - `file_id` (string) ファイルID
  - `conversation_id` (string) 会話ID
- `event: message_file` メッセージファイルイベント、ツールによって新しいファイルが作成されました
  - `id` (string) ファイル一意ID
  - `type` (string) ファイルタイプ、現在は"image"のみ許可
  - `belongs_to` (string) 所属、ここでは'assistant'のみ
  - `url` (string) ファイルのリモートURL
  - `conversation_id`  (string) 会話ID
- `event: message_end` メッセージ終了イベント、このイベントを受信するとストリーミングが終了したことを意味します。
  - `task_id` (string) タスクID、リクエスト追跡と以下のStop Generate APIに使用
  - `message_id` (string) 一意のメッセージID
  - `conversation_id` (string) 会話ID
  - `metadata` (object) メタデータ
    - `usage` (Usage) モデル使用情報
    - `retriever_resources` (array[RetrieverResource]) 引用と帰属リスト
- `event: message_replace` メッセージ内容置換イベント。
  出力内容のモデレーションが有効な場合、内容がフラグされると、このイベントを通じてメッセージ内容が事前設定された返信に置き換えられます。
  - `task_id` (string) タスクID、リクエスト追跡と以下のStop Generate APIに使用
  - `message_id` (string) 一意のメッセージID
  - `conversation_id` (string) 会話ID
  - `answer` (string) 置換内容（すべてのLLM返信テキストを直接置換）
  - `created_at` (int) 作成タイムスタンプ、例：1705395332
- `event: error`
  ストリーミングプロセス中に発生した例外はストリームイベントの形式で出力され、エラーイベントを受信するとストリームが終了します。
  - `task_id` (string) タスクID、リクエスト追跡と以下のStop Generate APIに使用
  - `message_id` (string) 一意のメッセージID
  - `status` (int) HTTPステータスコード
  - `code` (string) エラーコード
  - `message` (string) エラーメッセージ
- `event: ping` 接続を維持するために10秒ごとにpingイベントが発生します。

### エラー
- 404, 会話が存在しません
- 400, `invalid_param`, 異常なパラメータ入力
- 400, `app_unavailable`, アプリ構成が利用できません
- 400, `provider_not_initialize`, 利用可能なモデル資格情報構成がありません
- 400, `provider_quota_exceeded`, モデル呼び出しクォータが不足しています
- 400, `model_currently_not_support`, 現在のモデルは利用できません
- 400, `workflow_not_found`, 指定されたワークフローバージョンが見つかりません
- 400, `draft_workflow_error`, ドラフトワークフローバージョンは使用できません
- 400, `workflow_id_format_error`, ワークフローID形式エラー、UUID形式が必要です
- 400, `completion_request_error`, テキスト生成に失敗しました
- 500, 内部サーバーエラー

<CodeGroup
  title="リクエスト"
  tag="POST"
  label="/chat-messages"
  targetCode={`curl -X POST '${props.appDetail.api_base_url}/chat-messages' \\

  </CodeGroup>
</Col>
</Row>

---
<Heading
url='/files/upload'
method='POST'
title='ファイルアップロード'
name='#file-upload'
/>
<Row>
<Col>
メッセージ送信時に使用するためのファイルをアップロードします（現在は画像のみサポート）。画像とテキストのマルチモーダル理解を可能にします。
png、jpg、jpeg、webp、gif 形式をサポートしています。
アップロードされたファイルは現在のエンドユーザーのみが使用できます。

### リクエストボディ
このインターフェースは`multipart/form-data`リクエストを必要とします。
- `file` (File) 必須
  アップロードするファイル。
- `user` (string) 必須
  ユーザー識別子、開発者のルールで定義され、アプリケーション内で一意でなければなりません。サービス API は WebApp によって作成された会話を共有しません。

### 応答
アップロードが成功すると、サーバーはファイルの ID と関連情報を返します。
- `id` (uuid) ID
- `name` (string) ファイル名
- `size` (int) ファイルサイズ（バイト）
- `extension` (string) ファイル拡張子
- `mime_type` (string) ファイルの MIME タイプ
- `created_by` (uuid) エンドユーザーID
- `created_at` (timestamp) 作成タイムスタンプ、例：1705395332

### エラー
- 400, `no_file_uploaded`, ファイルが提供されなければなりません
- 400, `too_many_files`, 現在は 1 つのファイルのみ受け付けます
- 400, `unsupported_preview`, ファイルはプレビューをサポートしていません
- 400, `unsupported_estimate`, ファイルは推定をサポートしていません
- 413, `file_too_large`, ファイルが大きすぎます
- 415, `unsupported_file_type`, サポートされていない拡張子、現在はドキュメントファイルのみ受け付けます
- 503, `s3_connection_failed`, S3 サービスに接続できません
- 503, `s3_permission_denied`, S3 にファイルをアップロードする権限がありません
- 503, `s3_file_too_large`, ファイルが S3 のサイズ制限を超えています
- 500, 内部サーバーエラー


</Col>
<Col sticky>
### リクエスト例
<CodeGroup
  title="リクエスト"
  tag="POST"
  label="/files/upload"
  targetCode={`curl -X POST '${props.appDetail.api_base_url}/files/upload' \\
--header 'Authorization: Bearer {api_key}' \\
--form 'file=@localfile;type=image/[png|jpeg|jpg|webp|gif]' \\
--form 'user=abc-123'`}
/>

### 応答例
<CodeGroup title="応答">
  ```json {{ title: '応答' }}
  {
    "id": "72fa9618-8f89-4a37-9b33-7e1178a24a67",
    "name": "example.png",
    "size": 1024,
    "extension": "png",
    "mime_type": "image/png",
    "created_by": "6ad1ab0a-73ff-4ac1-b9e4-cdb312f71f13",
    "created_at": 1577836800,
  }

他の API がエンドユーザー ID（例：ファイルアップロードの `created_by`）を返す場合に利用できます。

### パスパラメータ
- `end_user_id` (uuid) 必須
  エンドユーザー ID。

### レスポンス
EndUser オブジェクトを返します。
- `id` (uuid) ID
- `tenant_id` (uuid) テナント ID
- `app_id` (uuid) アプリ ID
- `type` (string) エンドユーザー種別
- `external_user_id` (string) 外部ユーザー ID
- `name` (string) 名前
- `is_anonymous` (boolean) 匿名ユーザーかどうか
- `session_id` (string) セッション ID
- `created_at` (string) ISO 8601 日時
- `updated_at` (string) ISO 8601 日時

### エラー
- 404, `end_user_not_found`, エンドユーザーが見つかりません
- 500, 内部サーバーエラー

### レスポンス例
<CodeGroup title="Response">
```json {{ title: 'Response' }}
{
  "id": "6ad1ab0a-73ff-4ac1-b9e4-cdb312f71f13",
  "tenant_id": "8c0f3f3a-66b0-4b55-a0bf-8b8e0d6aee7d",
  "app_id": "6c8c3f41-2c6f-4e1b-8f4f-7f11c8f2ad2a",
  "type": "service_api",
  "external_user_id": "abc-123",
  "name": "Alice",
  "is_anonymous": false,
  "session_id": "abc-123",
  "created_at": "2024-01-01T00:00:00Z",
  "updated_at": "2024-01-01T00:00:00Z"
}
```
</CodeGroup>

<i>ファイルは、リクエストしているアプリケーションのメッセージ範囲内にある場合のみアクセス可能です。</i>

### パスパラメータ
- `file_id` (string) 必須
  プレビューするファイルの一意識別子。ファイルアップロード API レスポンスから取得します。

### クエリパラメータ
- `as_attachment` (boolean) オプション
  ファイルを添付ファイルとして強制ダウンロードするかどうか。デフォルトは `false`（ブラウザでプレビュー）。

### レスポンス
ブラウザ表示またはダウンロード用の適切なヘッダー付きでファイル内容を返します。
- `Content-Type` ファイル MIME タイプに基づいて設定
- `Content-Length` ファイルサイズ（バイト、利用可能な場合）
- `Content-Disposition` `as_attachment=true` の場合は "attachment" に設定
- `Cache-Control` パフォーマンス向上のためのキャッシュヘッダー
- `Accept-Ranges` 音声/動画ファイルの場合は "bytes" に設定

### エラー
- 400, `invalid_param`, パラメータ入力異常
- 403, `file_access_denied`, ファイルアクセス拒否またはファイルが現在のアプリケーションに属していません
- 404, `file_not_found`, ファイルが見つからないか削除されています
- 500, サーバー内部エラー

### 添付ファイルとしてダウンロード
<CodeGroup
  title="Download Request"
  tag="GET"
  label="/files/:file_id/preview?as_attachment=true"
  targetCode={`curl -X GET '${props.appDetail.api_base_url}/files/72fa9618-8f89-4a37-9b33-7e1178a24a67/preview?as_attachment=true' \\

### レスポンスヘッダー例
<CodeGroup title="Response Headers">
```http {{ title: 'Headers - 画像プレビュー' }}
Content-Type: image/png
Content-Length: 1024
Cache-Control: public, max-age=3600
```
</CodeGroup>

### ダウンロードレスポンスヘッダー
<CodeGroup title="Download Response Headers">
```http {{ title: 'Headers - ファイルダウンロード' }}
Content-Type: image/png
Content-Length: 1024
Content-Disposition: attachment; filename*=UTF-8''example.png
Cache-Control: public, max-age=3600
```
</CodeGroup>

### 応答例
<CodeGroup title="応答">
```json {{ title: '応答' }}
{
  "result": "success"
}
```
</CodeGroup>

### パス
<Properties>
  <Property name='message_id' type='string' key='message_id'>
   メッセージID
  </Property>
</Properties>

### リクエストボディ

<Properties>
  <Property name='rating' type='string' key='rating'>
    アップボートは`like`、ダウンボートは`dislike`、アップボートの取り消しは`null`
  </Property>
  <Property name='user' type='string' key='user'>
    ユーザー識別子、開発者のルールで定義され、アプリケーション内で一意でなければなりません。
  </Property>
  <Property name='content' type='string' key='content'>
    メッセージのフィードバックです。
  </Property>
</Properties>

### 応答
- `result` (string) 常に"success"を返します

<CodeGroup
  title="リクエスト"
  tag="POST"
  label="/messages/:message_id/feedbacks"
  targetCode={`curl -X POST '${props.appDetail.api_base_url}/messages/:message_id/feedbacks \\

<CodeGroup title="応答">
```json {{ title: '応答' }}
{
  "result": "success"
}
```
</CodeGroup>

### クエリ
<Properties>
  <Property name='page' type='string' key='page'>
   （任意）ページ番号。デフォルト値：1
  </Property>
</Properties>

<Properties>
  <Property name='limit' type='string' key='limit'>
   （任意）1ページあたりの件数。デフォルト値：20
  </Property>
</Properties>

### レスポンス
- `data` (リスト) このアプリの「いいね」とフィードバックの一覧を返します。

<CodeGroup
  title="リクエスト"
  tag="GET"
  label="/app/feedbacks"
  targetCode={`curl -X GET '${props.appDetail.api_base_url}/app/feedbacks?page=1&limit=20'`}
/>

<CodeGroup title="応答">
```json {{ title: 'Response' }}
    {
    "data": [
        {
            "id": "8c0fbed8-e2f9-49ff-9f0e-15a35bdd0e25",
            "app_id": "f252d396-fe48-450e-94ec-e184218e7346",
            "conversation_id": "2397604b-9deb-430e-b285-4726e51fd62d",
            "message_id": "709c0b0f-0a96-4a4e-91a4-ec0889937b11",
            "rating": "like",
            "content": "message feedback information-3",
            "from_source": "user",
            "from_end_user_id": "74286412-9a1a-42c1-929c-01edb1d381d5",
            "from_account_id": null,
            "created_at": "2025-04-24T09:24:38",
            "updated_at": "2025-04-24T09:24:38"
        }
    ]
    }
```
</CodeGroup>

### パスパラメータ

<Properties>
  <Property name='message_id' type='string' key='message_id'>
    メッセージID
  </Property>
</Properties>

### クエリ
<Properties>
  <Property name='user' type='string' key='user'>
    ユーザー識別子、エンドユーザーのアイデンティティを定義するために使用され、統計のために使用されます。
    アプリケーション内で開発者によって一意に定義される必要があります。
  </Property>
</Properties>

<CodeGroup
  title="リクエスト"
  tag="GET"
  label="/messages/{message_id}/suggested"
  targetCode={`curl --location --request GET '${props.appDetail.api_base_url}/messages/{message_id}/suggested?user=abc-123& \\

<CodeGroup title="応答">
```json {{ title: '応答' }}
{
  "result": "success",
  "data": [
        "a",
        "b",
        "c"
    ]
}
```
</CodeGroup>

### クエリ

<Properties>
  <Property name='conversation_id' type='string' key='conversation_id'>
    会話ID
  </Property>
  <Property name='user' type='string' key='user'>
    ユーザー識別子、エンドユーザーのアイデンティティを定義するために使用され、統計のために使用されます。
    アプリケーション内で開発者によって一意に定義される必要があります。
  </Property>
  <Property name='first_id' type='string' key='first_id'>
      現在のページの最初のチャット記録のID、デフォルトはnullです。
  </Property>
  <Property name='limit' type='int' key='limit'>
      1回のリクエストで返すチャット履歴メッセージの数、デフォルトは20です。
  </Property>
</Properties>

### 応答
- `data` (array[object]) メッセージリスト
  - `id` (string) メッセージID
  - `conversation_id` (string) 会話ID
  - `inputs` (object) ユーザー入力パラメータ。
  - `query` (string) ユーザー入力/質問内容。
  - `message_files` (array[object]) メッセージファイル
    - `id` (string) ID
    - `type` (string) ファイルタイプ、画像の場合はimage
    - `url` (string) ファイルプレビューURL、ファイルアクセスにはファイルプレビューAPI（`/files/{file_id}/preview`）を使用してください
    - `belongs_to` (string) 所属、ユーザーまたはアシスタント
  - `agent_thoughts` (array[object]) エージェントの思考（基本アシスタントの場合は空）
    - `id` (string) エージェント思考ID、各反復には一意のエージェント思考IDがあります
    - `message_id` (string) 一意のメッセージID
    - `position` (int) 現在のエージェント思考の位置、各メッセージには順番に複数の思考が含まれる場合があります。
    - `thought` (string) LLMが考えていること
    - `observation` (string) ツール呼び出しからの応答
    - `tool` (string) 呼び出されたツールのリスト、;で区切られます
    - `tool_input` (string) ツールの入力、JSON形式。例：`{"dalle3": {"prompt": "a cute cat"}}`。
    - `created_at` (int) 作成タイムスタンプ、例：1705395332
    - `message_files` (array[string]) message_fileイベントを参照
      - `file_id` (string) ファイルID
  - `answer` (string) 応答メッセージ内容
  - `created_at` (timestamp) 作成タイムスタンプ、例：1705395332
  - `feedback` (object) フィードバック情報
    - `rating` (string) アップボートは`like` / ダウンボートは`dislike`
  - `retriever_resources` (array[RetrieverResource]) 引用と帰属リスト
- `has_more` (bool) 次のページがあるかどうか
- `limit` (int) 返されたアイテムの数、入力がシステム制限を超える場合、システム制限の数を返します

<CodeGroup
  title="リクエスト"
  tag="GET"
  label="/messages"
  targetCode={`curl -X GET '${props.appDetail.api_base_url}/messages?user=abc-123&conversation_id='\\

### 応答例（エージェントアシスタント）
<CodeGroup title="応答">
```json {{ title: '応答' }}
{
    "limit": 20,
    "has_more": false,
    "data": [
        {
            "id": "d35e006c-7c4d-458f-9142-be4930abdf94",
            "conversation_id": "957c068b-f258-4f89-ba10-6e8a0361c457",
            "inputs": {},
            "query": "draw a cat",
            "answer": "猫の画像を生成しました。メッセージを確認して画像を表示してください。",
            "message_files": [
                {
                    "id": "976990d2-5294-47e6-8f14-7356ba9d2d76",
                    "type": "image",
                    "url": "http://127.0.0.1:5001/files/tools/976990d2-5294-47e6-8f14-7356ba9d2d76.png?timestamp=1705988524&nonce=55df3f9f7311a9acd91bf074cd524092&sign=z43nMSO1L2HBvoqADLkRxr7Biz0fkjeDstnJiCK1zh8=",
                    "belongs_to": "assistant"
                }
            ],
            "feedback": null,
            "retriever_resources": [],
            "created_at": 1705988187,
            "agent_thoughts": [
                {
                    "id": "592c84cf-07ee-441c-9dcc-ffc66c033469",
                    "chain_id": null,
                    "message_id": "d35e006c-7c4d-458f-9142-be4930abdf94",
                    "position": 1,
                    "thought": "",
                    "tool": "dalle2",
                    "tool_input": "{\"dalle2\": {\"prompt\": \"cat\"}}",
                    "created_at": 1705988186,
                    "observation": "画像はすでに作成され、ユーザーに送信されました。今すぐユーザーに確認するように伝えてください。",
                    "files": [
                        "976990d2-5294-47e6-8f14-7356ba9d2d76"
                    ]
                },
                {
                    "id": "73ead60d-2370-4780-b5ed-532d2762b0e5",
                    "chain_id": null,
                    "message_id": "d35e006c-7c4d-458f-9142-be4930abdf94",
                    "position": 2,
                    "thought": "猫の画像を生成しました。メッセージを確認して画像を表示してください。",
                    "tool": "",
                    "tool_input": "",
                    "created_at": 1705988199,
                    "observation": "",
                    "files": []
                }
            ]
        }
    ]
}
```
</CodeGroup>

### クエリ

<Properties>
  <Property name='user' type='string' key='user'>
      ユーザー識別子、エンドユーザーのアイデンティティを定義するために使用され、統計のために使用されます。
      アプリケーション内で開発者によって一意に定義される必要があります。
  </Property>
  <Property name='last_id' type='string' key='last_id'>
      (Optional)現在のページの最後のレコードのID、デフォルトはnullです。
  </Property>
  <Property name='limit' type='int' key='limit'>
      (Optional)1回のリクエストで返すレコードの数、デフォルトは最新の20件です。最大100、最小1。
  </Property>
  <Property name='sort_by' type='string' key='sort_by'>
    (Optional)ソートフィールド、デフォルト：-updated_at（更新時間で降順にソート）
    - 利用可能な値：created_at, -created_at, updated_at, -updated_at
    - フィールドの前の記号は順序または逆順を表し、"-"は逆順を表します。
  </Property>
</Properties>

### 応答
- `data` (array[object]) 会話のリスト
  - `id` (string) 会話ID
  - `name` (string) 会話名、デフォルトでは、ユーザーが会話で最初に尋ねた質問のスニペットです。
  - `inputs` (object) ユーザー入力パラメータ。
  - `introduction` (string) 紹介
  - `created_at` (timestamp) 作成タイムスタンプ、例：1705395332
  - `updated_at` (timestamp) 更新タイムスタンプ、例：1705395332
- `has_more` (bool)
- `limit` (int) 返されたエントリの数、入力がシステム制限を超える場合、システム制限の数を返します

<CodeGroup title="リクエスト" tag="GET" label="/conversations" targetCode={`curl -X GET '${props.appDetail.api_base_url}/conversations?user=abc-123&last_id=&limit=20' \\

<CodeGroup title="応答">
```json {{ title: '応答' }}
{
  "limit": 20,
  "has_more": false,
  "data": [
    {
      "id": "10799fb8-64f7-4296-bbf7-b42bfbe0ae54",
      "name": "新しいチャット",
      "inputs": {
          "book": "book",
          "myName": "Lucy"
      },
      "status": "normal",
      "created_at": 1679667915,
      "updated_at": 1679667915
    },
    {
      "id": "hSIhXBhNe8X1d8Et"
      // ...
    }
  ]
}
```
</CodeGroup>

### パス
- `conversation_id` (string) 会話ID

### リクエストボディ

<Properties>
  <Property name='user' type='string' key='user'>
    ユーザー識別子、開発者によって定義され、アプリケーション内で一意である必要があります。
  </Property>
</Properties>

### 応答
- `result` (string) 常に"success"を返します

<CodeGroup
  title="リクエスト"
  tag="DELETE"
  label="/conversations/:conversation_id"
  targetCode={`curl -X DELETE '${props.appDetail.api_base_url}/conversations/:conversation_id' \\

<CodeGroup title="応答">
```text {{ title: '応答' }}
204 No Content
```
</CodeGroup>

### パス
- `conversation_id` (string) 会話ID

<Properties>
  <Property name='name' type='string' key='name'>
    (Optional)会話の名前。このパラメータは、`auto_generate`が`true`に設定されている場合、省略できます。
  </Property>
  <Property name='auto_generate' type='bool' key='auto_generate'>
    (Optional)タイトルを自動生成します。デフォルトは`false`です。
  </Property>
  <Property name='user' type='string' key='user'>
    ユーザー識別子、開発者によって定義され、アプリケーション内で一意である必要があります。
  </Property>
</Properties>

### 応答
- `id` (string) 会話ID
- `name` (string) 会話名
- `inputs` (object) ユーザー入力パラメータ
- `status` (string) 会話状態
- `introduction` (string) 紹介
- `created_at` (timestamp) 作成タイムスタンプ、例：1705395332
- `updated_at` (timestamp) 更新タイムスタンプ、例：1705395332

<CodeGroup
  title="リクエスト"
  tag="POST"
  label="/conversations/:conversation_id/name"
  targetCode={`curl -X POST '${props.appDetail.api_base_url}/conversations/:conversation_id/name' \\

<CodeGroup title="応答">
```json {{ title: '応答' }}
{
    "id": "cd78daf6-f9e4-4463-9ff2-54257230a0ce",
    "name": "Chat vs AI",
    "inputs": {},
    "introduction": "",
    "created_at": 1705569238,
    "updated_at": 1705569238
}
```
</CodeGroup>

### パスパラメータ

<Properties>
  <Property name='conversation_id' type='string' key='conversation_id'>
    変数を取得する会話のID。
  </Property>
</Properties>

### クエリパラメータ

<Properties>
  <Property name='user' type='string' key='user'>
    ユーザー識別子。開発者によって定義されたルールに従い、アプリケーション内で一意である必要があります。
  </Property>
  <Property name='last_id' type='string' key='last_id'>
      (Optional)現在のページの最後のレコードのID、デフォルトはnullです。
  </Property>
  <Property name='limit' type='int' key='limit'>
      (Optional)1回のリクエストで返すレコードの数、デフォルトは最新の20件です。最大100、最小1。
  </Property>
</Properties>

### レスポンス

- `limit` (int) ページごとのアイテム数
- `has_more` (bool) さらにアイテムがあるかどうか
- `data` (array[object]) 変数のリスト
  - `id` (string) 変数 ID
  - `name` (string) 変数名
  - `value_type` (string) 変数タイプ（文字列、数値、真偽値など）
  - `value` (string) 変数値
  - `description` (string) 変数の説明
  - `created_at` (int) 作成タイムスタンプ
  - `updated_at` (int) 最終更新タイムスタンプ

### エラー
- 404, `conversation_not_exists`, 会話が見つかりません

<CodeGroup
  title="リクエスト"
  tag="GET"
  label="/conversations/:conversation_id/variables"
  targetCode={`curl -X GET '${props.appDetail.api_base_url}/conversations/{conversation_id}/variables?user=abc-123' \\

<CodeGroup title="Request with variable name filter">
```bash {{ title: 'cURL' }}
curl -X GET '${props.appDetail.api_base_url}/conversations/{conversation_id}/variables?user=abc-123&variable_name=customer_name' \
--header 'Authorization: Bearer {api_key}'
```
</CodeGroup>

<CodeGroup title="応答">
```json {{ title: 'Response' }}
{
  "limit": 100,
  "has_more": false,
  "data": [
    {
      "id": "variable-uuid-1",
      "name": "customer_name",
      "value_type": "string",
      "value": "John Doe",
      "description": "会話から抽出された顧客名",
      "created_at": 1650000000000,
      "updated_at": 1650000000000
    },
    {
      "id": "variable-uuid-2",
      "name": "order_details",
      "value_type": "json",
      "value": "{\"product\":\"Widget\",\"quantity\":5,\"price\":19.99}",
      "description": "顧客の注文詳細",
      "created_at": 1650000000000,
      "updated_at": 1650000000000
    }
  ]
}
```
</CodeGroup>

### パスパラメータ

<Properties>
  <Property name='conversation_id' type='string' key='conversation_id'>
    更新する変数を含む会話のID。
  </Property>
  <Property name='variable_id' type='string' key='variable_id'>
    更新する変数のID。
  </Property>
</Properties>

### リクエストボディ

<Properties>
  <Property name='value' type='any' key='value'>
    変数の新しい値。変数の期待される型（文字列、数値、オブジェクトなど）と一致する必要があります。
  </Property>
  <Property name='user' type='string' key='user'>
    ユーザー識別子。開発者によって定義されたルールに従い、アプリケーション内で一意である必要があります。
  </Property>
</Properties>

### レスポンス

以下を含む更新された変数オブジェクトを返します：
- `id` (string) 変数ID
- `name` (string) 変数名
- `value_type` (string) 変数型（文字列、数値、オブジェクトなど）
- `value` (any) 更新された変数値
- `description` (string) 変数の説明
- `created_at` (int) 作成タイムスタンプ
- `updated_at` (int) 最終更新タイムスタンプ

### エラー
- 400, `Type mismatch: variable expects {expected_type}, but got {actual_type} type`, 値の型が変数の期待される型と一致しません
- 404, `conversation_not_exists`, 会話が見つかりません
- 404, `conversation_variable_not_exists`, 変数が見つかりません

<CodeGroup
  title="リクエスト"
  tag="PUT"
  label="/conversations/:conversation_id/variables/:variable_id"
  targetCode={`curl -X PUT '${props.appDetail.api_base_url}/conversations/{conversation_id}/variables/{variable_id}' \\

<CodeGroup title="異なる値型での更新">
```bash {{ title: '文字列値' }}
curl -X PUT '${props.appDetail.api_base_url}/conversations/{conversation_id}/variables/{variable_id}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {api_key}' \
--data-raw '{
    "value": "新しい文字列値",
    "user": "abc-123"
}'
```

```bash {{ title: '数値' }}
curl -X PUT '${props.appDetail.api_base_url}/conversations/{conversation_id}/variables/{variable_id}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {api_key}' \
--data-raw '{
    "value": 42,
    "user": "abc-123"
}'
```

```bash {{ title: 'オブジェクト値' }}
curl -X PUT '${props.appDetail.api_base_url}/conversations/{conversation_id}/variables/{variable_id}' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {api_key}' \
--data-raw '{
    "value": {"product": "Widget", "quantity": 10, "price": 29.99},
    "user": "abc-123"
}'
```
</CodeGroup>

<CodeGroup title="応答">
```json {{ title: 'Response' }}
{
  "id": "variable-uuid-1",
  "name": "customer_name",
  "value_type": "string",
  "value": "Updated Value",
  "description": "会話から抽出された顧客名",
  "created_at": 1650000000000,
  "updated_at": 1650000001000
}
```
</CodeGroup>

### リクエストボディ

<Properties>
  <Property name='file' type='file' key='file'>
    オーディオファイル。
    サポートされている形式：`['mp3', 'mp4', 'mpeg', 'mpga', 'm4a', 'wav', 'webm']`
    ファイルサイズ制限：15MB
  </Property>
  <Property name='user' type='string' key='user'>
  ユーザー識別子、開発者のルールで定義され、アプリケーション内で一意でなければなりません。
  </Property>
</Properties>

### 応答
- `text` (string) 出力テキスト

<CodeGroup
  title="リクエスト"
  tag="POST"
  label="/audio-to-text"
  targetCode={`curl -X POST '${props.appDetail.api_base_url}/audio-to-text' \\

<CodeGroup title="応答">
```json {{ title: '応答' }}
{
  "text": ""
}
```
</CodeGroup>

### リクエストボディ

<Properties>
  <Property name='message_id' type='str' key='message_id'>
    Difyによって生成されたテキストメッセージの場合、生成されたメッセージIDを直接渡します。バックエンドはメッセージIDを使用して対応するコンテンツを検索し、音声情報を直接合成します。message_idとtextが同時に提供される場合、message_idが優先されます。
  </Property>
  <Property name='text' type='str' key='text'>
    音声生成コンテンツ。
  </Property>
  <Property name='user' type='string' key='user'>
    ユーザー識別子、開発者によって定義され、アプリ内で一意である必要があります。
  </Property>
</Properties>

<CodeGroup
  title="リクエスト"
  tag="POST"
  label="/text-to-audio"
  targetCode={`curl --location --request POST '${props.appDetail.api_base_url}/text-to-audio' \\

<CodeGroup title="ヘッダー">
```json {{ title: 'ヘッダー' }}
{
  "Content-Type": "audio/wav"
}
```
</CodeGroup>

### 応答
- `opening_statement` (string) 開始文
- `suggested_questions` (array[string]) 開始時の推奨質問のリスト
- `suggested_questions_after_answer` (object) 答えを有効にした後の質問を提案します。
  - `enabled` (bool) 有効かどうか
- `speech_to_text` (object) 音声からテキストへ
  - `enabled` (bool) 有効かどうか
- `text_to_speech` (object) テキストから音声へ
  - `enabled` (bool) 有効かどうか
  - `voice` (string) 音声タイプ
  - `language` (string) 言語
  - `autoPlay` (string) 自動再生
    - `enabled`  有効
    - `disabled` 無効
- `retriever_resource` (object) 引用と帰属
  - `enabled` (bool) 有効かどうか
- `annotation_reply` (object) 注釈返信
  - `enabled` (bool) 有効かどうか
- `user_input_form` (array[object]) ユーザー入力フォームの構成
  - `text-input` (object) テキスト入力コントロール
    - `label` (string) 変数表示ラベル名
    - `variable` (string) 変数ID
    - `required` (bool) 必須かどうか
    - `default` (string) デフォルト値
  - `paragraph` (object) 段落テキスト入力コントロール
    - `label` (string) 変数表示ラベル名
    - `variable` (string) 変数ID
    - `required` (bool) 必須かどうか
    - `default` (string) デフォルト値
  - `select` (object) ドロップダウンコントロール
    - `label` (string) 変数表示ラベル名
    - `variable` (string) 変数ID
    - `required` (bool) 必須かどうか
    - `default` (string) デフォルト値
    - `options` (array[string]) オプション値
- `file_upload` (object) ファイルアップロード設定
  - `document` (object) ドキュメント設定
    現在サポートされているドキュメントタイプ：`txt`, `md`, `markdown`, `pdf`, `html`, `xlsx`, `xls`, `docx`, `csv`, `eml`, `msg`, `pptx`, `ppt`, `xml`, `epub`。
    - `enabled` (bool) 有効かどうか
    - `number_limits` (int) ドキュメント数の上限。デフォルトは 3
    - `transfer_methods` (array[string]) 転送方法リスト：`remote_url`, `local_file`。いずれかを選択する必要があります。
  - `image` (object) 画像設定
    現在サポートされている画像タイプ：`png`, `jpg`, `jpeg`, `webp`, `gif`。
    - `enabled` (bool) 有効かどうか
    - `number_limits` (int) 画像数の上限。デフォルトは 3
    - `transfer_methods` (array[string]) 転送方法リスト：`remote_url`, `local_file`。いずれかを選択する必要があります。
  - `audio` (object) オーディオ設定
    現在サポートされているオーディオタイプ：`mp3`, `m4a`, `wav`, `webm`, `amr`。
    - `enabled` (bool) 有効かどうか
    - `number_limits` (int) オーディオ数の上限。デフォルトは 3
    - `transfer_methods` (array[string]) 転送方法リスト：`remote_url`, `local_file`。いずれかを選択する必要があります。
  - `video` (object) ビデオ設定
    現在サポートされているビデオタイプ：`mp4`, `mov`, `mpeg`, `mpga`。
    - `enabled` (bool) 有効かどうか
    - `number_limits` (int) ビデオ数の上限。デフォルトは 3
    - `transfer_methods` (array[string]) 転送方法リスト：`remote_url`, `local_file`。いずれかを選択する必要があります。
  - `custom` (object) カスタム設定
    - `enabled` (bool) 有効かどうか
    - `number_limits` (int) カスタム数の上限。デフォルトは 3
    - `transfer_methods` (array[string]) 転送方法リスト：`remote_url`, `local_file`。いずれかを選択する必要があります。
- `system_parameters` (object) システムパラメータ
  - `file_size_limit` (int) ドキュメントアップロードサイズ制限（MB）
  - `image_file_size_limit` (int) 画像ファイルアップロードサイズ制限（MB）
  - `audio_file_size_limit` (int) オーディオファイルアップロードサイズ制限（MB）
  - `video_file_size_limit` (int) ビデオファイルアップロードサイズ制限（MB）

<CodeGroup
  title="リクエスト"
  tag="GET"
  label="/parameters"
  targetCode={` curl -X GET '${props.appDetail.api_base_url}/parameters'`}
/>

<CodeGroup title="応答">
```json {{ title: '応答' }}
{
  "opening_statement": "こんにちは！",
  "suggested_questions_after_answer": {
      "enabled": true
  },
  "speech_to_text": {
      "enabled": true
  },
  "text_to_speech": {
      "enabled": true,
      "voice": "sambert-zhinan-v1",
      "language": "zh-Hans",
      "autoPlay": "disabled"
  },
  "retriever_resource": {
      "enabled": true
  },
  "annotation_reply": {
      "enabled": true
  },
  "user_input_form": [
      {
          "paragraph": {
              "label": "クエリ",
              "variable": "query",
              "required": true,
              "default": ""
          }
      }
  ],
  "file_upload": {
      "image": {
          "enabled": false,
          "number_limits": 3,
          "detail": "high",
          "transfer_methods": [
              "remote_url",
              "local_file"
          ]
      }
  },
  "system_parameters": {
      "file_size_limit": 15,
      "image_file_size_limit": 10,
      "audio_file_size_limit": 50,
      "video_file_size_limit": 100
  }
}
```
</CodeGroup>

<CodeGroup title="応答">
```json {{ title: '応答' }}
{
  "tool_icons": {
    "dalle2": "https://cloud.dify.ai/console/api/workspaces/current/tool-provider/builtin/dalle/icon",
    "api_tool": {
      "background": "#252525",
      "content": "\ud83d\ude01"
    }
  }
}
```
</CodeGroup>

<CodeGroup title="応答">
```json {{ title: 'Response' }}
{
  "title": "My App",
  "chat_color_theme": "#ff4a4a",
  "chat_color_theme_inverted": false,
  "icon_type": "emoji",
  "icon": "😄",
  "icon_background": "#FFEAD5",
  "icon_url": null,
  "description": "This is my app.",
  "copyright": "all rights reserved",
  "privacy_policy": "",
  "custom_disclaimer": "All generated by AI",
  "default_language": "en-US",
  "show_workflow_steps": false,
  "use_icon_as_answer_icon": false,
}
```
</CodeGroup>