{"@context": "https://schema.org", "@type": "AnalysisNewsArticle", "inLanguage": "zh-CN", "identifier": "agent-research-20260911-0313-1197", "headline": "Agent SDK 扩展接口、工具权限与密钥到期控制：接入之后如何约束执行", "description": "OpenAI、Anthropic 的 SDK 更新和 AWS 工具包修复分别涉及接口、工具权限、凭证与校验。它们处理的是不同环节；能否改善实际运行，还要看应用如何接入这些控制，以及失败时如何处理。[S2][S3][S5][S7][S8]", "abstract": "OpenAI 的 Python SDK 增加了 Agents API、异步流清理入口和服务账户密钥到期控制；Anthropic 增加了托管 Agent 工具权限模式与抓取错误码；AWS 工具包修复了自动管理执行角色的信任策略校验，并增加记忆字段输入校验。[S2][S7][S8][S3][S5]这些变化可以按接入、执行、身份和可追溯性分别比较，但不能用发布数量给产品成熟度排序。接口支持、控制生效和运行结果是三个不同层次。后续评估宜围绕具体任务，分别测试越权阻断、凭证失效、异常清理和执行记录完整性，而不是预设新增控制必然降低风险。", "datePublished": "2026-09-11T03:13:03+00:00", "dateModified": "2026-09-11T03:13:43+00:00", "author": {"@type": "Person", "name": "Aperture 研究编辑部", "jobTitle": "比较技术与产业研究 · Evidence Verifier"}, "about": ["Agent运行时", "工具执行", "证据治理", "机器身份", "权限控制", "比较研究"], "category": "Agent 技术", "authorityScore": 88, "claims": [{"text": "本文把 Agent 理解为能够调用工具并推进任务的智能体，把“运行时”理解为承载任务状态、工具调用和资源生命周期的执行环境，而不是某一个产品名称。判断它是否适合某项业务，可以从几个具体问题入手：任务怎样开始和结束，工具调用怎样被允许或拒绝，程序以谁的身份行动，事后能否解释一次执行为什么发生。", "section": "先比较控制了什么，再比较发布了什么"}, {"text": "比较采用四项标准：接入与生命周期是否明确，工具执行边界是否可处理，机器身份是否受到约束，执行记录是否足以追溯。每一项再区分三个层次：接口里出现了控制项，控制项实际生效，以及它改善了运行结果。下文的发布记录主要支持第一个层次，部分描述了校验或清理机制，但没有给出可用于横向排序的运行结果。[S2][S3][S5][S7][S8][S10]", "section": "先比较控制了什么，再比较发布了什么"}, {"text": "样本同时包含 Python SDK、命令行工具和部署工具包，它们涉及的工程对象不同。[S2][S3][S4][S5]因此，本文比较具体变更的作用位置，而不把发布条目多少当作公司成熟度，也不将客户端版本日期直接视为服务端能力首次可用的日期。", "section": "先比较控制了什么，再比较发布了什么"}, {"text": "下表把功能名称转成实际判断问题。“工程含义”是对变更用途的解释，不代表已经验证的部署效果。", "section": "同一条执行链，不同变更各管一段"}, {"text": "OpenAI 的记录涉及 Agent 接口、Live API、异步流清理和事件字段修正；Anthropic 的记录则涉及托管 Agent 工具权限模式和网页抓取错误码。[S2][S7][S10][S3]前一组覆盖入口、生命周期和事件表达，后一组涉及工具授权模式与一种具体失败类型。这是这些发布条目的差异，不代表两家公司完整架构的分野。", "section": "接口与错误信号如何变成可用的执行控制"}, {"text": "关闭流和识别错误不是同一件事。aclose() 是新增的异步流清理入口；content_too_large 是新增的网页抓取错误码。[S7][S3]如果应用在任务结束或异常退出时正确调用清理入口，它就可以利用这一方法执行流清理；如果应用识别内容过大的错误，也可以据此设计停止、调整请求或转交人工的分支。具体采用哪条路径，仍取决于应用设计和工具允许的操作。错误码本身不会决定恢复策略，关闭方法的存在也不等于所有异常路径都会调用它。", "section": "接口与错误信号如何变成可用的执行控制"}, {"text": "这给选型提出了比“是否支持 Agent”更具体的问题：任务被取消、输入超限或权限不足时，系统会怎样处理？如果业务主要需要统一接入，接口覆盖可以是优先项；如果工具调用会产生难以撤销的外部动作，就应优先检查授权规则，以及失败后是否还会继续执行。这是按使用条件提出的评估建议，不是发布记录所证明的性能差异。", "section": "接口与错误信号如何变成可用的执行控制"}, {"text": "本文用“机器身份”指程序使用的身份及其凭证。OpenAI 的变更针对服务账户密钥有效期，AWS 的变更针对自动管理执行角色的信任策略校验，Anthropic 则增加了工具权限模式。[S8][S9][S5][S3]可以用三个问题理解它们各自的用途：这份凭证还能用多久，谁可以使用这个角色，当前工具动作是否被允许。具体规则仍须分别检查，不能由功能名称推定。", "section": "机器身份管凭证和角色，工具权限管具体动作"}, {"text": "在系统设计中，这些控制适合被当作互补检查，而不是替代方案。如果泄露的凭证确实按到期时间失效，那么它通过该凭证继续访问的时间窗口会受到限制；但到期机制本身不能判断有效期内的一次操作是否合适。反过来，即使工具权限规则足够细，如果身份识别或角色使用关系出错，也可能把权限授予错误的执行者。因此，凭证失效、角色信任关系与具体动作授权应分别测试。", "section": "机器身份管凭证和角色，工具权限管具体动作"}, {"text": "服务账户密钥到期控制不等于每个 Agent、每次任务或每个委派步骤都有独立身份；相关记录只描述了到期字段与控制。[S9][S8]同样，auto 模式的名称并不说明其审批、继承或拒绝规则。[S3]更有用的工程验收，是要求演示凭证到期后任务如何处理、角色使用被拒绝后是否停止；如果系统支持任务委派，还应测试权限约束能否在委派后保持，而不是直接把这些更新称为完整的机器身份治理。", "section": "机器身份管凭证和角色，工具权限管具体动作"}, {"text": "本文将“证据治理”用作一项评估标准：一次执行的输入、授权依据、工具结果和最终输出，能否被保存、对应和复查。提示缓存诊断、函数参数完成事件字段修正，以及抓取工具的明确错误码，分别涉及诊断、事件表达和失败识别。[S10][S3]如果应用采集这些信息，它们可能成为排查过程的一部分；但要重建整条执行链，还需要把记录关联到同一次任务及当时的身份与权限。单独增加字段或错误码，不等于完成这种关联。", "section": "可诊断不等于可追溯，执行记录还要关联输入、授权与结果"}, {"text": "以抓取内容过大为例，新增错误码描述了一种失败类型，却不说明应用最终如何处理缺失内容。[S3]验收时可以故意触发这一错误，检查最终回答是否明确区分“读取成功”和“抓取失败”。同理，AWS 的记录描述了记忆字段输入校验，而非记忆内容的真实性验证。[S5]因此，输入是否符合接口要求、工具是否按规则执行、输出是否有可靠依据，宜分开检查。", "section": "可诊断不等于可追溯，执行记录还要关联输入、授权与结果"}, {"text": "一个具体的验收办法，是尝试重建一条执行链：当时收到什么输入，哪个身份获得什么权限，实际调用了什么工具，返回的是结果还是错误，最终回答使用了哪些内容。如果关键记录无法对应，就不能仅凭诊断功能的存在判断系统已经可追溯。这是一项建议的标准，不是上述产品已经实现的能力。", "section": "可诊断不等于可追溯，执行记录还要关联输入、授权与结果"}, {"text": "一种替代解释是，这批变化可能部分反映 SDK 对 API 定义的同步，而不是服务端在同一时间发生了等量变化。OpenAI 和 Anthropic 的多项功能记录归在 api 分类下；密钥到期相关变更也分别表述为字段增加和控制增加。[S2][S3][S9][S8]这些表述本身不能确定客户端与服务端的变化关系。因此，把相邻版本中的相关条目算作彼此独立的技术突破，可能重复计算。", "section": "发布密度也可能来自接口同步，而非运行能力跃迁"}, {"text": "另一种可能是，维护活动改善了接口表达或使用方式，却没有明显改变某项业务结果。事件字段修正和清理方法增加有明确的修改对象，但实际效果还取决于调用代码、异常路径和部署条件。[S10][S7]AWS 的信任策略校验修复也不能说明所有既有部署都已应用该变化。[S5]评价这些更新的价值，仍需检查哪些路径受到了影响，以及影响是否到达实际运行环节。", "section": "发布密度也可能来自接口同步，而非运行能力跃迁"}, {"text": "理论研究也需要单独看待。关于截断噪声最优响应算法的论文，讨论的是以次模最大化为目标的多智能体协调问题，以及相应博弈中的均衡性质。[S6]这里的 Agent 是特定数学模型中的决策主体，不能直接等同于调用网页、程序或云资源的语言模型 Agent。即使某种算法在其假设下具有安全性质，也不能据此替代对身份冒用、权限错误或外部工具失败的工程测试。", "section": "发布密度也可能来自接口同步，而非运行能力跃迁"}, {"text": "这些发布记录支持的结论是：客户端接口、异步流清理、工具权限、密钥到期和角色校验都有具体变更。[S2][S3][S5][S7][S8][S10]它们为评估执行控制提供了不同切入点，却不说明哪条产品路线已经胜出。对使用者而言，更合适的比较单位是一条端到端任务：能否正确接入、执行、停止，并留下足以复查的记录。", "section": "下一轮比较，应看控制项是否改变同一任务的结果"}, {"text": "后续测试可以固定任务、工具、预期授权规则和部署条件，每次只改变一个待测控制项或接入方式。工具权限测试记录不被允许的动作是否实际执行；密钥测试检查到期后是否仍能通过该密钥成功调用；清理测试检查取消或异常退出后相关资源是否释放；追溯测试则检查输入、授权、工具返回和最终输出能否对应。这些指标用于检验效果，不预设更新后必然改善，也不要求某一项控制同时改善所有指标。", "section": "下一轮比较，应看控制项是否改变同一任务的结果"}, {"text": "测试还应记录合法任务被误拒绝、额外人工介入和恢复耗时，避免把“全部拒绝”误认成可靠性提升。如果结果没有变化，应检查是应用没有接入控制、测试没有覆盖相关路径，还是该变更对目标任务没有明显作用。如果改善只在某类任务中出现，结论也应限于该类任务和配置。只有对照结果支持，才能进一步判断这些接口与校验更新是否转化成了更可控的执行。", "section": "下一轮比较，应看控制项是否改变同一任务的结果"}], "sections": [{"type": "lead", "heading": "先比较控制了什么，再比较发布了什么", "paragraphs": ["本文把 Agent 理解为能够调用工具并推进任务的智能体，把“运行时”理解为承载任务状态、工具调用和资源生命周期的执行环境，而不是某一个产品名称。判断它是否适合某项业务，可以从几个具体问题入手：任务怎样开始和结束，工具调用怎样被允许或拒绝，程序以谁的身份行动，事后能否解释一次执行为什么发生。", "比较采用四项标准：接入与生命周期是否明确，工具执行边界是否可处理，机器身份是否受到约束，执行记录是否足以追溯。每一项再区分三个层次：接口里出现了控制项，控制项实际生效，以及它改善了运行结果。下文的发布记录主要支持第一个层次，部分描述了校验或清理机制，但没有给出可用于横向排序的运行结果。[S2][S3][S5][S7][S8][S10]", "样本同时包含 Python SDK、命令行工具和部署工具包，它们涉及的工程对象不同。[S2][S3][S4][S5]因此，本文比较具体变更的作用位置，而不把发布条目多少当作公司成熟度，也不将客户端版本日期直接视为服务端能力首次可用的日期。"]}, {"type": "evidence", "heading": "同一条执行链，不同变更各管一段", "paragraphs": ["下表把功能名称转成实际判断问题。“工程含义”是对变更用途的解释，不代表已经验证的部署效果。"], "headers": ["比较维度", "可直接确认的变更", "工程含义", "不能据此推出什么"], "rows": [["Agent 接入", "OpenAI Python SDK v3.13.0 增加 Agents API。[S2]", "客户端增加了面向 Agent 的接口入口。", "不能推出任务持久化、恢复或隔离机制已经完备。"], ["生命周期与诊断", "OpenAI Python SDK v3.12.0 增加 Live API，并为 AsyncStream 增加 aclose()；v3.9.0 增加提示缓存诊断并修正函数参数完成事件字段。[S7][S10]", "变更涉及异步流关闭、诊断信息和事件表达。", "不能把接口修正直接当作资源泄漏减少或审计记录完整的证明。"], ["工具执行边界", "Anthropic Python SDK v1.5.0 增加 Managed Agents 的 auto 模式工具权限，以及 web_fetch 的 content_too_large 错误码。[S3]", "权限模式与内容过大这一失败类型进入接口表达。", "不能从 auto 名称判断具体放行规则，也不能认定失败后会自动安全恢复。"], ["凭证生命周期", "OpenAI Python SDK v3.10.0 增加服务账户 API 密钥到期字段，v3.11.0 增加到期控制。[S9][S8]", "服务账户密钥的有效期在接口中有了相应字段和控制。", "不能推出默认有效期、自动轮换或每个 Agent 都拥有独立身份。"], ["执行角色与输入", "AWS Bedrock AgentCore Starter Toolkit v0.3.12 修复自动管理执行角色的信任策略校验，并增加记忆字段输入校验。[S5]", "检查对象包括角色信任策略和记忆字段输入。", "不能推出所有工具权限均已收紧，也不能认定输入内容具有事实可信度。"], ["发布状态", "Google Gemini CLI 的该条目为 nightly 预发布，正文仅列出完整变更比较链接。[S4]", "条目支持判断发布状态，不足以评价具体执行控制。", "不能从该条目推断新增能力、稳定性或安全性。"]]}, {"type": "analysis", "heading": "接口与错误信号如何变成可用的执行控制", "paragraphs": ["OpenAI 的记录涉及 Agent 接口、Live API、异步流清理和事件字段修正；Anthropic 的记录则涉及托管 Agent 工具权限模式和网页抓取错误码。[S2][S7][S10][S3]前一组覆盖入口、生命周期和事件表达，后一组涉及工具授权模式与一种具体失败类型。这是这些发布条目的差异，不代表两家公司完整架构的分野。", "关闭流和识别错误不是同一件事。aclose() 是新增的异步流清理入口；content_too_large 是新增的网页抓取错误码。[S7][S3]如果应用在任务结束或异常退出时正确调用清理入口，它就可以利用这一方法执行流清理；如果应用识别内容过大的错误，也可以据此设计停止、调整请求或转交人工的分支。具体采用哪条路径，仍取决于应用设计和工具允许的操作。错误码本身不会决定恢复策略，关闭方法的存在也不等于所有异常路径都会调用它。", "这给选型提出了比“是否支持 Agent”更具体的问题：任务被取消、输入超限或权限不足时，系统会怎样处理？如果业务主要需要统一接入，接口覆盖可以是优先项；如果工具调用会产生难以撤销的外部动作，就应优先检查授权规则，以及失败后是否还会继续执行。这是按使用条件提出的评估建议，不是发布记录所证明的性能差异。"]}, {"type": "mechanism", "heading": "机器身份管凭证和角色，工具权限管具体动作", "paragraphs": ["本文用“机器身份”指程序使用的身份及其凭证。OpenAI 的变更针对服务账户密钥有效期，AWS 的变更针对自动管理执行角色的信任策略校验，Anthropic 则增加了工具权限模式。[S8][S9][S5][S3]可以用三个问题理解它们各自的用途：这份凭证还能用多久，谁可以使用这个角色，当前工具动作是否被允许。具体规则仍须分别检查，不能由功能名称推定。", "在系统设计中，这些控制适合被当作互补检查，而不是替代方案。如果泄露的凭证确实按到期时间失效，那么它通过该凭证继续访问的时间窗口会受到限制；但到期机制本身不能判断有效期内的一次操作是否合适。反过来，即使工具权限规则足够细，如果身份识别或角色使用关系出错，也可能把权限授予错误的执行者。因此，凭证失效、角色信任关系与具体动作授权应分别测试。", "服务账户密钥到期控制不等于每个 Agent、每次任务或每个委派步骤都有独立身份；相关记录只描述了到期字段与控制。[S9][S8]同样，auto 模式的名称并不说明其审批、继承或拒绝规则。[S3]更有用的工程验收，是要求演示凭证到期后任务如何处理、角色使用被拒绝后是否停止；如果系统支持任务委派，还应测试权限约束能否在委派后保持，而不是直接把这些更新称为完整的机器身份治理。"]}, {"type": "analysis", "heading": "可诊断不等于可追溯，执行记录还要关联输入、授权与结果", "paragraphs": ["本文将“证据治理”用作一项评估标准：一次执行的输入、授权依据、工具结果和最终输出，能否被保存、对应和复查。提示缓存诊断、函数参数完成事件字段修正，以及抓取工具的明确错误码，分别涉及诊断、事件表达和失败识别。[S10][S3]如果应用采集这些信息，它们可能成为排查过程的一部分；但要重建整条执行链，还需要把记录关联到同一次任务及当时的身份与权限。单独增加字段或错误码，不等于完成这种关联。", "以抓取内容过大为例，新增错误码描述了一种失败类型，却不说明应用最终如何处理缺失内容。[S3]验收时可以故意触发这一错误，检查最终回答是否明确区分“读取成功”和“抓取失败”。同理，AWS 的记录描述了记忆字段输入校验，而非记忆内容的真实性验证。[S5]因此，输入是否符合接口要求、工具是否按规则执行、输出是否有可靠依据，宜分开检查。", "一个具体的验收办法，是尝试重建一条执行链：当时收到什么输入，哪个身份获得什么权限，实际调用了什么工具，返回的是结果还是错误，最终回答使用了哪些内容。如果关键记录无法对应，就不能仅凭诊断功能的存在判断系统已经可追溯。这是一项建议的标准，不是上述产品已经实现的能力。"]}, {"type": "counterargument", "heading": "发布密度也可能来自接口同步，而非运行能力跃迁", "paragraphs": ["一种替代解释是，这批变化可能部分反映 SDK 对 API 定义的同步，而不是服务端在同一时间发生了等量变化。OpenAI 和 Anthropic 的多项功能记录归在 api 分类下；密钥到期相关变更也分别表述为字段增加和控制增加。[S2][S3][S9][S8]这些表述本身不能确定客户端与服务端的变化关系。因此，把相邻版本中的相关条目算作彼此独立的技术突破，可能重复计算。", "另一种可能是，维护活动改善了接口表达或使用方式，却没有明显改变某项业务结果。事件字段修正和清理方法增加有明确的修改对象，但实际效果还取决于调用代码、异常路径和部署条件。[S10][S7]AWS 的信任策略校验修复也不能说明所有既有部署都已应用该变化。[S5]评价这些更新的价值，仍需检查哪些路径受到了影响，以及影响是否到达实际运行环节。", "理论研究也需要单独看待。关于截断噪声最优响应算法的论文，讨论的是以次模最大化为目标的多智能体协调问题，以及相应博弈中的均衡性质。[S6]这里的 Agent 是特定数学模型中的决策主体，不能直接等同于调用网页、程序或云资源的语言模型 Agent。即使某种算法在其假设下具有安全性质，也不能据此替代对身份冒用、权限错误或外部工具失败的工程测试。"]}, {"type": "outlook", "heading": "下一轮比较，应看控制项是否改变同一任务的结果", "paragraphs": ["这些发布记录支持的结论是：客户端接口、异步流清理、工具权限、密钥到期和角色校验都有具体变更。[S2][S3][S5][S7][S8][S10]它们为评估执行控制提供了不同切入点，却不说明哪条产品路线已经胜出。对使用者而言，更合适的比较单位是一条端到端任务：能否正确接入、执行、停止，并留下足以复查的记录。", "后续测试可以固定任务、工具、预期授权规则和部署条件，每次只改变一个待测控制项或接入方式。工具权限测试记录不被允许的动作是否实际执行；密钥测试检查到期后是否仍能通过该密钥成功调用；清理测试检查取消或异常退出后相关资源是否释放；追溯测试则检查输入、授权、工具返回和最终输出能否对应。这些指标用于检验效果，不预设更新后必然改善，也不要求某一项控制同时改善所有指标。", "测试还应记录合法任务被误拒绝、额外人工介入和恢复耗时，避免把“全部拒绝”误认成可靠性提升。如果结果没有变化，应检查是应用没有接入控制、测试没有覆盖相关路径，还是该变更对目标任务没有明显作用。如果改善只在某类任务中出现，结论也应限于该类任务和配置。只有对照结果支持，才能进一步判断这些接口与校验更新是否转化成了更可控的执行。"]}], "citations": [{"publisher": "NIST", "title": "AI Risk Management Framework", "url": "https://www.nist.gov/itl/ai-risk-management-framework", "published_at": "2021-07-12T18:09:00Z", "source_type": "webPage"}, {"publisher": "OpenAI", "title": "v3.13.0", "url": "https://github.com/openai/openai-python/releases/tag/v3.13.0", "published_at": "2026-09-10T19:37:39Z", "source_type": "githubRelease"}, {"publisher": "Anthropic", "title": "v1.5.0", "url": "https://github.com/anthropics/anthropic-sdk-python/releases/tag/v1.5.0", "published_at": "2026-09-10T17:45:22Z", "source_type": "githubRelease"}, {"publisher": "Google", "title": "Release v0.61.0-nightly.20260911.ged2ac40df", "url": "https://github.com/google-gemini/gemini-cli/releases/tag/v0.61.0-nightly.20260911.ged2ac40df", "published_at": "2026-09-11T01:25:36Z", "source_type": "githubRelease"}, {"publisher": "AWS", "title": "Bedrock AgentCore Starter Toolkit v0.3.12", "url": "https://github.com/aws/bedrock-agentcore-starter-toolkit/releases/tag/v0.3.12", "published_at": "2026-08-19T23:49:46Z", "source_type": "githubRelease"}, {"publisher": "arXiv", "title": "Truncated Noisy Best-Response Algorithms: Toward Game Theoretic Learning with Safety Guarantees", "url": "https://arxiv.org/abs/2609.11863v1", "published_at": "2026-09-10T17:41:49Z", "source_type": "arxivPaper"}, {"publisher": "OpenAI", "title": "v3.12.0", "url": "https://github.com/openai/openai-python/releases/tag/v3.12.0", "published_at": "2026-09-10T17:28:42Z", "source_type": "githubRelease"}, {"publisher": "OpenAI", "title": "v3.11.0", "url": "https://github.com/openai/openai-python/releases/tag/v3.11.0", "published_at": "2026-09-09T15:31:33Z", "source_type": "githubRelease"}, {"publisher": "OpenAI", "title": "v3.10.0", "url": "https://github.com/openai/openai-python/releases/tag/v3.10.0", "published_at": "2026-09-09T00:17:39Z", "source_type": "githubRelease"}, {"publisher": "OpenAI", "title": "v3.9.0", "url": "https://github.com/openai/openai-python/releases/tag/v3.9.0", "published_at": "2026-09-08T16:42:27Z", "source_type": "githubRelease"}], "knowledge": {"question": {"en": "What do Agent SDK interfaces, tool permissions, and credential-expiration controls actually constrain, and how should their runtime effects be tested?", "zh": "Agent SDK 接口、工具权限与凭证到期控制实际约束什么，应如何测试它们在运行中的效果？"}, "audience": {"en": "Engineers and technical evaluators integrating Agents that call tools or cloud resources, especially those responsible for authorization, credential handling, cancellation, and execution records.", "zh": "接入会调用工具或云资源的 Agent 的工程师与技术评估者，尤其是负责授权、凭证处理、任务取消和执行记录的人员。"}, "decision": {"en": "Choose controls by the task's execution boundaries rather than release counts. Test unauthorized-action blocking, expired-key rejection, cleanup after cancellation or exceptions, and record linkage separately; also measure false rejections, human intervention, and recovery time.", "zh": "按任务的执行边界而非发布数量选择控制项。分别测试越权动作阻断、到期密钥拒绝、取消或异常后的清理，以及记录关联；同时记录误拒绝、人工介入和恢复耗时。"}, "contribution": {"en": "The article separates interface availability, effective enforcement, and improved runtime outcomes. It locates OpenAI, Anthropic, and AWS changes at different points in execution and proposes controlled, end-to-end task tests instead of a product-maturity ranking.", "zh": "文章区分接口提供控制项、控制实际生效和运行结果改善三个层次，将 OpenAI、Anthropic 与 AWS 的变更定位到执行链的不同环节，并提出端到端任务对照测试，而不是给产品成熟度排序。"}, "limitation": {"en": "The release records mainly establish interface changes, not comparative deployment outcomes. They do not establish auto-mode authorization rules, automatic credential rotation, independent Agent identities, complete traceability, or guaranteed risk reduction. The map below selects credential expiration and stream cleanup, with tool permissions as a complementary control.", "zh": "发布记录主要证明接口变更，而非可横向比较的部署结果。它们不能证明 auto 模式的授权规则、凭证自动轮换、Agent 独立身份、完整可追溯性或必然的风险降低。下图选取凭证到期与流清理，并以工具权限作为互补控制。"}, "nodes": [{"key": "n1", "kind": "entity", "name": {"en": "OpenAI Python SDK", "zh": "OpenAI Python SDK"}, "mention": "OpenAI Python SDK", "id": "entity-a7f2e9f1b9f3b3819842"}, {"key": "n2", "kind": "concept", "name": {"en": "Service-account API key expiration controls", "zh": "服务账户 API 密钥到期控制"}, "mention": "服务账户密钥到期控制", "id": "concept-a2dc7d5500b86c6021e0"}, {"key": "n3", "kind": "concept", "name": {"en": "Continued-access window through a leaked credential", "zh": "通过泄露凭证继续访问的时间窗口"}, "mention": "通过该凭证继续访问的时间窗口", "id": "concept-3a5dfc325fcbf5e19b38"}, {"key": "n4", "kind": "entity", "name": {"en": "AsyncStream.aclose()", "zh": "AsyncStream.aclose()"}, "mention": "aclose()", "id": "entity-4f50f0df12adf235910e"}, {"key": "n5", "kind": "concept", "name": {"en": "Asynchronous stream cleanup", "zh": "异步流清理"}, "mention": "异步流清理", "id": "concept-42e803bcf14214834e71"}, {"key": "n6", "kind": "concept", "name": {"en": "Tool permissions", "zh": "工具权限"}, "mention": "工具权限", "id": "concept-ef0b3470f96657bcd45a"}], "edges": [{"source": "n1", "target": "n2", "relation": "changes", "stance": "reported", "explanation": {"en": "The article reports expiration fields in v3.10.0 and expiration controls in v3.11.0. This establishes SDK support, not default lifetimes or automatic rotation.", "zh": "文章报告 v3.10.0 增加到期字段、v3.11.0 增加到期控制。这证明 SDK 提供了相应支持，不证明默认有效期或自动轮换。"}, "quote": {"en": "OpenAI Python SDK v3.10.0 adds service-account API key expiration fields, and v3.11.0 adds expiration controls.[S9][S8]", "zh": "OpenAI Python SDK v3.10.0 增加服务账户 API 密钥到期字段，v3.11.0 增加到期控制。[S9][S8]"}, "citations": [9, 8], "sourceId": "entity-a7f2e9f1b9f3b3819842", "targetId": "concept-a2dc7d5500b86c6021e0"}, {"source": "n2", "target": "n3", "relation": "constrains", "stance": "hypothesis", "explanation": {"en": "Expiration limits continued access through a leaked credential only if that credential actually becomes invalid at expiration. It does not assess whether an action during the valid period is appropriate.", "zh": "只有泄露凭证确实按期失效，到期机制才会限制通过该凭证继续访问的时间；它不能判断有效期内的操作是否合适。"}, "quote": {"en": "If a leaked credential does indeed become invalid at its expiration time, the window for continued access through that credential will be limited; but the expiration mechanism itself cannot determine whether an operation during the validity period is appropriate.", "zh": "如果泄露的凭证确实按到期时间失效，那么它通过该凭证继续访问的时间窗口会受到限制；但到期机制本身不能判断有效期内的一次操作是否合适。"}, "citations": [9, 8], "sourceId": "concept-a2dc7d5500b86c6021e0", "targetId": "concept-3a5dfc325fcbf5e19b38"}, {"source": "n1", "target": "n4", "relation": "changes", "stance": "reported", "explanation": {"en": "Version 3.12.0 adds aclose() to AsyncStream. The existence of this cleanup entry point is distinct from evidence that applications invoke it on every exception path.", "zh": "v3.12.0 为 AsyncStream 增加 aclose()。存在这一清理入口，不等于应用会在每条异常路径调用它。"}, "quote": {"en": "OpenAI Python SDK v3.12.0 adds the Live API and adds aclose() to AsyncStream; v3.9.0 adds prompt-cache diagnostics and corrects function-argument completion event fields.[S7][S10]", "zh": "OpenAI Python SDK v3.12.0 增加 Live API，并为 AsyncStream 增加 aclose()；v3.9.0 增加提示缓存诊断并修正函数参数完成事件字段。[S7][S10]"}, "citations": [7, 10], "sourceId": "entity-a7f2e9f1b9f3b3819842", "targetId": "entity-4f50f0df12adf235910e"}, {"source": "n4", "target": "n5", "relation": "enables", "stance": "hypothesis", "explanation": {"en": "The application can use aclose() for stream cleanup if it correctly invokes the entry point when a task ends or exits abnormally. This is conditional application behavior, not a measured reduction in resource leaks.", "zh": "如果应用在任务结束或异常退出时正确调用入口，就可以用 aclose() 清理流。这是有条件的应用行为，不是已经测得的资源泄漏减少。"}, "quote": {"en": "If the application correctly calls the cleanup entry point when a task ends or exits abnormally, it can use this method to perform stream cleanup;", "zh": "如果应用在任务结束或异常退出时正确调用清理入口，它就可以利用这一方法执行流清理；"}, "citations": [7], "sourceId": "entity-4f50f0df12adf235910e", "targetId": "concept-42e803bcf14214834e71"}, {"source": "n2", "target": "n6", "relation": "compares", "stance": "analysis", "explanation": {"en": "The author distinguishes credential lifetime from permission for a particular tool action. These are separate checks, not interchangeable controls; their concrete rules cannot be inferred from feature names.", "zh": "作者将凭证有效期与具体工具动作是否获准区分开来。两者是不同检查，不能相互替代，也不能从功能名称推定具体规则。"}, "quote": {"en": "OpenAI's changes concern service-account key validity periods, AWS's changes concern trust-policy validation for automatically managed execution roles, while Anthropic adds a tool-permission mode.[S8][S9][S5][S3] Their respective purposes can be understood through three questions: how much longer can this credential be used, who can use this role, and is the current tool action permitted? The specific rules still need to be checked separately and cannot be inferred from feature names.", "zh": "OpenAI 的变更针对服务账户密钥有效期，AWS 的变更针对自动管理执行角色的信任策略校验，Anthropic 则增加了工具权限模式。[S8][S9][S5][S3]可以用三个问题理解它们各自的用途：这份凭证还能用多久，谁可以使用这个角色，当前工具动作是否被允许。具体规则仍须分别检查，不能由功能名称推定。"}, "citations": [8, 9, 5, 3], "sourceId": "concept-a2dc7d5500b86c6021e0", "targetId": "concept-ef0b3470f96657bcd45a"}]}, "knowledgeMap": "/zh/knowledge", "license": {"model": "open", "price": 0.002, "currency": "USDC", "paymentProtocol": "x402", "network": "eip155:84532", "payTo": "0x23a885262A89c32eB582f4439184769dA22c467c", "variants": {"A": "/agent/v1/articles/agent-research-20260911-0313-1197?lang=zh", "B": "/agent/v1/articles/agent-research-20260911-0313-1197/paid?lang=zh"}}, "accessVariant": "A", "contentPolicy": {"citationAllowed": true, "attributionRequired": true, "trainingUse": "contact publisher"}}