Knotie AI icon

Knotie AI

Connect 100+ tools through Knotie AI Pro integration platform

Overview

This node, named "Knotie AI," acts as a connector to the Knotie AI Pro integration platform, enabling users to interact with over 100 different apps and their tools/actions through a unified interface. It dynamically loads available apps and their respective tools from the Knotie Connect Hub service and allows execution of selected tools with user-defined parameters.

Typical use cases include:

  • Automating workflows that involve multiple third-party services without needing separate nodes for each.
  • Quickly integrating new or custom apps supported by Knotie AI without additional development.
  • Centralizing API calls to various services via a single node, simplifying workflow design.

For example, a user can select an app like "Airtable" and then choose a tool such as "Create Record," provide the necessary parameters, and execute the action directly within n8n. The node handles authentication and communication with the Knotie platform transparently.

Properties

Name Meaning
Cache Management Notice informing that apps are cached for 5 minutes to improve performance. Users can refresh the cache manually if they have connected new apps recently.
🔄 Refresh Available Apps Button to refresh the list of available apps and clear the 5-minute cache.
App Dropdown to select the app/service to use (e.g., Airtable, GitHub, Gmail). The list is dynamically loaded from the Knotie Connect Hub.
Tool Dropdown to select the specific tool/action to execute within the chosen app. The options depend on the selected app and are dynamically loaded.
Parameters A collection of key-value pairs representing input parameters for the selected tool. Users can add multiple parameters. Values can be strings, arrays (comma-separated), or JSON objects depending on the parameter type.

Note: The node supports dynamic loading of apps, tools, and tool parameters from the external Knotie registry, so the exact parameters vary per tool.

Output

The node outputs an array of items corresponding to each input item processed. Each output item contains a json object with the following structure:

  • success: Boolean indicating whether the tool execution was successful.
  • tool: The full tool identifier string in the format "appName:toolName".
  • appName: The name of the app used.
  • toolName: The name of the tool executed.
  • parameters: Object containing the parameters sent to the tool.
  • result: The data returned by the tool execution (varies depending on the tool).
  • metadata: Additional metadata returned by the Knotie platform about the execution.

If an error occurs and the node is configured to continue on failure, the output item will contain:

  • success: false
  • error: Error message string
  • tool: The tool attempted

The node does not output binary data.

Dependencies

  • Requires an API key credential for the Knotie AI Pro platform (referred generically as "an API key credential").
  • Communicates with the Knotie Connect Hub API at https://connecthub.knotie-ai.pro.
  • Uses HTTP POST requests to fetch available apps, tools, and to execute selected tools.
  • Requires proper configuration of the API token and registry URL in the node credentials.

Troubleshooting

  • Common Issues:

    • Failure to load apps or tools usually indicates invalid or missing API credentials or network connectivity issues.
    • Errors during tool execution may result from incorrect parameter formats or missing required parameters.
    • Cache-related stale data might cause outdated app/tool lists; use the refresh button to clear cache.

  • Error Messages:

    • "Failed to get token metadata": Indicates inability to retrieve partner and customer info from the token; check API token validity.
    • "Tool is required": No tool selected for the current item; ensure the "Tool" property is set.
    • "Invalid tool format. Expected \"appName:toolName\"": The tool identifier is malformed; select a valid tool.
    • "Tool execution failed: <error>": The external tool call failed; review the error message and verify parameters.
    • "Error loading apps - Check credentials" or "Error loading tools - Check connection": Problems fetching app/tool lists; verify credentials and network access.

  • Resolution Tips:

    • Verify that the API token and registry URL are correctly set in the node credentials.
    • Use the refresh button to update the app and tool lists after connecting new apps.
    • Validate parameter inputs, especially JSON strings, to ensure correct formatting.
    • Enable "Continue On Fail" to handle errors gracefully in batch executions.

Links and References

This summary is based solely on static analysis of the provided source code and property definitions.

Discussion