代理可以提供一组它们可以操作的模式。模式通常会影响使用的系统提示、工具的可用性以及是否在运行前请求权限。
初始状态
在会话设置期间，代理可以返回它可以操作的模式列表以及当前活动的模式：
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"sessionId": "sess_abc123def456",
"modes": {
"currentModeId": "ask",
"availableModes": [
{
"id": "ask",
"name": "Ask",
"description": "在进行任何更改之前请求权限"
},
{
"id": "architect",
"name": "Architect",
"description": "设计和规划软件系统而不实现"
},
{
"id": "code",
"name": "Code",
"description": "使用完整工具访问权限编写和修改代码"
}
]
}
}
}
SessionModeState
SessionMode
设置当前模式
当前模式可以在会话期间的任何时间点更改，无论代理是空闲还是正在生成响应。
从客户端
通常，客户端向用户显示可用模式，并允许他们更改当前模式，这可以通过调用 session/set_mode 方法来完成。
{
"jsonrpc": "2.0",
"id": 2,
"method": "session/set_mode",
"params": {
"sessionId": "sess_abc123def456",
"modeId": "code"
}
}
要切换到的模式的 ID。必须是 availableModes 中列出的模式之一
从代理
代理也可以更改自己的模式，并通过发送 current_mode_update 会话通知让客户端知道：
{
"jsonrpc": "2.0",
"method": "session/update",
"params": {
"sessionId": "sess_abc123def456",
"update": {
"sessionUpdate": "current_mode_update",
"modeId": "code"
}
}
}
退出计划模式
代理可能切换模式的一个常见情况是在计划/架构模式期间向语言模型提供特殊的”退出模式”工具。当语言模型确定已准备好开始实现解决方案时，可以调用此工具。
此”切换模式”工具通常在运行前请求权限，就像任何其他工具一样：
{
"jsonrpc": "2.0",
"id": 3,
"method": "session/request_permission",
"params": {
"sessionId": "sess_abc123def456",
"toolCall": {
"toolCallId": "call_switch_mode_001",
"title": "准备实现",
"kind": "switch_mode",
"status": "pending",
"content": [
{
"type": "text",
"text": "## 实现计划..."
}
]
},
"options": [
{
"optionId": "code",
"name": "是，并自动接受所有操作",
"kind": "allow_always"
},
{
"optionId": "ask",
"name": "是，并手动接受操作",
"kind": "allow_once"
},
{
"optionId": "reject",
"name": "否，保持在架构模式",
"kind": "reject_once"
}
]
}
}
current_mode_update 通知。
