跳转到内容

Capture Phases

Capture phase 表示数据处在代理 pipeline 的哪个位置。Capture artifact、配置字段、flow local,以及描述代理链路的日志字段都应使用 phase 名称。

  1. 1
    inbound_request
    模块
    ingress/pipeline/inbound_request
    职责

    本地客户端原始请求,已经经过 HTTP admission 和协议检测。

  2. 2
    provider_request
    模块
    routingtranslation/provider/*/request
    职责

    路由、协议转换、模型改写、projection 和序列化之后的 provider 请求。

  3. 3
    upstream_response
    模块
    provider/*/transportpipeline/upstream_response
    职责

    出站响应重建之前的上游 status、headers 和 body bytes。

  4. 4
    outbound_response
    模块
    translation/http_support
    职责

    为客户端入站协议重建后的最终响应。

配置字段Phase
inbound_request_enabledinbound_request
provider_request_enabledprovider_request
upstream_response_enabledupstream_response
outbound_response_enabledoutbound_response

Capture CLI 使用 hyphenated phase 名称:

Terminal window
proxai capture enable inbound-request
proxai capture enable provider-request
proxai capture enable upstream-response
proxai capture enable outbound-response
Phase可能包含的敏感内容
inbound_request客户端 prompt、输入文件、tool 输出、客户端传入 headers
provider_request转换后的 prompt、provider payload、tool arguments、provider auth 决策
upstream_response模型输出、tool-call arguments、provider headers、原始 SSE bytes
outbound_response最终模型输出和协议特定 response payload