Symbiosika Assistant Chat

Overview

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

• Chat with Assistant: Send user messages to a selected AI assistant and receive responses, enabling conversational workflows.
• Get Available Assistants: Retrieve a list of AI assistant templates available for the specified organization.
• 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 capabilities into your automation workflows, such as customer support bots, virtual assistants, or interactive Q&A systems tailored to organizational contexts.

Practical Examples

• Automate customer support by sending user queries to a specific AI assistant and processing the replies.
• Dynamically fetch available AI assistants for an organization to present options in a UI or decision logic.
• Reset ongoing conversations when context needs clearing, e.g., after a session timeout or user request.

Properties

Output

The node outputs JSON data depending on the operation:

• Get Available Assistants:

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

  A list of available assistant templates for the organization.

• Chat with Assistant:

  {
    "assistantMessage": "Response text from the assistant",
    "chatId": "chat-session-id",
    "finished": false,
    "render": {...},
    "sessionId": "session-id-from-input",
    "meta": {...}
  }
  

  Contains the assistant's reply, chat session identifiers, status flags, and metadata.

• Reset Chat:

  {
    "resetMessage": "Confirmation or response message after reset",
    "chatId": "chat-session-id",
    "finished": false,
    "render": {...},
    "sessionId": "session-id-from-input"
  }
  

  Confirmation message and related chat session info after resetting the conversation.

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, which must be accessible from the n8n environment.
• The API base URL and key are configured via the credential referenced in the node.
• The node dynamically loads organizations and assistants via API calls to populate dropdown options.

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 chats causes errors.
  • Network issues or incorrect API URLs can lead to request failures.

• Error Messages:

  • "Failed to load organisations: ...": Indicates inability to fetch organizations; check API credentials and network.
  • "Failed to fetch assistants: ...": Failure retrieving assistant templates; verify organization selection and API access.
  • "No user input provided": User input string is empty for chat operation; ensure input is supplied.
  • "Invalid response from Symbiosika API": Unexpected or malformed API response; may indicate API changes or issues.
  • "No chat ID provided for reset": Required chat ID missing for reset operation; provide a valid chat ID.

• Resolution Tips:

  • Confirm API credentials are correctly set up and have necessary permissions.
  • Ensure required parameters like user input and chat IDs are provided.
  • Check network connectivity and API endpoint availability.
  • Use the "Continue On Fail" option to handle errors gracefully in batch executions.

Links and References

• Symbiosika API Documentation (Assumed, replace with actual link if available)
• n8n Expressions Documentation
• n8n Node Development Guide