> ## Documentation Index
> Fetch the complete documentation index at: https://docs.memorylake.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# 列出 Agent 版本
> 返回指定 Agent 的分页版本列表
```
GET /openapi/memorylake/api/v3/agents/{id}/versions
```
返回指定 Agent 所有版本的分页列表，按版本号排序。每个版本捕获了创建时 Agent 配置的快照。
**所需权限：** `agent:version_list`
### 路径参数
Agent 标识符
### 查询参数
每页返回的版本数量
上一次响应中的 token，用于获取下一页结果
```bash cURL theme={null}
curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/agents/agt_r8k2m1n3/versions?page_size=10' \
-H 'Authorization: Bearer sk_xxxxxx'
```
### 响应
Agent 版本对象数组
版本号
此版本使用的模型
能力标识符列表
此版本的执行策略
每次运行的最大对话轮次数
每轮的最大工具调用次数
Agent 可调用的工具白名单
Agent 不可调用的工具黑名单
子 Agent 在被取消前可运行的最大秒数
可同时运行的最大子 Agent 数量
此版本的输出配置
输出模式
结构化输出的 JSON Schema
此版本中的子 Agent 定义
子 Agent 名称
子 Agent 的执行模式
传递给子 Agent 的上下文指令
子 Agent 是否继承父 Agent 的工具
此版本中的技能
技能标识符
技能版本号
父 Agent 标识符
此版本使用的系统提示词
此版本的模型特定设置
此版本的运行时绑定配置
版本创建时间戳
用于获取下一页结果的 token。当没有更多页时不返回。
```json Success (200) theme={null}
{
"success": true,
"data": {
"items": [
{
"version": 3,
"model": "gpt-4o",
"capabilities": ["tool_use", "memory_read", "memory_write"],
"policies": {
"max_turns": 20,
"max_tool_calls": 10,
"allow_tools": ["search_kb", "create_ticket"],
"deny_tools": [],
"subagent_timeout": 300,
"subagent_max_concurrency": 3
},
"output": {
"mode": "text",
"json_schema": null
},
"subagents": [
{
"name": "ticket-creator",
"mode": "delegate",
"context": "Create support tickets from conversation context",
"inherit_tools": false
}
],
"skills": [
{
"skill_id": "skl_kb_search",
"skill_version": 2
}
],
"agent_id": "agt_r8k2m1n3",
"system_prompt": "You are a helpful support assistant. Use the knowledge base to answer questions accurately.",
"model_settings": {
"temperature": 0.7,
"max_tokens": 4096
},
"runtime_bindings": {
"knowledge_base": "kb_prod_docs"
},
"created_at": "2025-04-22T14:30:00Z"
},
{
"version": 2,
"model": "gpt-4o",
"capabilities": ["tool_use", "memory_read"],
"policies": {
"max_turns": 15,
"max_tool_calls": 8,
"allow_tools": ["search_kb"],
"deny_tools": [],
"subagent_timeout": 300,
"subagent_max_concurrency": 2
},
"output": {
"mode": "text",
"json_schema": null
},
"subagents": [],
"skills": [
{
"skill_id": "skl_kb_search",
"skill_version": 1
}
],
"agent_id": "agt_r8k2m1n3",
"system_prompt": "You are a helpful support assistant.",
"model_settings": {
"temperature": 0.7,
"max_tokens": 2048
},
"runtime_bindings": {
"knowledge_base": "kb_prod_docs"
},
"created_at": "2025-03-25T11:00:00Z"
}
],
"continuation_token": null
}
}
```