Skip to main content
预签名反馈令牌允许您从客户端应用程序(浏览器、移动应用等)收集反馈,而无需暴露您的 LangSmith API 密钥。每个令牌生成一个 URL,该 URL 的作用域限定于特定的运行和反馈键。客户端通过直接调用该 URL 提交反馈,无需身份验证。 这在以下情况下很有用:
  • 您的前端从最终用户那里收集点赞/点踩或星级评分。
  • 您希望在电子邮件、Slack 消息或其他外部渠道中嵌入反馈链接。
  • 您需要将反馈收集与后端解耦。
如果您正在使用 Agent Server,当您在运行请求中包含 feedback_keys 时,预签名反馈 URL 会自动生成。有关该工作流程,请参阅为 Agent Server 运行收集用户反馈

创建预签名反馈令牌

使用 create_presigned_feedback_token() / createPresignedFeedbackToken 为特定的运行和反馈键生成令牌。返回的对象包含一个 url,客户端可以调用该 URL 来提交反馈:

设置令牌过期时间

令牌默认在 3 小时后过期。传递 expiration 参数以使用 timedelta(相对时间)或 datetime(绝对时间)自定义此设置:

限制反馈值

传递 feedback_config 以限制客户端可以提交的值。这对于强制执行特定的反馈模式(例如,点赞/点踩、1-5 星或分类标签)很有用:

批量创建令牌(仅限 Python)

使用 create_presigned_feedback_tokens(复数形式)在一次调用中为多个反馈键生成令牌:
Python

使用预签名 URL 提交反馈

一旦您有了预签名 URL,您的前端代码或电子邮件客户端通过向其发送 POSTGET 请求来提交反馈。该 URL 不需要 API 密钥或身份验证,因为令牌提供了授权。

POST 请求

当用户与反馈控件(例如,点击点赞按钮)交互时,从您的前端使用 POSTPOST 支持 scorevaluecommentcorrectionmetadata 字段。

GET 请求

当在电子邮件或 Slack 消息中嵌入反馈链接时使用 GET。用户的点击会触发该请求。GET 支持 scorevaluecommentcorrection 作为查询参数。metadata 不支持与 GET 一起使用。

使用 SDK 提交反馈

您也可以使用 SDK 从预签名令牌提交反馈,这对于您从另一个服务收到令牌 URL 的服务器端工作流程很有用。

列出现有令牌

使用 list_presigned_feedback_tokens / listPresignedFeedbackTokens 检索某个运行的所有预签名反馈令牌。

相关内容