广元市网站建设_网站建设公司_JavaScript_seo优化

目录

• @observe 用法
  • as_type="chain"
  • 1. as_type="chain"
  • 2. as_type="span"

@observe 用法

as_type="chain"

1. 当你用 @observe(name="customer_service_chat", as_type="chain") 包裹一个函数时，Langfuse 会自动捕获函数调用的参数和返回值，并把它显示在 Input/Output 区域。

   • 这就是你看到的 args/kwargs → 输入
   • 函数返回值 → 输出

2. 你手动调用的 update_current_trace(input=...) / output=...)

** * 并不会覆盖这个自动生成的 Input/Output 区域**

• 如果你想在 UI 上看到自定义的 input/output，需要创建一个子 span 或使用 span 类型

在 Langfuse 中，@observe 装饰器用于对代码片段或函数执行进行可观测（observability）采集，并将事件发送到 Langfuse。as_type 参数控制这个观察事件在 Langfuse 中的分类方式。选择 "chain" 还是 "span"，取决于你的监控粒度和业务意图：

---

1. as_type="chain"

• 语义：把当前函数或方法当作 一个链（Chain）执行单元 来记录。

• 适用场景：

  • 你希望把函数作为 LangChain 或类似 Agent 的逻辑链的一部分来观察。
  • 函数内部可能会调用多个子步骤或工具（tool），你希望 Langfuse 能识别这是 上层逻辑链。

• 特点：

  • 通常作为更高层次的“业务逻辑链”记录。
  • 内部调用的 span 可以被嵌套显示在这个 chain 下面。

• 示例：

  @observe(name="process_order", as_type="chain")
  def process_order(order_id):validate_order(order_id)charge_payment(order_id)ship_order(order_id)
  

  这里 process_order 是业务链的整体逻辑，内部的每一步可以作为 span 记录。

---

2. as_type="span"

• 语义：把当前函数或方法当作 一个细粒度的执行跨度（Span） 来记录。

• 适用场景：

  • 你只想记录 一个具体操作、函数调用或外部请求 的执行。
  • 想要在已有的 chain 或父 span 下面嵌套显示。

• 特点：

  • 粒度更细，可以嵌套在 chain 里。
  • 适合记录工具调用、数据库请求、API 调用等。

• 示例：

  @observe(name="charge_payment", as_type="span")
  def charge_payment(order_id):# 调用支付接口pass
  

  这里 charge_payment 是一个细粒度操作，可以被上层 chain 观察。

Chain: process_order (as_type="chain")
│
├─ Span: validate_order (as_type="span")
│
├─ Span: charge_payment (as_type="span")
│   └─ Span: call_payment_gateway (as_type="span")
│
└─ Span: ship_order (as_type="span")├─ Span: check_inventory (as_type="span")└─ Span: create_shipment (as_type="span")

解释：

• 最上层 process_order 是一个 链（Chain），表示业务逻辑流程。
• 内部每个步骤都是 跨度（Span），表示单个操作或工具调用。
• span 可以嵌套，表示某个操作内部还有更细粒度的调用。

你可以把 chain 想成“业务流程容器”，span 想成“具体执行步骤”。

如果你需要，我可以再画一个 多链嵌套 span 的例子，更贴近复杂 Agent 场景。你想要吗？