Agent Chat
Process context and prompt to generate tool actions and results
Node Overview
| Property | Details |
|---|---|
| Purpose | Create intelligent conversational agents that execute workflow actions and maintain context |
| Usage | Core building block for AI assistants, chatbots, and automated workflow agents |
| Category | Intelligent Assist |
| Type | Agentic |
| Security | Immutable directives with jailbreak protection |
Key Capabilities
- Intelligent Agents- Conversational AI with immutable core objectives
- Tool Execution- Converts workflow steps into AI-callable tools
- Natural Dialogue- Maintains engaging conversations while following defined goals
- Real-time Streaming- Live response streaming via Redis pubsub
- Multi-step Execution- Configurable tool execution with attempt limits
- Rich Message Processing- Handles text, images, and structured data
Node Inputs
Required Parameters
| Parameter | Type | Description |
|---|---|---|
| Model | modelSettings |
AI model for conversation processing and tool execution |
| Goals | textarea |
Primary objectives (immutable core directives) |
| Steps | textarea |
Mandatory process the agent must follow |
| Additional Instructions | textarea |
Extra context and behavioral guidelines |
| Data | object |
Input containing messages, thread info, and workflow tools |
Optional Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| Thread ID | string |
- | Conversation thread identifier for continuity |
| Max Attempts | number |
10 |
Maximum tool execution attempts |
Node Output
Response Object
{
response: string // AI-generated conversational response
}
Returns the complete AI-generated response after processing all tools and context
Node Functionality
The Agent Chat node provides powerful capabilities:
Core Intelligence
- Immutable Objectives- Goals and steps cannot be overridden
- Conversational AI- Natural, engaging dialogue patterns
- Context Awareness- Maintains conversation flow and memory
Tool Integration
- Workflow Execution- Converts steps into callable tools
- Dynamic Tool Creation- Auto-generates tool definitions
- Result Processing- Seamlessly incorporates tool outputs
Real-time Features
- Live Streaming- Real-time response chunks via Redis
- Session Management- Thread continuity and state tracking
- Error Broadcasting- Live error message streaming
Key Features
Core Configuration
| Feature | Description |
|---|---|
| Immutable Goals | Primary objectives that cannot be overridden or modified |
| Mandatory Steps | Required processes the agent must strictly follow |
| Universal Standards | Built-in conversational guidelines for natural dialogue |
| Security Rules | Advanced protection against jailbreak attempts and directive overrides |
Advanced Features
Tool Integration System
- Workflow Step Execution- Seamlessly converts workflow steps into AI-callable tools
- Dynamic Tool Creation- Automatically generates tool definitions from workflow configuration
- Smart Result Processing- Intelligently incorporates tool outputs into conversational responses
Real-time Streaming Engine
- Live Response Streaming- Publishes response chunks via Redis for instant delivery
- Session Management- Advanced tracking of conversation state and thread continuity
- Error Broadcasting- Real-time error message streaming with detailed diagnostics
When to Use
Choose the Agent Chat node when you need to:
AI Assistant Development
- Specialized Assistants- Build conversational AI with specific objectives and behaviors
- Workflow Automation- Create agents that execute actions during natural conversations
- Context-Aware Chatbots- Develop bots that maintain conversation flow and memory
Enterprise Applications
- Customer Support- Implement intelligent support agents with structured response patterns
- Data Analysis- Create assistants that help users understand and analyze their data
- Process Orchestration- Guide users through complex workflows with interactive automation
Integration Scenarios
- Tool Execution- Combine human-like conversation with powerful tool capabilities
- Real-time Interaction- Build live chat experiences with streaming responses
- Secure Automation- Deploy agents with immutable directives and security protections
Important Considerations
Configuration Requirements
| Aspect | Requirement | Impact |
|---|---|---|
| Goals & Steps | Must be clearly defined | Defines agent's core behavior and cannot be overridden |
| Model Selection | Choose based on complexity | Affects conversation quality and tool execution capabilities |
| Tool Definitions | Properly configured workflow steps | Required for agent to execute actions during conversations |
Performance Factors
| Factor | Description | Optimization |
|---|---|---|
| Token Usage | Tracks prompt and completion tokens | Monitor for cost optimization |
| Max Attempts | Prevents infinite loops | Set appropriate limits based on workflow complexity |
| Message Processing | Handles text, images, data URLs | Ensure proper input validation |
Security & Safety
| Security Feature | Protection | Benefit |
|---|---|---|
| Jailbreak Prevention | Advanced security rules | Maintains agent integrity |
| Directive Protection | Immutable core objectives | Ensures consistent behavior |
| Error Handling | Graceful failure recovery | Reliable operation under all conditions |
Best Practices
Development Guidelines
- Clear Objectives- Define specific, actionable goals for consistent agent behavior
- Logical Flow- Structure steps in a predictable, sequential manner
- Thorough Testing- Validate tool configurations before production deployment
Optimization Strategies
- Cost Monitoring- Track token usage patterns for budget optimization
- Performance Tuning- Select appropriate models based on complexity requirements
- Analytics Integration- Monitor conversation quality and success metrics
Example Use Cases
Customer Support Agent
Goals: Provide helpful, accurate customer assistance with professional standards
Steps: Gather context Troubleshoot Escalate when needed Follow up
Tools: Knowledge base search, ticket creation, user lookup
Data Analysis Assistant
Goals: Help users understand and analyze their data through natural conversation
Steps: Clarify requirements Perform analysis Visualize results Provide insights
Tools: Database queries, chart generation, statistical analysis
Last updated: 2025-11-28 - revision 697b76812