Symbiosika Assistant Chat icon

Symbiosika Assistant Chat

Chat with a Symbiosika Assistant

Actions3

Overview

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

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

This node is useful in scenarios where automated conversational AI is needed, such as customer support bots, internal help desks, or interactive assistants tailored to organizational needs.

Example use cases:

  • A company wants to integrate an AI assistant that can answer employee questions about HR policies.
  • A developer builds a chatbot that continues conversations across multiple interactions using chat IDs.
  • An admin resets a chat session to clear previous context before starting a new conversation.

Properties

Name Meaning
Organisation Name or ID Select or specify the organization to operate within. Loaded dynamically from the API.
Operation Choose the action to perform: Chat with Assistant, Get Available Assistants, or Reset Chat.
User Input (For Chat operation) The message text sent to the assistant.
Use Existing Chat ID (For Chat operation) Whether to continue an existing chat conversation using a chat ID.
Chat ID (For Chat operation with existing chat) The ID of the chat to continue.
Use Specific Assistant (For Chat operation) Whether to use a specific assistant template for the chat.
Assistant Name or ID (For Chat operation with specific assistant) Select or specify which assistant template to use.
Chat ID (Reset Chat) (For Reset Chat operation) The ID of the chat conversation to reset.

Output

The node outputs JSON data depending on the operation:

  • Get Available Assistants: 

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

  • Chat with Assistant: 

    {
  "assistantMessage": "Response text from the assistant",
  "chatId": "ID of the current chat session",
  "finished": true|false,          // Indicates if the conversation is finished
  "render": { /* rendering info, if any */ },
  "sessionId": "session identifier from input",
  "meta": { /* additional metadata from API */ }
}

  • Reset Chat: 

    {
  "resetMessage": "Response text after resetting the chat",
  "chatId": "ID of the reset chat",
  "finished": true|false,
  "render": { /* rendering info, if any */ },
  "sessionId": "session identifier from input"
}

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the Symbiosika Chat API.
  • The node dynamically loads organizations and assistants via authenticated HTTP requests to the Symbiosika API endpoints.
  • Proper configuration of the API URL and key in credentials is necessary.
  • Network access to the Symbiosika API service must be available.

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 empty chat ID when continuing or resetting chats causes errors.
    • Selecting an organization before loading assistants is required; otherwise, the assistant list cannot be fetched.
    • Network or API downtime may cause request failures.

  • Error messages and resolutions:

    • "Failed to load organisations": Check API key validity and network connectivity.
    • "Failed to fetch assistants": Ensure an organization is selected and API is reachable.
    • "No user input provided": Provide a non-empty message for chat operations.
    • "No chat ID provided for reset": Specify a valid chat ID to reset.
    • "Invalid response from Symbiosika API": Indicates unexpected API response format; verify API status and version compatibility.

  • Enabling "Continue On Fail" allows processing multiple items even if some fail.

Links and References

  • n8n Expressions Documentation — For using expressions in property fields.
  • Symbiosika API documentation (not publicly linked here) — Consult your Symbiosika API provider for detailed API specs and usage guidelines.

Discussion