SuperAPI AI 工具集

integration-tests

测试与质量

查看项目

更新于 10-16 03:05

技能介绍

用途:该技能针对 uv build 产出的 wheel 与源码分发包,在隔离环境中运行面向发布的集成测试套件,用于发布就绪检查与实时 OpenAI 能力验证。

主要能力:安装两种构建产物到独立环境,校验公开导入与可选 extras、OpenAI 模型适配器、托管工具、Realtime 与语音工作流;发布目标还会重建 wheel 与 sdist、创建隔离虚拟环境,并对两种产物执行本地 Docker 安全契约测试。

使用方式:在仓库根目录运行发布命令: env UV_DEFAULT_INDEX=https://pypi.org/simple
OPENAI_AGENTS_INTEGRATION_STRICT=1
OPENAI_AGENTS_INTEGRATION_EXTERNAL_PROVIDERS=1
OPENAI_AGENTS_INTEGRATION_DIRECT_PROVIDERS=0
make integration-tests-release 未指定更窄范围时默认使用该发布配置。标准多提供商网关使用 OpenRouter,仅在用户明确要求时才添加直连提供商。使用已有 OPENAI_API_KEY 与 OPENROUTER_API_KEY,不要打印。严格模式会让缺失必需服务配置直接失败而非跳过。

聚焦命令:仅在用户明确要求缩小范围时使用,如 make integration-tests-packaging、integration-tests-security、integration-tests-core、integration-tests-providers、integration-tests-hosted、integration-tests-realtime、integration-tests-voice、integration-tests-extras。最小 Python 边界示例:OPENAI_AGENTS_INTEGRATION_PYTHON=3.10 make integration-tests-packaging。

限制:隔离环境需从 PyPI 下载可选依赖并连接已配置的 API 提供商;若执行环境需要审批,应请求提权(sandbox_permissions=require_escalated)并重试,再判定是否为 SDK 回归。不要运行 watch 模式、修改源码、创建分支、提交、推送或开 PR。若同时要求预发布检查,先运行 $examples-auto-run 再运行上述命令,并分别报告结果;单独调用本技能不会隐式启动示例套件。报告需给出每个隔离环境的通过、失败、跳过与取消选择计数,并区分产品回归与凭据缺失、托管功能不支持、依赖安装失败及执行环境限制。