跳转到内容

响应转换前规整能力

响应转换前规整能力用于在宿主原生响应转换之前改写上游响应。它适合修正上游返回的 provider-native payload,再交给宿主或插件响应转换器处理。

能力字段

json
{
  "capabilities": {
    "response_before_translator": true
  }
}

源码参考:

  • sdk/pluginapi/types.goResponseNormalizerResponseTransformRequestPayloadResponse
  • sdk/pluginabi/types.goresponse.normalize_before
  • internal/pluginhost/adapters.goNormalizeResponse 转换前阶段

示例参考:

  • examples/plugin/response-normalizer/go/main.go
  • examples/plugin/simple/go/main.goMethodResponseNormalizeBefore

方法

方法作用
response.normalize_before在响应翻译前返回规整后的响应体。

请求与响应

请求使用 ResponseTransformRequest,响应使用 PayloadResponse

json
{
  "Body": "base64-normalized-provider-response"
}

与响应转换后规整的区别

  • response_before_translator 处理 provider-native 响应。
  • 响应转换后规整能力 处理已经翻译成客户端协议后的响应。

开发注意

  • 适合修正上游字段缺失、兼容非标准 provider 响应。
  • 不要输出客户端协议格式,除非当前阶段的 ToFormat 本来就是该格式。
  • 需要同时支持转换前和转换后时,可以两个能力都声明。

基于 MIT 协议发布