Overview
Submits a multi-turn conversation that contains ReAct-style reasoning or tool calls to the server. The model distills reusable experience entries, including sample code and common pitfalls. The response contains the number and summary of the experience entries added.
API details
Constraints
- You must have an API key. For more information, see Manage AI API keys.
Request path
POST {BASE_URL}/api/v1/memory/spaces/{spaceId}/memories/distill
Request headers
Name |
Required |
Example value |
Description |
|---|---|---|---|
| Authorization | Yes | Bearer {token} | Authentication information. |
| Content-Type | No | application/json | Request body format. |
| X-OB-Project-ID | Yes | your-project-id | Project ID |
Request parameters
Path parameters
Name |
Type |
Required |
Example value |
Description |
|---|---|---|---|---|
| spaceId | string | Yes | space-123 | Memory space ID. |
Body parameters
Name |
Type |
Required |
Example value |
Description |
|---|---|---|---|---|
| messages | array<ChatMessage> |
Yes | [{"role":"user","content":"Hello"}] | List of conversation messages. |
| messages[].role | string | Yes | user | Message role. Valid values: user, assistant, and system. |
| messages[].content | string | Yes | Hello | The content of the message. |
Response
Response parameters
Name |
Type |
Description |
|---|---|---|
| success | boolean | Whether the request was successful |
| code | string | Response code. |
| message | string | Response message. |
| data | object | Response data. |
Data fields
Name |
Type |
Description |
|---|---|---|
| count | integer | Number of experience entries added. |
| summary | string | Summary of the distilled experiences. |
Request example
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": []
}'
Response example
{
"success": true,
"code": "200",
"message": "successful",
"data": {
"count": 5,
"summary": "Successfully distilled 5 insights on error handling and API calls from the conversation."
}
}