Actions3
Overview
This node integrates with the Symbiosika Assistant to manage knowledge items within an organisation. It supports three main operations:
- Check Knowledge Item If It Should Be Synced: Verifies if a specific knowledge item exists and whether it requires synchronization based on its external ID and last change date.
- Sync Knowledge File: Uploads and syncs a binary knowledge file (e.g., documents) to the Symbiosika Assistant.
- Sync Knowledge Entry By Text Only: Syncs a knowledge entry using plain text content along with a title.
This node is beneficial in scenarios where organisations maintain knowledge bases or documentation that need to be kept up-to-date with an AI assistant platform. For example, it can be used to automate syncing updated manuals, FAQs, or other knowledge resources to ensure the assistant has the latest information.
Properties
| Name | Meaning |
|---|---|
| Organisation Name or ID | Select or specify the organisation to which the knowledge item belongs. |
| Operation | Choose the action to perform: - Check Knowledge Item If It Should Be Synced - Sync Knowledge File - Sync Knowledge Entry By Text Only |
| 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 | (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. |
| Knowledge Title | (Only for Sync Knowledge Entry By Text Only) The title of the knowledge entry. |
| Knowledge Group Name or ID | Optional group within the organisation to categorize the knowledge item. |
Output
The node outputs JSON objects for each input item processed, containing the response from the Symbiosika API:
- For Check Knowledge Item If It Should Be Synced, the output JSON indicates whether the item exists and if syncing is necessary.
- For Sync Knowledge File, the output JSON contains the result of the file upload and sync operation.
- For Sync Knowledge Entry By Text Only, the output JSON includes the confirmation of the text-based knowledge entry sync.
If errors occur and "Continue On Fail" is enabled, the output JSON will contain an error field with the error message.
The node does not output binary data itself; it only consumes binary data for the file upload operation.
Dependencies
- Requires an API key credential for authenticating with the Symbiosika Assistant API.
- Needs network access to the Symbiosika API endpoint specified in the credentials.
- Uses HTTP requests to interact with the Symbiosika API for organisation info, knowledge groups, and syncing operations.
Troubleshooting
- No binary data found in property: When performing the Sync Knowledge File operation, ensure the specified binary property exists and contains valid data.
- Invalid response format: If loading organisations or knowledge groups fails, verify the API key and network connectivity.
- Operation not supported: Selecting an unsupported operation value will throw an error.
- API request failures: Errors returned by the Symbiosika API (e.g., authentication failure, invalid parameters) will be surfaced. Check the API key validity and parameter correctness.
- Enable "Continue On Fail" to allow processing multiple items even if some fail.
Links and References
- n8n Expressions Documentation
- Symbiosika Assistant API documentation (not publicly linked here)