SuperAPI AI 工具集

call-adcp-agent

智能体与模型

查看项目

更新于 10-16 06:17

技能介绍

用途:该技能用于指导买家通过 AdCP(Ad Context Protocol)向发布方、SSP 或零售媒体网络发起调用。适用信号包括可用工具列表中出现 get_products、create_media_buy、sync_creatives、get_signals,或 A2A 1.0 Agent Card 在 capabilities.extensions[] 中声明 https://adcontextprotocol.org/extensions/adcp/v3。构建卖家智能体不属于本技能范围。

主要能力:讲解不写在 schema 中的线级不变量,包括跨工具模式、异步流程与错误恢复。发现链条按序进行:先用 Agent Card(A2A)或 tools/list(MCP)获得工具名;再调用 get_adcp_capabilities 了解支持协议、AdCP 主版本与特性开关;若智能体暴露 get_schema(tool_name) 则优先使用,否则使用 SDK 自带 JSON Schema。

必要用法:所有变更类工具必须带 UUID 格式的 idempotency_key。重试时用同一 key 会重放相同响应;换新 key 会产生新操作并可能重复下单;同一 key 配不同规范体返回 IDEMPOTENCY_CONFLICT;首个请求仍在运行时返回 IDEMPOTENCY_IN_FLIGHT 并附带 error.retry_after。account 是 oneOf,只能选一个变体并仅发送其字段,如 {"account_id":"..."} 或 {"brand":{"domain":"..."},"operator":"..."};brand 使用 domain 而非 brand_id。异步返回 status:'submitted' 表示已排队,需用 task_id 轮询 get_task_status。budget 是数字。

限制与注意:错误信封需读取 issues[] 中的 pointer、keyword、variants 恢复;schema_id 与 discriminator 为可选字段。webhook 新集成应省略 authentication,以使用 RFC 9421 签名;authentication 块已弃用并在 AdCP 4.0 移除。A2A Task 的 completed 不等于 AdCP 完成。新流程应使用 format_kind 和可选 format_option_ref,format_id 仅在兼容旧 3.x 对端时使用。具体路径与 SDK 命名以实际 SDK 为准。