Actions3
Overview
The Symbiosika Sync Knowledge Item node enables synchronization of knowledge items with a Symbiosika Assistant. It supports checking if a knowledge item should be synced, uploading knowledge files as binary data, or syncing knowledge entries by text. This node is useful for automating the management and updating of knowledge bases in Symbiosika, ensuring that the assistant has the latest information.
Common scenarios:
- Automatically syncing updated documents or files to the Symbiosika knowledge base.
- Adding new knowledge entries directly from text inputs.
- Verifying whether a knowledge item exists and requires syncing before performing an upload.
Practical example:
- A user can configure this node to upload a PDF document containing company policies as a knowledge file, so the Symbiosika Assistant can reference it during conversations.
- Another use case is syncing FAQ entries by providing title and text, without needing to handle files.
- Before syncing, the node can check if the knowledge item has changed since the last sync to avoid redundant uploads.
Properties
| Name | Meaning |
|---|---|
| Organisation Name or ID | Select the organisation from the list or specify its ID. The knowledge item will be synced under this organisation. |
| Operation | Choose the action to perform: - Sync Knowledge File - Sync Knowledge Entry By Text Only - Check Knowledge Item If It Should Be Synced |
| Sync-ID (External) | The external identifier for the knowledge item to sync or check. |
| Last Change of the Item | The timestamp or date string representing the last modification time of the knowledge item. |
| Binary Property | (For "Sync Knowledge File" operation) The name of the binary property containing the file data to upload. |
| Knowledge Text | (For "Sync Knowledge Entry By Text Only" operation) The textual content of the knowledge entry. |
| Knowledge Title | (For "Sync Knowledge Entry By Text Only" operation) The title of the knowledge entry. |
Output
The node outputs an array of JSON objects corresponding to each input item processed. Each output JSON contains the response from the Symbiosika API for the respective operation:
- For Check Knowledge Item, the output JSON indicates whether the knowledge item exists and if it should be synced.
- For Sync Knowledge File, the output JSON contains the result of uploading the binary file to the knowledge base.
- For Sync Knowledge Entry By Text Only, the output JSON includes the response after syncing the text-based knowledge entry.
If errors occur and "Continue On Fail" is enabled, the output JSON for that item will contain an error field with the error message.
The node does not output binary data itself; it only consumes binary input when syncing files.
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 organisation list is dynamically loaded via the API using the provided credentials.
Troubleshooting
- No binary data found in property: When using the "Sync Knowledge File" operation, ensure the specified binary property exists and contains valid binary data on the input item.
- Failed to load organisations: Verify that the API key credential is correct and the Symbiosika API URL is reachable.
- Invalid response format for organisations: Indicates unexpected API response; check API availability and credentials.
- Operation not supported: Occurs if an unsupported operation value is set; verify the operation parameter.
- Network or authentication errors may occur if the API key is invalid or expired.
- Use "Continue On Fail" option to allow processing of subsequent items even if some fail.
Links and References
- n8n Expressions Documentation
- Symbiosika API documentation (not publicly linked here; refer to your Symbiosika account resources)