promptrails

PromptRails nodes for n8n — execute agents, run prompts, manage chat sessions, and more

Package Information

Downloads: 0 weekly / 0 monthly
Latest Version: 0.2.0
Author: PromptRails

Available Nodes

PromptRails icon
PromptRails
Interact with the PromptRails AI agent platform

Documentation

n8n-nodes-promptrails

n8n community node for PromptRails — execute AI agents, run prompts, manage chat sessions, query data sources, and more from your n8n workflows.

Installation

In your n8n instance:

  1. Go to Settings > Community Nodes
  2. Select Install a community node
  3. Enter @promptrails/n8n-nodes-promptrails
  4. Click Install

Credentials

You need a PromptRails API key to use this node:

  1. Log in to PromptRails
  2. Go to Settings > API Keys
  3. Create a new API key with the required scopes
  4. In n8n, create a new PromptRails API credential with your API key and workspace ID

Resources & Operations

Resource Operations
Agent Execute, Preview, Get, List
Prompt Run, Get, List
Chat Create Session, Send Message, Get Session, List Sessions, List Messages
Execution Get, List
Data Source Query, Get, List
Trace Get, List, Get Summary
Cost Workspace Summary, Agent Summary

Agent

  • Execute — Run an agent with input variables and get the result
  • Preview — Test a specific agent version before promoting
  • Get — Retrieve agent details by ID
  • List — List all agents in the workspace

Prompt

  • Run — Execute a prompt template with variables
  • Get — Retrieve prompt details by ID
  • List — List all prompts in the workspace

Chat

  • Create Session — Start a new multi-turn chat session with an agent
  • Send Message — Send a message in an existing chat session
  • Get Session — Retrieve session details
  • List Sessions — List all chat sessions
  • List Messages — Retrieve messages from a session

Data Source

  • Query — Execute a query against a connected data source
  • Get — Retrieve data source details
  • List — List all data sources

Execution

  • Get — Retrieve execution details and results
  • List — List execution history

Trace

  • Get — Retrieve a full execution trace with spans
  • List — List recent traces
  • Get Summary — Get aggregated trace statistics

Cost

  • Workspace Summary — Total LLM usage costs for the workspace
  • Agent Summary — Cost breakdown for a specific agent

Example Workflows

Execute an Agent on Schedule

  1. Schedule Trigger — Run every hour
  2. PromptRails — Execute agent with { "report_type": "hourly" }
  3. Slack — Post the result to a channel

Chat with Webhook Input

  1. Webhook — Receive incoming messages
  2. PromptRails — Send message to a chat session
  3. Respond to Webhook — Return the agent's response

Monitor Costs

  1. Schedule Trigger — Run daily
  2. PromptRails — Get workspace cost summary
  3. IF — Check if costs exceed threshold
  4. Email — Send alert if over budget

Development

npm install
npm run build
npm run dev    # watch mode

License

MIT

Discussion