自定义 UI

自定义你的 LangSmith 自托管部署。

LangSmith 自托管部署允许进行一些 UI 自定义。

设置自定义 Logo

对于自托管部署，你可以用自己的 Logo 替换 LangSmith Logo。该 Logo 会显示在导航侧栏和错误屏幕上，紧挨 LangSmith 字标。

在你的 Helm values 中设置 config.customLogo：

config:
  customLogo:
    enabled: true
    logoUrl: "https://example.com/logo.svg"

logoUrl 接受 PNG、JPG 或 SVG。Data URI 会被拒绝。

为浅色和深色模式使用不同的 Logo

config:
  customLogo:
    enabled: true
    lightModeLogoUrl: "https://example.com/logo-dark-text.svg"
    darkModeLogoUrl: "https://example.com/logo-white-text.svg"

每个名称对应 Logo 出现的配色方案。如果只设置一个值，LangSmith 会在两种方案中都使用它。需要 Helm chart 版本 0.17.0-rc.38 或更高版本。

从文件提供 Logo

每个 Logo 值也接受根相对路径，例如 /logos/acme.svg。当浏览器无法访问外部主机时，请使用路径。LangSmith 从其自身源请求该路径，因此文件必须存在于前端容器内。

要挂载 Logo 文件：

1. 将镜像存储在 ConfigMap 中。文件名会成为 URL 的最后一段：

   kubectl create configmap langsmith-custom-logo \
     --from-file=acme.svg=./your-logo.svg \
     -n <your-namespace>

2. 将该 ConfigMap 挂载到前端 pod，并将 logoUrl 指向该路径：

   config:
     customLogo:
       enabled: true
       logoUrl: "/logos/acme.svg"
   
   frontend:
     deployment:
       volumes:
         - name: custom-logo
           configMap:
             name: langsmith-custom-logo
       volumeMounts:
         - name: custom-logo
           mountPath: /usr/share/nginx/html/build/logos
           readOnly: true

3. 升级 release，然后确认文件可被提供：

   curl -sI https://<your-langsmith-host>/logos/acme.svg

   content-type 为 image/svg+xml 表示 Logo 已就位。文件缺失时会返回 HTTP 200 和应用 HTML，而不是 404，因此请检查内容类型而不是状态码。

NOTE

如果你的 values 已设置 frontend.deployment.volumes 或 frontend.deployment.volumeMounts，请向这些列表追加内容。替换它们会移除其他设置所依赖的挂载。

当你在基础路径下提供 LangSmith 时，请在值中包含该基础路径：/<base-path>/logos/acme.svg。完整的 Helm values 列表请参阅环境变量。

设置自定义错误支持消息

默认情况下，LangSmith 中的错误消息会引导用户前往支持门户。你可以将其替换为你自己的支持联系信息。

设置后，整个 UI 中的所有错误和支持消息都会显示你的自定义文本，而不是默认的 LangChain 支持电子邮件。

NOTE

自定义消息仅呈现为纯文本。HTML 标签不会被解释，而会作为字面文本显示。

config:
  customErrorSupportMessage: "For help, contact your internal IT team at helpdesk@example.com"

要恢复默认行为，请移除该设置或将其设为空字符串。

---