Symbiosika Assistant Chat icon

Symbiosika Assistant Chat

Chat with a Symbiosika Assistant
Join our community

Actions3

Overview

This node integrates with the Symbiosika Assistant API to enable conversational AI interactions within n8n workflows. It supports three main operations:

  • Get Available Assistants: Retrieves a list of AI assistant templates available for a specified organisation.
  • Chat with Assistant: Sends user messages to an assistant, optionally continuing an existing chat or using a specific assistant template, and receives AI-generated responses.
  • Reset Chat: Resets an ongoing chat conversation by its chat ID.

Typical use cases include automating customer support chats, generating AI-driven responses in business workflows, or integrating AI assistants into internal tools. For example, you could fetch available assistants for your organisation, then send user queries to a selected assistant and process the replies automatically.

Properties

Name Meaning
Organisation Name or ID Select or specify the organisation to operate under.
Operation Choose the action to perform:
- Chat with Assistant
- Get Available Assistants
- Reset Chat
User Input (For "Chat with Assistant") The message text to send to the assistant.
Use Existing Chat ID (For "Chat with Assistant") Whether to continue an existing chat session.
Chat ID (For "Chat with Assistant" when continuing chat) The ID of the chat to continue.
Use Specific Assistant (For "Chat with Assistant") Whether to use a specific assistant template.
Assistant Name or ID (For "Chat with Assistant" when using specific assistant) Select or specify the assistant template.
Chat ID (For "Reset Chat") The ID of the chat conversation to reset.

Output

  • Get Available Assistants: Outputs a JSON object with an assistants array containing available assistant templates for the organisation.

    {
  "assistants": [
    {
      "id": "assistant-id",
      "label": "Assistant Label",
      "category": "Category"
    },
    ...
  ]
}

  • Chat with Assistant: Outputs a JSON object per input item containing:

    • assistantMessage: The AI-generated response content.
    • chatId: The current chat session ID.
    • finished: Boolean indicating if the chat session is finished.
    • render: Rendering instructions or metadata from the assistant.
    • sessionId: Passed through from input data if present.
    • meta: Additional metadata from the API response.

  • Reset Chat: Outputs a JSON object per input item containing:

    • resetMessage: The assistant's message after resetting the chat.
    • chatId: The chat session ID that was reset.
    • finished: Boolean indicating if the chat session is finished.
    • render: Rendering instructions or metadata.
    • sessionId: Passed through from input data if present.

If binary data were involved, it would be summarized here, but this node only handles JSON 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 to the API URL is necessary.
  • The organisation ID must be valid and accessible with the provided API key.
  • The node uses built-in n8n helper methods for HTTP requests and error handling.

Troubleshooting

  • Failed to load organisations or assistants: Usually caused by invalid API credentials, network issues, or insufficient permissions. Verify the API key and organisation access.
  • No user input provided: When performing a chat operation, ensure the "User Input" property is set; otherwise, the node throws an error.
  • Invalid response from Symbiosika API: Indicates unexpected API response format or missing fields. Check API status and request parameters.
  • No chat ID provided for reset: The reset operation requires a valid chat ID; ensure it is supplied.
  • Operation not supported: If an unsupported operation value is used, the node will throw an error.
  • Enable "Continue On Fail" in the node settings to allow processing multiple items even if some fail.

Links and References

Discussion