Actions3
Overview
This node synchronizes knowledge items with a Symbiosika Assistant service. It supports three main operations:
- Sync Knowledge File: Uploads and syncs a knowledge item as a binary file.
- Sync Knowledge Entry By Text Only: Syncs a knowledge entry using plain text and a title, without any file upload.
- Check Knowledge Item If It Should Be Synced: Checks if a knowledge item exists on the server and whether it needs to be synced based on its last change date.
Typical use cases include keeping an external knowledge base or assistant up-to-date by programmatically syncing new or updated knowledge entries, either as files or text content. For example, you might automate syncing product manuals, FAQs, or documentation snippets to the assistant whenever they are updated in your system.
Properties
| Name | Meaning |
|---|---|
| Organisation Name or ID | Select or specify the organisation to which the knowledge item belongs. |
| 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. Each output JSON contains the response from the Symbiosika API for the respective operation:
- For Check Knowledge Item, the output indicates whether the item exists and if syncing is needed.
- For Sync Knowledge File and Sync Knowledge Entry By Text Only, the output contains the result of the upload/sync operation, typically including confirmation details or metadata about the synced knowledge item.
If an error occurs during processing and "Continue On Fail" is enabled, the output JSON 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 Assistant API.
- Needs network access to the Symbiosika API endpoint specified in the credential.
- The node dynamically loads available organisations via the API to populate the organisation selection dropdown.
Troubleshooting
- No binary data found in property: When using the "Sync Knowledge File" operation, ensure that the specified binary property exists and contains valid file data.
- Failed to load organisations: This may indicate invalid API credentials or network issues. Verify the API key and connectivity.
- Invalid response format for organisations: The API response did not return an expected list; check the API status or version compatibility.
- Operation not supported: Occurs if an unsupported operation value is set; verify the operation parameter.
- API request errors: Network failures, authentication errors, or invalid parameters will cause the node to throw errors. Enable "Continue On Fail" to handle these gracefully.
Links and References
- n8n Expressions Documentation
- Symbiosika Assistant API documentation (not publicly linked here; refer to your service provider)