方法介绍
list_setting_logs 用于查询 Prompt 的应用、替换和清除日志，便于审计 Prompt 设置变更历史。功能说明如下：变更审计：记录所有 Prompt 设置的应用、替换、清除操作，支持按操作类型筛选。
时间范围查询：支持指定起止时间查询，时间范围不超过 90 天。
组合筛选：支持按 Prompt ID、团队 ID、Agent ID 等维度筛选。
分页查询：通过
limit 和 offset 参数实现分页，支持自定义排序方向。导入
from tencentdb_agent_memory.v3 import AsyncMemoryPromptClient
方法签名
async def list_setting_logs(self,*,memory_prompt_id: Optional[str] = None,start_time: Optional[str] = None,end_time: Optional[str] = None,team_id: Optional[str] = None,agent_id: Optional[str] = None,action: Optional[str] = None,limit: Optional[int] = None,offset: Optional[int] = None,time_order: Optional[str] = None,) -> Dict[str, Any]
使用示例
from tencentdb_agent_memory.v3 import AsyncMemoryPromptClientclient = AsyncMemoryPromptClient(endpoint="https://memory.tdai.tencentyun.com",api_key="sk-xxxxxxxxxxxxxxxx",service_id="tdai-mem-xxxxxxxx")result = await client.list_setting_logs(memory_prompt_id="mp-550e8400-e29b-41d4-a716-446655440000", # 条件必填，Prompt IDstart_time="2026-08-01T00:00:00+08:00", # 条件必填，查询开始时间end_time="2026-08-17T23:59:59+08:00", # 条件必填，查询结束时间limit=20, # 可选，单次返回最大条数offset=0 # 可选，分页偏移量)for log in result["items"]:print(f"{log['action']}: {log['before_memory_prompt_id']} -> {log['after_memory_prompt_id']}")
请求参数
参数名 | 类型 | 必填 | 描述说明 |
memory_prompt_id | str | 是 | 按变更前或变更后的 Prompt ID 筛选。与 team_id/agent_id 至少提供一个 |
team_id | str | 是 | 团队 ID。与 memory_prompt_id 至少提供一个 |
agent_id | str | 否 | Agent ID。传入时必须同时传 team_id |
action | str | 否 | 按操作类型筛选。取值范围： apply（应用）、replace（替换）、clear（清除） |
start_time | str | 是 | 查询开始时间。格式：ISO 8601，含时区偏移。与 end_time 同时提供；均不提供时默认查询最近 7 天 |
end_time | str | 是 | 查询结束时间。格式：ISO 8601，含时区偏移。与 start_time 同时提供，范围不超过 90 天 |
limit | int | 否 | 单页数量。取值范围：[1, 100]，默认值：20 |
offset | int | 否 | 分页偏移量。最小值：0，默认值：0 |
time_order | str | 否 | 时间排序方向。取值范围： asc（升序）、desc（降序，默认） |
响应示例
{"items": [{"setting_log_id": "psl-001122","target_type": "team","team_id": "team-001","agent_id": null,"layer": "l1","action": "replace","reason": "explicit","before_memory_prompt_id": "mp-old-111","after_memory_prompt_id": "mp-550e8400-e29b-41d4-a716-446655440000","operator_id": "user-001","operated_at_ms": 1723968000000}]}
响应参数说明
参数名 | 类型 | 参数含义 |
items | List[Dict] | 设置日志列表 |
items[].setting_log_id | str | 日志记录唯一标识 ID |
items[].target_type | str | 目标类型： instance、team、agent |
items[].team_id | str | 团队 ID。当 target_type 为 instance 时返回 null |
items[].agent_id | str | Agent ID。当 target_type 非 agent 时返回 null |
items[].layer | str | 涉及的 Memory 层级 |
items[].action | str | 操作动作： apply（首次应用）、replace（替换）、clear（清除） |
items[].reason | str | 触发原因： explicit（用户主动操作）、prompt_delete（Prompt 被删除导致级联清除） |
items[].before_memory_prompt_id | str | 变更前的 Prompt ID（首次应用时为 null） |
items[].after_memory_prompt_id | str | 变更后的 Prompt ID（清除时为 null） |
items[].operator_id | str | 操作人用户 ID（级联清除时可能为 null） |
items[].operated_at_ms | int | 操作时间，Unix 时间戳，单位为毫秒 |
错误码
错误码 | 触发场景 | 处理建议 |
400 | memory_prompt_id 和 team_id 均未提供 | 至少提供其中一个筛选条件 |
400 | 时间范围超过 90 天或格式不正确 | 检查时间参数格式和范围 |
401 | API Key 缺失或格式不正确 | 检查 Bearer Token 配置 |
503 | Prompt 存储服务暂时不可用 | 稍后重试 |
