機能の概要
ReAct/ツール呼び出しスタイルの複数ラウンド対話をサーバーに送信すると、モデルが再利用可能な経験エントリ（サンプルコード、一般的な落とし穴などを含む）を抽出します。書き込まれた経験の数と概要を返します。
呼び出しの説明
インターフェース制約
- 呼び出し元はAPIキーを保有している必要があります。詳細については、AI APIキーの管理をご参照ください。
リクエストパス
POST {BASE_URL}/api/v1/memory/spaces/{spaceId}/memories/distill
リクエストヘッダー
プロパティ |
必須 |
サンプル値 |
説明 |
|---|---|---|---|
| Authorization | はい | Bearer {token} | 認証情報 |
| Content-Type | いいえ | application/json | リクエストボディの形式 |
| X-OB-Project-ID | はい | your-project-id | プロジェクトID |
リクエストパラメータ
Pathパラメータ
プロパティ |
型 |
必須 |
サンプル値 |
説明 |
|---|---|---|---|---|
| spaceId | string | はい | space-123 | メモリースペースID。 |
Bodyパラメータ
プロパティ |
型 |
必須 |
サンプル値 |
説明 |
|---|---|---|---|---|
| messages | array |
はい | [{"role":"user","content":"こんにちは"}] | 対話メッセージのリスト。 |
| messages[].role | string | はい | user | メッセージのロール。user、assistant、systemのいずれか。 |
| messages[].content | string | はい | こんにちは | メッセージの内容。 |
実行結果
レスポンスパラメータ
プロパティ |
型 |
説明 |
|---|---|---|
| success | boolean | リクエストが成功したかどうか |
| code | string | 戻り値コード |
| message | string | 戻り値メッセージ |
| data | object | ビジネスデータ |
dataフィールドの説明
名前 |
型 |
説明 |
|---|---|---|
| count | integer | 今回書き込まれたエクスペリエンスエントリの数 |
| summary | string | エクスペリエンスの概要 |
リクエスト例
curl --request POST '{BASE_URL}/api/v1/memory/spaces/mem-space-123/memories/distill' \
--header 'Authorization: Bearer {token}' \
--header 'X-OB-Project-ID: your-project-id' \
--header 'Content-Type: application/json' \
--data '{
"messages": []
}'
レスポンス例
{
"success": true,
"code": "200",
"message": "successful",
"data": {
"count": 5,
"summary": "対話から、エラー処理とAPI呼び出しに関する5つのエクスペリエンスを抽出しました。"
}
}