# 上下文编辑

> 全部文档的索引见 [llms.txt](https://ark.volcengine.com/llms.txt)；在任一文档页面地址后追加 `.md` 可获取该页的 Markdown 版本。

上下文编辑功能可以管理上下文中思维链内容及工具调用内容，具备以下优势：

* 工具使用效果提升：能够让模型利用历史上下文中思考的内容，提高工具触发及使用效果。
* 上下文窗口管理：自动保持在模型上下文窗口限制内。
* 智能缓存：与缓存功能协同工作，优化性能。

> **说明**
>
> 该能力尚在 beta 阶段，请谨慎在生产环境使用。

<span id="d6c6c029"></span>
# 支持模型

* doubao-seed-evolving 
* doubao-seed-2-1-pro-260915
* doubao-seed-2-1-lite-260915
* doubao-seed-2-1-pro-260628
* doubao-seed-2-1-turbo-260628
* doubao-seed-2-0-lite-260428
* doubao-seed-2-0-mini-260428
* doubao-seed-2-0-pro-260215
* doubao-seed-2-0-lite-260215
* doubao-seed-2-0-mini-260215
* doubao-seed-2-0-code-preview-260215
* doubao-seed-character-260628

<span id="b8d655bb"></span>
# API 文档

[Responses API](/docs/create-model-responses-api)

<span id="53274bbd"></span>
# 功能策略

|功能策略 |标识符 |描述 |
| --- | --- | --- |
|思维链内容清除 |`clear_thinking` |在开启思考时管理思维链内容。 | \
| | |该策略会自动清除先前轮次较旧的思维链内容。 |
|工具调用内容清除 |`clear_tool_uses` |在对话上下文增长超过配置的阈值时清除工具调用内容。 | \
| | |该策略会自动清除先前轮次较旧的工具调用内容。 |

<span id="d44abb15"></span>
# 思维链内容清除

<span id="c4a97c35"></span>
## 配置项

`clear_thinking` 策略支持以下配置：
|配置项 |类型 |默认值 |说明 |
| --- | --- | --- | --- |
|keep |Object / String |`{type: "thinking_turns", value: 1}` |定义思维链保留策略。 |

> 保留轮次同时覆盖工具调用和非工具调用场景，只基于轮数判断。

配置示例：

* 保留最近 N 个轮次的思维链内容：（N 必须 > 0）

    ```JSON
    // 保留最近 3 个轮次的思维链内容
    {
        "type": "clear_thinking",
        "keep": {
            "type": "thinking_turns",
            "value": 3
        }
    }
    ```

* 保留所有思维链内容：

    ```Bash
    {
        "type": "clear_thinking",
        "keep": "all"
    }
    ```

<span id="26061490"></span>
## 使用示例

**选项：Curl**

```Bash
curl https://ark.cn-beijing.volces.com/api/v3/responses \
    -H "Authorization: Bearer $ARK_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
        "model": "doubao-seed-2-0-lite-260215",
        "input": "推理模型与非推理模型区别。",
        "thinking":{"type": "enabled"},
        "context_management": {
            "edits": [
                {
                    "type": "clear_thinking",
                    "keep": {
                        "type": "thinking_turns",
                        "value": 3
                    }
                }
            ]
        }
    }'
```

<span id="f46ff0c8"></span>
# 工具调用内容清除

<span id="3ec28f05"></span>
## 配置项

`clear_tool_uses`策略支持以下配置：
|配置项 |类型 |默认值 |说明 |
| --- | --- | --- | --- |
|trigger |Object | |触发工具调用内容清除策略的阈值。 |
|keep |object |3 轮工具调用 |保留最近 N 轮工具调用内容。 |
|exclude_tools |Array | |不会被清除的工具名称列表，用于保留重要上下文。 |
|clear_tool_inputs |Bool |false |是否清除工具调用参数。 |

配置示例：

```JSON
{
    "type": "clear_tool_uses",
    "trigger": {
        "type": "tool_uses",
        "value": 5
    },
    "keep": {
        "type": "tool_uses",
        "value": 3
    },
    "exclude_tools": [
        "web_search"
    ]
}
```

<span id="22e63008"></span>
## 使用示例

**选项：Curl**

```Bash
curl https://ark.cn-beijing.volces.com/api/v3/responses \
    -H "Authorization: Bearer $ARK_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
        "model": "doubao-seed-2-0-lite-260215",
        "input": [
            {
                "role": "system",
                "content": "你是人工智能助手."
            },
            {
                "role": "user",
                "content": "今天北京天气怎么样"
            }
        ],
        "thinking":{"type": "enabled"},
        "tools": [
            {
                "type": "function",
                "name": "get_weather",
                "description": "根据城市名称查询该城市当日天气（含温度、天气状况）",
                "parameters": {
                    "type": "object",
                    "properties": {
                        "location": {
                            "type": "string",
                            "description": "城市名称，如北京、上海（仅支持国内地级市）"
                        }
                    },
                    "required": ["location"]
                }
            }
        ],
        "context_management": {
            "edits": [
                {
                    "type": "clear_tool_uses",
                    "trigger": {
                        "type": "tool_uses",
                        "value": 5
                    }
                }
            ]
        }
    }'
```

<span id="f11b5c06"></span>
# 组合策略

可以同时使用思维链内容清除和工具调用内容清除，使用多个策略时：

* 定义顺序：`clear_thinking` 必须排在 `clear_tool_uses` 之前。
* 处理顺序：先处理思维链内容清除，再处理工具调用内容清除。

**选项：Curl**

```Bash
curl https://ark.cn-beijing.volces.com/api/v3/responses \
    -H "Authorization: Bearer $ARK_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
        "model": "doubao-seed-2-0-lite-260215",
        "input": [
            {
                "role": "system",
                "content": "你是人工智能助手."
            },
            {
                "role": "user",
                "content": "今天北京天气怎么样"
            }
        ],
        "thinking":{"type": "enabled"},
        "tools": [
            {
                "type": "function",
                "name": "get_weather",
                "description": "根据城市名称查询该城市当日天气（含温度、天气状况）",
                "parameters": {
                    "type": "object",
                    "properties": {
                        "location": {
                            "type": "string",
                            "description": "城市名称，如北京、上海（仅支持国内地级市）"
                        }
                    },
                    "required": ["location"]
                }
            }
        ],
        "context_management": {
            "edits": [
                {
                    "type": "clear_thinking",
                    "keep": {
                        "type": "thinking_turns",
                        "value": 3
                    }
                },
                {
                    "type": "clear_tool_uses",
                    "trigger": {
                        "type": "tool_uses",
                        "value": 5
                    }
                }
            ]
        }
    }'
```