路径参数

• id 字符串 必需

  项目 ID

• Workspace_id 字符串 必需

  工作区ID

响应

• 406

  application/json

  application/json 应用程序/vnd.agent-engine-2026-09-20-preview+json

  不支持或格式不正确的API版本、所选已发布合约中不可用的操作或不可接受的表示形式（包括不支持的媒体类型参数或排除的 SSE）。现有的身份验证、授权和速率限制失败优先。

  隐藏响应属性 显示响应属性 对象

  • badRequestDetail 对象

    标准错误模式定义的可选验证详细信息； API协商错误不会发出此字段。

    隐藏 BadRequestDetail 属性 显示 BadRequestDetail 属性 对象

    • 字段 大量[对象]

      验证失败的字段。

      隐藏字段属性 显示字段属性 对象

      字段及其验证失败。

      • 描述 字符串 必需

        人类可读的验证失败。

      • 字段 字符串 必需

        无效请求字段的名称或路径。

  • 详细信息 字符串 必需

    人类可读的错误详细信息。

  • 错误 整型 必需

    HTTP status code.

  • 错误代码 字符串 必需

    机器可读的错误代码。

  • 参数 array[string]

    与错误相关的请求参数名称；不应用时省略。

  • 原因 字符串 必需

    HTTP状态原因短语。

  隐藏响应属性 显示响应属性 对象

  • badRequestDetail 对象

    标准错误模式定义的可选验证详细信息； API协商错误不会发出此字段。

    隐藏 BadRequestDetail 属性 显示 BadRequestDetail 属性 对象

    • 字段 大量[对象]

      验证失败的字段。

      隐藏字段属性 显示字段属性 对象

      字段及其验证失败。

      • 描述 字符串 必需

        人类可读的验证失败。

      • 字段 字符串 必需

        无效请求字段的名称或路径。

  • 详细信息 字符串 必需

    人类可读的错误详细信息。

  • 错误 整型 必需

    HTTP status code.

  • 错误代码 字符串 必需

    机器可读的错误代码。

  • 参数 array[string]

    与错误相关的请求参数名称；不应用时省略。

  • 原因 字符串 必需

    HTTP状态原因短语。

• 200

  应用程序/vnd.agent-engine-2026-09-20-preview+json

  应用程序/vnd.agent-engine-2026-09-20-preview+json application/json

  正常

  隐藏响应属性 显示响应属性 对象

  • aer_http_endpoint 字符串

    AERHTTPEndpoint 是代理沙箱HTTP端点的旧名称。

  • Agent_card 对象
    隐藏 Agent_card 属性 显示agent_card 属性 对象

    • a2a_allowed_callers array[string]

      2AAllowedCallers 限制哪些工作区 ID 可以通过 A2A 调用此代理。空列表表示允许任何调用者。

    • a2a_enabled 布尔

      A2AEnabled 控制此代理是否可供 A2A 调用发现。

    • 能力 array[string]
    • input_modes array[string]

      InputModes 列出代理接受的MIME类型（例如“text/plain”、 “应用程序/json”）。

    • output_modes array[string]

      OutputModes 列出了代理可以生成的MIME类型。

    • 技能 大量[对象]

      技能公布了代理可以执行的离散任务。

      隐藏技能属性 显示技能属性 对象

      • 描述 字符串
      • example_input 字符串
      • example_output 字符串
      • 名称 字符串
    • 总结 字符串
  • agent_grpc_endpoint 字符串
  • agent_http_endpoint 字符串

    AgentHTTPEndpoint 是代理沙箱HTTP端点。与 aer_http_endpoint 的值相同。

  • auto_deploy 布尔

    AutoDeploy 是 ECP 拥有的每应用自动部署开关。 ECP 所有，在每个详细信息 GET 时获取（不会持久保存在网关数据库中）。当 ECP 没有值或无法访问时不存在；用户界面界面将缺席视为关闭。

  • completed_rate 数字
  • created_date 字符串
  • current_deployment_id 字符串
  • current_payload_ref 字符串
  • 描述 字符串
  • 功能 对象
    隐藏要素属性 显示要素属性 对象

    • 护栏 布尔
    • 内存 布尔
    • 操场 布尔

      Playground 报告是否为工作区预配了 Playground用户界面（nil/true = 已预配，当前行为）。如果为 false，则调用者会直接使用调用API 。

    • use_custom_parser 布尔

      UseCustomParser 如果为 true，则使网关在调用流上仅发出代理的输出解析器自定义事件（删除平台框架）。从 AgentEngine 初始化时的代理.yaml 功能中保留。

  • 框架 字符串
  • github_installation_id 整型

    GithubInstallationID 是拥有该存储库的 GitHub 应用安装。 ECP 所有，在每个详细信息 GET 时获取（不会持久保存在网关数据库中），因此它适用于在此字段存在之前创建的工作区。在编辑跟踪的分支时，用户界面需要它来列出存储库的分支。

  • gitops 对象
    隐藏 gitops 属性 显示 gitops 属性 对象

    • 分支 字符串
    • connection_ref 字符串
    • github_installation_id integer(int64)
    • manifest_path 字符串
    • provider 字符串
    • repo_url 字符串
  • id 字符串
  • 实例 对象

    实例报告工作区的实例计数（活动、备用和正在启动）以及从工作区的 OE 单元获取的读取时间。当无法访问 OE 或工作区未以池化方式运行（例如容器模式），则不存在。故意没有任何内部实施命名：这是一个面向客户的字段。

    隐藏实例属性 显示实例属性 对象

    • 活跃的 整型
    • 池化 布尔
    • standby 整型
    • 开始 整型
  • 调用 整型

    滚动 24h窗口的执行指标。所有五个字段都是指针，因此连接线可以区分用户界面需要以不同方式呈现的两种情况：(a) OE指标获取失败（软故障 — 所有五个字段均不存在），或 (b)窗口包含零调用/没有已完成执行次数（调用次数设立为 0，且延迟/速率字段不存在）。用户界面区分“—”和从 "0 incalls"通过调用 != nil。

  • 语言 字符串
  • last_invoked_at string(date-time)
  • metrics_computed_at string(date-time)
  • metrics_window_start string(date-time)
  • 名称 字符串
  • org_id 字符串
  • p95_latency_ms 数字
  • PROJECT_ID 字符串
  • release_mode 字符串

    ReleaseMode 是 ECP 拥有的 Webhook发布策略 ("push" | "tag-release" | "api-only")。在每个详细信息 GET 上获取；当 ECP 没有值或无法访问时不存在。

  • 状态 字符串

    状态是 ECP 拥有的活动/暂停信号。网关在每次详细 GET 时从 ECP 获取 — 它不会在本地持久保存。当 ECP 无法访问时不存在；用户界面界面将缺席视为未暂停。

    取值为 active、paused、error、disconnected 或 deleting。

  • 子目录 字符串
  • updated_date 字符串
  • Workspace_id 字符串
  • Workspace_name 字符串
  隐藏响应属性 显示响应属性 对象

  • aer_http_endpoint 字符串

    AERHTTPEndpoint 是代理沙箱HTTP端点的旧名称。

  • Agent_card 对象
    隐藏 Agent_card 属性 显示agent_card 属性 对象

    • a2a_allowed_callers array[string]

      2AAllowedCallers 限制哪些工作区 ID 可以通过 A2A 调用此代理。空列表表示允许任何调用者。

    • a2a_enabled 布尔

      A2AEnabled 控制此代理是否可供 A2A 调用发现。

    • 能力 array[string]
    • input_modes array[string]

      InputModes 列出代理接受的MIME类型（例如“text/plain”、 “应用程序/json”）。

    • output_modes array[string]

      OutputModes 列出了代理可以生成的MIME类型。

    • 技能 大量[对象]

      技能公布了代理可以执行的离散任务。

      隐藏技能属性 显示技能属性 对象

      • 描述 字符串
      • example_input 字符串
      • example_output 字符串
      • 名称 字符串
    • 总结 字符串
  • agent_grpc_endpoint 字符串
  • agent_http_endpoint 字符串

    AgentHTTPEndpoint 是代理沙箱HTTP端点。与 aer_http_endpoint 的值相同。

  • auto_deploy 布尔

    AutoDeploy 是 ECP 拥有的每应用自动部署开关。 ECP 所有，在每个详细信息 GET 时获取（不会持久保存在网关数据库中）。当 ECP 没有值或无法访问时不存在；用户界面界面将缺席视为关闭。

  • completed_rate 数字
  • created_date 字符串
  • current_deployment_id 字符串
  • current_payload_ref 字符串
  • 描述 字符串
  • 功能 对象
    隐藏要素属性 显示要素属性 对象

    • 护栏 布尔
    • 内存 布尔
    • 操场 布尔

      Playground 报告是否为工作区预配了 Playground用户界面（nil/true = 已预配，当前行为）。如果为 false，则调用者会直接使用调用API 。

    • use_custom_parser 布尔

      UseCustomParser 如果为 true，则使网关在调用流上仅发出代理的输出解析器自定义事件（删除平台框架）。从 AgentEngine 初始化时的代理.yaml 功能中保留。

  • 框架 字符串
  • github_installation_id 整型

    GithubInstallationID 是拥有该存储库的 GitHub 应用安装。 ECP 所有，在每个详细信息 GET 时获取（不会持久保存在网关数据库中），因此它适用于在此字段存在之前创建的工作区。在编辑跟踪的分支时，用户界面需要它来列出存储库的分支。

  • gitops 对象
    隐藏 gitops 属性 显示 gitops 属性 对象

    • 分支 字符串
    • connection_ref 字符串
    • github_installation_id integer(int64)
    • manifest_path 字符串
    • provider 字符串
    • repo_url 字符串
  • id 字符串
  • 实例 对象

    实例报告工作区的实例计数（活动、备用和正在启动）以及从工作区的 OE 单元获取的读取时间。当无法访问 OE 或工作区未以池化方式运行（例如容器模式），则不存在。故意没有任何内部实施命名：这是一个面向客户的字段。

    隐藏实例属性 显示实例属性 对象

    • 活跃的 整型
    • 池化 布尔
    • standby 整型
    • 开始 整型
  • 调用 整型

    滚动 24h窗口的执行指标。所有五个字段都是指针，因此连接线可以区分用户界面需要以不同方式呈现的两种情况：(a) OE指标获取失败（软故障 — 所有五个字段均不存在），或 (b)窗口包含零调用/没有已完成执行次数（调用次数设立为 0，且延迟/速率字段不存在）。用户界面区分“—”和从 "0 incalls"通过调用 != nil。

  • 语言 字符串
  • last_invoked_at string(date-time)
  • metrics_computed_at string(date-time)
  • metrics_window_start string(date-time)
  • 名称 字符串
  • org_id 字符串
  • p95_latency_ms 数字
  • PROJECT_ID 字符串
  • release_mode 字符串

    ReleaseMode 是 ECP 拥有的 Webhook发布策略 ("push" | "tag-release" | "api-only")。在每个详细信息 GET 上获取；当 ECP 没有值或无法访问时不存在。

  • 状态 字符串

    状态是 ECP 拥有的活动/暂停信号。网关在每次详细 GET 时从 ECP 获取 — 它不会在本地持久保存。当 ECP 无法访问时不存在；用户界面界面将缺席视为未暂停。

    取值为 active、paused、error、disconnected 或 deleting。

  • 子目录 字符串
  • updated_date 字符串
  • Workspace_id 字符串
  • Workspace_name 字符串
• 400

  application/json

  application/json 应用程序/vnd.agent-engine-2026-09-20-preview+json

  Bad Request

  隐藏响应属性 显示响应属性 对象

  • 代码 字符串
  • 错误 字符串
  • Success 布尔
  隐藏响应属性 显示响应属性 对象

  • 代码 字符串
  • 错误 字符串
  • Success 布尔
• 404

  application/json

  application/json 应用程序/vnd.agent-engine-2026-09-20-preview+json

  未找到

  隐藏响应属性 显示响应属性 对象

  • 代码 字符串
  • 错误 字符串
  • Success 布尔
  隐藏响应属性 显示响应属性 对象

  • 代码 字符串
  • 错误 字符串
  • Success 布尔
• 500

  application/json

  application/json 应用程序/vnd.agent-engine-2026-09-20-preview+json

  内部服务器错误

  隐藏响应属性 显示响应属性 对象

  • 代码 字符串
  • 错误 字符串
  • Success 布尔
  隐藏响应属性 显示响应属性 对象

  • 代码 字符串
  • 错误 字符串
  • Success 布尔