n8n-nodes-agent-brains
v1.2.0
Published
AgentBrains nodes for n8n to integrate workflows, production webhooks, and Synthetic User validation with the AgentBrains platform.
Maintainers
Readme
n8n-nodes-agent-brains
AgentBrains nodes for n8n to integrate your workflows with the AgentBrains platform. Use these nodes to connect production webhooks for custom AI employee integrations and to run Synthetic User validation tests against your flows.
AgentBrains helps businesses build, validate, and manage AI employees with curated knowledge, configurable scoring, and an operational Inbox for monitoring and improvement. These nodes make it straightforward to plug your n8n workflows into AgentBrains for real-world operation and testing.
Installation
Follow the n8n community nodes installation guide: https://docs.n8n.io/integrations/community-nodes/installation/
Trigger Node: AgentBrains Integration Trigger
- Starts your n8n workflow from AgentBrains via production webhook.
- Registers on workflow activation and unregisters on deactivation for clean lifecycle management.
- Works for production AI employee integrations (e.g., sales, support, setup assistants) and for running Synthetic User tests to validate flows before and after launch.
Typical Uses
- Trigger consumer workflows from AgentBrains using the production webhook URL.
- Validate workflows with Synthetic Users configured in AgentBrains and attach scoring to conversations.
- Centralize monitoring and triage in AgentBrains Inbox while executing logic in n8n.
Transform Node: AgentBrains QA Tester
- Runs a synthetic conversation test against your n8n workflow (or any agent endpoint) using a selected Synthetic User persona.
- Polls the AgentBrains orchestrator for completion and returns the full transcript, scoring, and pass/fail results.
- Ideal for "Validation" workflows that run periodically or on-demand to ensure agent quality.
Typical Uses
- Regression Testing: Trigger a validation workflow after deploying changes to verify core flows (e.g., "Purchase under $1500").
- Quality Monitoring: Schedule daily tests to catch drift or API failures in your agent's tools.
- A/B Testing: Run the same scenario against different agent versions/prompts and compare scores.
Inputs & Configuration
- Synthetic User: Select from your available personas (e.g., "Angry Customer", "Tech Savvy Buyer") loaded dynamically from AgentBrains.
- Objectives & Constraints: Define the goal (e.g., "Buy a thermal scope"), constraints ("Budget < $1500"), and success criteria ("Link provided").
- Wait for Completion: Enable to let the node poll until the conversation finishes (recommended for immediate results).
Credentials
- Create an account and generate an access token: https://agent-brains.com/system-integration
- Add credentials in n8n and select them on the node to authenticate requests.
Usage Notes
- For production usage, activate your workflow so the production webhook is registered.
- Use “Respond using ‘Respond to Webhook’ node” to return data generated by downstream nodes or “Last Node” to return the final item.
- When credentials or webhook URLs change, re-activate the workflow to refresh the registration state.
About AgentBrains
- Build and deploy AI employees that scale with your business.
- Curate a Knowledge Base, define goals and guardrails, and validate behavior.
- Run Synthetic Users to simulate customer behaviors; evolve them into Digital Twins using real transcripts.
- Use the Inbox to monitor conversations, score performance, triage regressions, and compare variants.
Learn more: https://agent-brains.com/
Resources
- n8n community nodes documentation: https://docs.n8n.io/integrations/#community-nodes
- AgentBrains system integration: https://agent-brains.com/system-integration
