Symbiosika Sync Knowledge Item icon

Symbiosika Sync Knowledge Item

Sync a knowledge item with a Symbiosika Assistant
Join our community

Actions3

Overview

This node, Symbiosika Sync Knowledge Item, is designed to synchronize knowledge items with a Symbiosika Assistant service. It supports multiple operations related to managing knowledge entries within an organisation's AI knowledge base:

  • Sync Knowledge Entry By Text Only: Uploads and syncs a knowledge entry using plain text and metadata (title, external ID, last change date, and optionally a knowledge group).
  • Other operations (not requested here) include syncing knowledge files and checking if a knowledge item should be synced.

Typical use cases include:

  • Keeping an AI assistant’s knowledge base up-to-date by programmatically adding or updating textual knowledge entries.
  • Automating knowledge management workflows where knowledge content is generated or updated outside the Symbiosika platform.
  • Integrating with other systems that maintain knowledge articles or FAQs, syncing them into the Symbiosika AI environment.

Example scenario:

  • A company maintains a database of product FAQs. When a new FAQ is created or updated, this node can be used to sync the updated text and title directly into the Symbiosika assistant’s knowledge base for immediate availability.

Properties

Name Meaning
Organisation Name or ID Select or specify the organisation under which the knowledge entry will be synced.
Sync-ID (External) Unique identifier for the knowledge item in the external system, used to track synchronization.
Last Change of the Item Timestamp or date string indicating when the knowledge item was last modified externally.
Knowledge Text The actual textual content of the knowledge entry to be synced.
Knowledge Title The title or headline of the knowledge entry.
Knowledge Group Name or ID Optional grouping identifier to categorize the knowledge entry within the organisation’s knowledge groups.

Output

The node outputs an array of JSON objects, each representing the response from the Symbiosika API for each input item processed. The structure typically includes:

  • Confirmation details about the synced knowledge entry.
  • Any metadata returned by the API such as IDs, status, or timestamps.
  • In case of errors (if "Continue On Fail" is enabled), an object with an error field containing the error message.

No binary data output is produced for this operation since it deals exclusively with text-based knowledge entries.

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 connectivity to the configured API URL is necessary.
  • The user must configure the credential with the correct API URL and API key.
  • The node dynamically loads options for organisations and knowledge groups via API calls, requiring valid credentials and permissions.

Troubleshooting

  • Common issues:

    • Missing or invalid API key credential will cause authentication failures.
    • Incorrect organisation ID or knowledge group ID may result in "not found" or permission errors.
    • Providing empty or malformed required fields (e.g., missing knowledge text or title) will cause validation errors from the API.
    • Network issues or incorrect API URLs will lead to request failures.

  • Error messages:

    • "Failed to load organisations" or "Failed to load knowledge groups" indicate problems fetching dynamic dropdown options; verify credentials and API access.
    • "No binary data found in property ..." does not apply to this operation but appears in other operations involving file uploads.
    • API error responses are passed through; check the error message for details like invalid parameters or permission denied.

  • Resolution tips:

    • Ensure all required fields are filled correctly.
    • Verify the API key and endpoint URL in the credentials.
    • Use expressions carefully to provide dynamic values.
    • Enable "Continue On Fail" to handle partial failures gracefully during batch processing.

Links and References

  • n8n Expressions Documentation
  • Symbiosika API documentation (refer to your Symbiosika account or developer portal for detailed API specs)
  • n8n HTTP Request Node documentation (for understanding underlying request mechanics)

This summary focuses on the Sync Knowledge Entry By Text Only operation of the Symbiosika Sync Knowledge Item node, describing its inputs, outputs, and usage context based on static code analysis.

Discussion