> ## 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
```
返回你账户中所有 Agent 的分页列表。你可以通过 `name_fuzzy` 按名称搜索，并使用 `page_size` 和 `continuation_token` 控制分页。
**所需权限：** `agent:list`
### 查询参数
每页返回的 Agent 数量
上一次响应中的 token，用于获取下一页结果
按 Agent 名称模糊匹配
```bash cURL theme={null}
curl -X GET 'https://app.memorylake.ai/openapi/memorylake/api/v3/agents?page_size=20' \
-H 'Authorization: Bearer sk_xxxxxx'
```
### 响应
Agent 对象数组
Agent 唯一标识符
Agent 名称
Agent 描述
用于存储 Agent 附加信息的任意键值对
当前活跃版本号
Agent 使用的模型（例如 `gpt-4o`、`claude-sonnet-4-20250514`）
Agent 支持的能力标识符列表
约束 Agent 行为的执行策略
每次运行的最大对话轮次数
每轮的最大工具调用次数
Agent 可调用的工具白名单
Agent 不可调用的工具黑名单
子 Agent 在被取消前可运行的最大秒数
可同时运行的最大子 Agent 数量
Agent 的输出配置
输出模式（例如 `text`、`json`）
当模式为 `json` 时，Agent 输出必须符合的 JSON Schema
附加到此 Agent 的子 Agent 定义
子 Agent 名称
子 Agent 的执行模式
传递给子 Agent 的上下文指令
子 Agent 是否继承父 Agent 的工具
附加到此 Agent 的技能
技能标识符
技能版本号
用于外部系统集成的自定义标识符
与此 Agent 关联的 Actor 标识符
此 Agent 可用的最新版本号
用于指示 Agent 的系统提示词
模型特定设置，如温度和最大 token 数
工具和数据源的运行时绑定配置
创建时间戳
最后更新时间戳
用于获取下一页结果的 token。当没有更多页时不返回。
```json Success (200) theme={null}
{
"success": true,
"data": {
"items": [
{
"id": "agt_r8k2m1n3",
"name": "Support Assistant",
"description": "Handles customer support inquiries using knowledge base",
"metadata": {
"team": "customer-success",
"tier": "production"
},
"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
}
],
"custom_id": "support-assistant-v1",
"actor_id": "act_p4q7w2x9",
"latest_version": 3,
"system_prompt": "You are a helpful support assistant...",
"model_settings": {
"temperature": 0.7,
"max_tokens": 4096
},
"runtime_bindings": {
"knowledge_base": "kb_prod_docs"
},
"created_at": "2025-03-10T09:00:00Z",
"updated_at": "2025-04-22T14:30:00Z"
}
],
"continuation_token": "eyJsYXN0SWQiOiJhZ3RfcjhrMm0xbjMifQ"
}
}
```