Add per-workflow LangSmith tracing configuration docs#4570
Open
mjain wants to merge 2 commits into
Open
Conversation
❌ Deploy Preview for n8n-docs failed.
|
5 tasks
9dc1072 to
a5a33c4
Compare
a5a33c4 to
890747d
Compare
Contributor
There was a problem hiding this comment.
No issues found across 2 files
Architecture diagram
sequenceDiagram
participant User
participant n8nUI as n8n UI
participant WorkflowSettings as Workflow Settings
participant CredentialStore as Credential Store
participant CodeChangePR as n8n Backend (from Code Change PR)
participant LangSmithAPI as LangSmith API
Note over User,LangSmithAPI: Per-Workflow LangSmith Tracing Configuration Flow
User->>n8nUI: Opens workflow settings
n8nUI->>WorkflowSettings: Display LangSmith section
Note over User,CredentialStore: Setup LangSmith Credential
User->>n8nUI: Go to Settings > Credentials > Add Credential
n8nUI->>CredentialStore: Select LangSmith API credential type
User->>n8nUI: Enter API Key from LangSmith settings
n8nUI->>CredentialStore: Save LangSmith API credential
CredentialStore->>CredentialStore: Encrypt and store API key
Note over User,WorkflowSettings: Configure Workflow Tracing
User->>WorkflowSettings: Select LangSmith Credential
User->>WorkflowSettings: Enter LangSmith Project name (defaults to "default")
User->>WorkflowSettings: Save workflow settings
WorkflowSettings->>CodeChangePR: Pass per-workflow LangSmith config
CodeChangePR->>CodeChangePR: Override instance-level env vars for this workflow
alt AI Node Execution Started
WorkflowSettings->>CodeChangePR: Trigger execution with LangSmith config
CodeChangePR->>CredentialStore: Retrieve LangSmith API credential
CredentialStore-->>CodeChangePR: Decrypted API key
CodeChangePR->>LangSmithAPI: Send traces to configured project
LangSmithAPI-->>CodeChangePR: Trace recorded
else Instance-level env vars used (no per-workflow config)
Note over CodeChangePR: Fallback to LANGCHAIN_PROJECT env var
end
|
Thanks @mjain! We'll hold off on reviewing this until the PR is ready to go in the main repo. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Summary by cubic
Documented per-workflow LangSmith tracing so you can route AI node traces from specific workflows to different projects or accounts without changing global settings. Added step-by-step setup for a
LangSmith APIcredential (stored with n8n credential encryption) and updated Workflow Settings with a LangSmith section to select a credential and project (defaults to "default"); workflow-level settings override instance env vars likeLANGCHAIN_PROJECT.Written for commit ec5e259. Summary will update on new commits.