Actions3
Overview
This node, Symbiosika Sync Knowledge Item, is designed to synchronize knowledge items with a Symbiosika Assistant. It supports three main operations:
- Check Knowledge Item If It Should Be Synced: Verifies if a knowledge item exists in the system and whether it requires synchronization based on its last change date.
- Sync Knowledge File: Uploads and syncs a knowledge item as a binary file (e.g., document or other file types).
- Sync Knowledge Entry By Text Only: Syncs a knowledge entry using plain text content along with a title.
Typical use cases include keeping an external knowledge base or assistant up-to-date by syncing new or updated knowledge items, either as files or text entries. For example, you might use this node to:
- Check if a document has changed since the last sync before uploading it again.
- Upload new or updated PDF manuals or guides to the assistant.
- Add or update textual knowledge snippets directly from workflows.
Properties
| Name | Meaning |
|---|---|
| Organisation Name or ID | Select or specify the organisation under which the knowledge item will be synced. |
| 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 unique 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 | (Only for Sync Knowledge File) The name of the binary property containing the file data to upload. |
| Knowledge Text | (Only for Sync Knowledge Entry By Text Only) The textual content of the knowledge entry to sync. |
| Knowledge Title | (Only for Sync Knowledge Entry By Text Only) The title of the knowledge entry. |
Output
The node outputs an array of JSON objects corresponding to each input item processed. The structure depends on the operation:
- Check Knowledge Item If It Should Be Synced: Outputs the response from the API indicating whether the knowledge item exists and if it should be synced. This typically includes status flags or metadata about the item.
- Sync Knowledge File: Outputs the API response after uploading the binary file, confirming success or providing error details.
- Sync Knowledge Entry By Text Only: Outputs the API response after syncing the text entry, including confirmation or error information.
If errors occur and "Continue On Fail" is enabled, the output for that item will contain an error field with the error message.
The node can handle binary data only in the Sync Knowledge File operation, where it expects a binary property containing the file to upload.
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 configured API URL is necessary.
- The organisation list is dynamically loaded via the API using the provided credentials.
Troubleshooting
- No binary data found in property: When performing the Sync Knowledge File operation, ensure the specified binary property exists and contains valid file data; otherwise, the node will throw an error.
- Failed to load organisations: This error occurs if the API request to fetch organisations fails, possibly due to invalid credentials or network issues.
- Invalid response format for organisations: Indicates the API did not return the expected array format when loading organisations.
- Operation not supported: If an unsupported operation value is set, the node will throw an error.
- API errors: Any API-related errors (e.g., authentication failure, invalid parameters) will be surfaced in the node output or cause execution to stop unless "Continue On Fail" is enabled.
To resolve these issues, verify credentials, input parameters, and network connectivity.
Links and References
- n8n Expressions Documentation
- Symbiosika API documentation (not publicly linked here; refer to your Symbiosika API provider for details)