Skip to main content

Documentation Index

Fetch the complete documentation index at: https://cndoc-langchain.site/llms.txt

Use this file to discover all available pages before exploring further.

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

​
创建预签名反馈令牌

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

client = Client()

run_id = "<run_id>"

token = client.create_presigned_feedback_token(
    run_id,
    feedback_key="user_score",
)

print(token.url)
# https://api.smith.langchain.com/api/v1/feedback/tokens/<token_id>

​
设置令牌过期时间

令牌默认在 3 小时后过期。传递 expiration 参数以使用 timedelta（相对时间）或 datetime（绝对时间）自定义此设置： 
import datetime
from langsmith import Client

client = Client()

run_id = "<run_id>"

token = client.create_presigned_feedback_token(
    run_id,
    feedback_key="user_score",
    expiration=datetime.timedelta(hours=24),
)

​
限制反馈值

传递 feedback_config 以限制客户端可以提交的值。这对于强制执行特定的反馈模式（例如，点赞/点踩、1-5 星或分类标签）很有用： 
from langsmith import Client

client = Client()

run_id = "<run_id>"

token = client.create_presigned_feedback_token(
    run_id,
    feedback_key="user_score",
    feedback_config={
        "type": "continuous",
        "min": 0,
        "max": 1,
    },
)

​
批量创建令牌（仅限 Python）

使用 create_presigned_feedback_tokens（复数形式）在一次调用中为多个反馈键生成令牌：
Python
from langsmith import Client

client = Client()

run_id = "<run_id>"

tokens = client.create_presigned_feedback_tokens(
    run_id,
    feedback_keys=["thumbs_up", "thumbs_down"],
)

for token in tokens:
    print(f"{token.id}: {token.url}")

​
使用预签名 URL 提交反馈

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

​
POST 请求

当用户与反馈控件（例如，点击点赞按钮）交互时，从您的前端使用 POST。POST 支持 score、value、comment、correction 和 metadata 字段。 
curl --request POST \
  --url "https://api.smith.langchain.com/api/v1/feedback/tokens/<token_id>" \
  --header "Content-Type: application/json" \
  --data '{
    "score": 1,
    "comment": "This response was helpful!"
  }'

​
GET 请求

当在电子邮件或 Slack 消息中嵌入反馈链接时使用 GET。用户的点击会触发该请求。GET 支持 score、value、comment 和 correction 作为查询参数。metadata 不支持与 GET 一起使用。 
curl --request GET \
  --url "https://api.smith.langchain.com/api/v1/feedback/tokens/<token_id>?score=1&comment=This%20response%20was%20helpful!"

​
使用 SDK 提交反馈

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

client = Client()

client.create_feedback_from_token(
    "<token_or_url>",
    score=1,
    comment="This response was helpful!",
)

​
列出现有令牌

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

client = Client()

run_id = "<run_id>"

for token in client.list_presigned_feedback_tokens(run_id):
    print(f"ID: {token.id}, URL: {token.url}, Expires: {token.expires_at}")

​
相关内容

将这些文档连接到 Claude、VSCode 等，通过 MCP 获取实时答案。
在 GitHub 上编辑此页面 或 提交问题。