Overview
The "Symbiosika Assistant Chat" node enables interaction with a Symbiosika AI assistant within n8n workflows. It allows users to send messages to an AI assistant, continue conversations using existing chat sessions, reset ongoing chats, and retrieve available assistant templates for a given organisation.
Common scenarios where this node is beneficial include:
- Automating customer support by integrating AI chat assistants.
- Building conversational interfaces that maintain context across multiple messages.
- Dynamically selecting different AI assistant templates based on organisational needs.
- Resetting chat sessions programmatically to start fresh conversations.
For example, a user can send a question to the assistant and receive a contextual reply, or continue a previous conversation by specifying a chat ID, enabling multi-turn dialogues.
Properties
| Name | Meaning |
|---|---|
| Organisation Name or ID | Select or specify the organisation to which the assistant belongs. |
| Operation | Choose the action: "Chat with Assistant", "Get Available Assistants", or "Reset Chat". |
| User Input | The message text sent by the user to the assistant (required for "Chat with Assistant" operation). |
| Use Existing Chat ID | Boolean flag indicating whether to continue an existing chat session. |
| Chat ID | The identifier of the existing chat session to continue (shown if "Use Existing Chat ID" is true). |
| Use Specific Assistant | Boolean flag to select a specific assistant template for the chat. |
| Assistant Name or ID | Select or specify the assistant template to use (shown if "Use Specific Assistant" is true). |
| Chat ID (Reset Chat) | The chat session ID to reset (required for "Reset Chat" operation). |
Output
The node outputs JSON data depending on the selected operation:
Chat with Assistant:
assistantMessage: The assistant's reply content as a string.chatId: The unique identifier of the current chat session.finished: A boolean indicating if the conversation has finished.render: Additional rendering information from the assistant (format depends on API).sessionId: Passed through from input, representing the session context.meta: Metadata returned by the API about the chat or organisation.
Get Available Assistants:
assistants: An array of available assistant templates with their details.
Reset Chat:
resetMessage: Confirmation or message content after resetting the chat.chatId: The ID of the reset chat session.finished: Boolean indicating if the reset chat session is finished.render: Rendering info related to the reset chat.sessionId: Passed through from input.
The node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the Symbiosika Chat API.
- The node makes HTTP requests to the Symbiosika API endpoints, so network access is required.
- The API base URL and key are configured in the credential referenced by the node.
- The node dynamically loads options for organisations and assistants via API calls.
Troubleshooting
- No user input provided: If the "User Input" property is empty during a chat operation, the node throws an error. Ensure this field is filled.
- Invalid or missing chat ID: When continuing or resetting a chat, providing a valid chat ID is mandatory. Missing or incorrect IDs cause errors.
- API request failures: Network issues, invalid API keys, or permission problems may cause request failures. Check credentials and network connectivity.
- Invalid response format: If the API returns unexpected data, the node will throw an error indicating an invalid response.
- Operation not supported: Selecting an unsupported operation value results in an error.
- To handle errors gracefully, enable "Continue On Fail" in the node settings to capture errors per item without stopping the workflow.
Links and References
- n8n Expressions Documentation
- Symbiosika API documentation (not publicly linked here; refer to your API provider)