Description

n8n-nodes-ai-agent-langfuse

> This project is proudly developed and maintained by Wistron DXLab.

!node-example

An n8n community node that integrates Langfuse observability into your AI Agent workflows.
Supports tool-calling agents, memory, structured output, and full tracing of reasoning steps.

npm package: https://www.npmjs.com/package/n8n-nodes-ai-agent-langfuse

Features

• AI Agent Integration: Works with LangChain’s AgentExecutor and ToolCallingAgent
• Observability: Automatic Langfuse tracing for LLM reasoning, tool calls, and outputs
• Custom Metadata: Inject sessionId, userId, and structured JSON metadata into each trace

n8n is a fair-code licensed workflow automation platform.

Installation
Credentials
Operations
Compatibility
Usage
Resources
Version history

Installation

Follow the installation guide in the official n8n documentation for community nodes.

Community Nodes (Recommended)

For n8n v0.187+, install directly from the UI:
1. Go to Settings → Community Nodes
2. Click Install
3. Enter n8n-nodes-ai-agent-langfuse in Enter npm package name
4. Agree to the risks of using community nodes
5. Select Install

Docker Installation (Recommended for Production)

A preconfigured Docker setup is available in the docker/ directory:

1. Clone the repository and navigate to the docker/ directory

    git clone https://github.com/rorubyy/n8n-nodes-ai-agent-langfuse.git
    cd n8n-nodes-ai-agent-langfuse/docker
    

2. Build the Docker image

    docker build -t n8n:nodes-ai-agent-langfuse .
    

3. Run the container

    docker run -it -p 5678:5678 n8n:nodes-ai-agent-langfuse
    

You can now access n8n at http://localhost:5678

Manual Installation

For a standard installation without Docker:

Go to your n8n installation directory
cd ~/.n8n 
Install the node
npm install n8n-nodes-ai-agent-langfuse
Restart n8n to apply the node
n8n start

Credential

This credential is used to:

• Enable Langfuse tracing, by sending structured request/response logs to your Langfuse instance

Langfuse Settings

|Field Name|Description|Example|
|—–|—–|—–|
Langfuse Base URL|The base URL of your Langfuse instance|https://cloud.langfuse.com or self-hosted URL|
|Public Key *|Langfuse public key used for tracing authentication|pk-xxx|
Secret Key *|Langfuse secret key used for tracing authentication|sk-xxx|

> 🔑 How to find your Langfuse keys:
> Log in to your Langfuse dashboard, then go to:
> Settings → Projects → [Your Project] to retrieve publicKey and secretKey.

Credential UI Preview

Once filled out, your credential should look like this:

!credentials-example

✅ After saving the credential, you’re ready to use the node and see traces in your Langfuse dashboard.

Operations

This node lets you run multi-tool AI agents with full observability.

You can trace every run with context such as sessionId, userId, and any custom metadata.

—

Supported Fields

| Field | Type | Description |
|———-|———-|———-|
| sessionId | string | Logical session ID to group related runs |
| userId | string | ID representing the end user making the request |
| metadata | object | Custom JSON object with additional context (e.g., workflowId, env) |

!langfuse-metadata-example
—

🧪 Example Setup

| Input Field | Example Value |
|———-|———-|
| Session ID | {{$json.sessionId}}|
| User ID | test |
Custom Metadata (JSON)

{
  "project": "test-project",
  "env": "dev",
  "workflow": "main-flow"
}

—

Visual Example

1. Node Configuration UI: This shows a sample n8n workflow using the AI Agent with Langfuse Node.

!node-example

2. Langfuse Trace Output
Here’s how a single request looks inside Langfuse:

• LLM reasoning steps
• Tool calls (with args & results)
• Final JSON responseHere’s how traces appear inside the Langfuse dashboard.

!langfuse-trace-example

Compatibility

• Requires n8n version 1.0.0 or later
• Compatible with:

– OpenAI official API (https://api.openai.com)
– Any OpenAI-compatible LLM (e.g. via LiteLLM, LocalAI, Azure OpenAI)
– Langfuse Cloud and self-hosted instances

Resources

• n8n Community Node Docs
• Langfuse Documentation
• n8n Community Forum
• Langfuse GitHub
• n8n-nodes-langfuse-ai-agent

Version History

• v0.1 – Initial release with AI Agent + Langfuse integration

License

MIT © 2025 Wistron DXLab