Symbiosika Assistant ChatInstall

Overview

The Symbiosika Assistant Chat node enables interaction with a Symbiosika AI assistant within an organisation context. It supports three main operations:

• Chat with Assistant: Send user messages to the assistant and receive AI-generated responses, optionally continuing existing conversations or using specific assistant templates.
• Get Available Assistants: Retrieve a list of AI assistant templates available for the selected organisation.
• Reset Chat: Reset an existing chat conversation by its ID, effectively starting fresh.

This node is useful in scenarios where you want to integrate AI-driven conversational assistants into workflows, such as customer support automation, internal help desks, or interactive chatbots tailored per organisation.

Practical Examples

• Sending a user query to an AI assistant and getting a response to automate FAQ answering.
• Listing all available AI assistant templates to dynamically select one for a conversation.
• Resetting a chat session when a conversation needs to be cleared or restarted.

Properties

Output

The node outputs JSON data structured according to the operation performed:

• Chat with Assistant:

  {
    "assistantMessage": "string",   // The AI assistant's reply content
    "chatId": "string",             // The chat session identifier
    "finished": "boolean",          // Indicates if the conversation is finished
    "render": "any",                // Additional rendering info from the assistant (optional)
    "sessionId": "string",          // Session identifier passed through input
    "meta": "object"                // Metadata returned by the API
  }
  

• Get Available Assistants:

  {
    "assistants": [ /* array of assistant templates */ ]
  }
  

• Reset Chat:

  {
    "resetMessage": "string",       // Confirmation or message after resetting chat
    "chatId": "string",             // The chat session identifier that was reset
    "finished": "boolean",          // Indicates if the reset ended the conversation
    "render": "any",                // Additional rendering info (optional)
    "sessionId": "string"           // Session identifier passed through 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:
  • To fetch organisations and assistants.
  • To send chat messages or reset chats.
• The API base URL and key are configured via the credential.
• The node expects the organisation ID and other parameters to be provided either statically or via expressions.

Troubleshooting

• Common Issues:

  • Missing or invalid API key credential will cause authentication failures.
  • Providing no user input when performing a chat operation results in an error.
  • Using an invalid or missing chat ID when continuing or resetting a chat causes errors.
  • Selecting an organisation before loading assistants is required; otherwise, the assistant list cannot be fetched.

• Error Messages:

  • "Failed to load organisations: ..." — Check API key validity and network connectivity.
  • "Failed to fetch assistants: ..." — Ensure the organisation ID is correct and accessible.
  • "No user input provided" — Provide a non-empty message for chat operations.
  • "No chat ID provided for reset" — Specify the chat ID to reset.
  • "Invalid response from Symbiosika API" — The API returned unexpected data; verify API status and request correctness.

• Resolution Tips:

  • Verify credentials and permissions.
  • Confirm all required fields are filled.
  • Use expressions carefully to ensure valid values.
  • Enable "Continue On Fail" to handle errors gracefully in batch executions.

Links and References

• n8n Expressions Documentation
• Symbiosika API documentation (not publicly linked here; refer to your API provider)
• n8n HTTP Request Node documentation for understanding underlying API calls