Integration options
Chat interface
Add conversational AI to your apps with the Chat component
BPMN integration
Trigger agents from workflow nodes
REST API
Call agents programmatically via API
Custom Agent Node
Use agents within Integration Designer workflows
Choosing an integration method
| Method | Best for | User interaction |
|---|---|---|
| Chat interface | Conversational experiences, Q&A, guided assistance | Direct user interaction |
| BPMN integration | Automated processing, document handling, decisions | Background processing |
| REST API | External systems, custom frontends, batch processing | Programmatic access |
| Custom Agent Node | Complex integrations, multi-step workflows | Workflow orchestration |
Common patterns
Pattern 1: Conversational assistant
Add a chat interface to help users complete complex tasks with AI guidance.Pattern 2: Document processing
Automatically process documents submitted through your application.Pattern 3: Decision support
Provide AI-powered recommendations within business processes.Pattern 4: Content generation
Generate documents, reports, or communications automatically.Session management
AI agents maintain conversation context through sessions:| Concept | Description |
|---|---|
| Session | A conversation thread between user and agent |
| Context | Data and history available to the agent |
| Persistence | Sessions can be saved and resumed |
| Isolation | Each user/process has separate sessions |
Sessions are automatically managed when using the Chat component. For BPMN and API integrations, you control session lifecycle explicitly.
Data flow
When using agents, data flows through several stages:Knowledge bases
Agents can access knowledge bases for context-aware responses:- Platform documentation - Built-in FlowX.AI knowledge
- Custom knowledge bases - Your uploaded documents and data
- External sources - Connected via MCP integrations
Knowledge Base integration
Learn how to connect knowledge bases to your agents
Best practices
Start with clear use cases
Start with clear use cases
Define specific tasks for your agent rather than general-purpose capabilities. Focused agents perform better.
Provide sufficient context
Provide sufficient context
Include relevant process data when calling agents. More context leads to better responses.
Handle errors gracefully
Handle errors gracefully
Always include fallback paths for when agents fail or return low-confidence results.
Monitor and iterate
Monitor and iterate
Track agent performance and user feedback. Continuously improve prompts and workflows.

