Databricks icon

Databricks

Interact with Databricks API
Join our community

Actions42

Overview

The node integrates with the Genie API of Databricks to start a new conversation within a specified Genie space. This operation is useful for initiating interactive sessions or chatbots that leverage Databricks' Genie conversational capabilities. For example, you can use this node to programmatically begin a dialogue by sending an initial message to a Genie space, which could then be used to trigger workflows, gather user input, or automate responses based on the conversation context.

Properties

Name Meaning
Space ID The unique identifier of the Genie space where the conversation will be started.
Initial Message The first message content sent to initiate the conversation in the specified Genie space.

Output

The output JSON contains the response from the Genie API after starting the conversation. It typically includes details about the newly created conversation such as its ID and metadata returned by the API. This allows subsequent nodes to reference the conversation for further messaging or querying.

No binary data output is produced by this operation.

Dependencies

  • Requires an API authentication token credential for Databricks to authorize requests.
  • The node makes HTTP POST requests to the Genie API endpoint at /api/2.0/genie/spaces/{spaceId}/start-conversation.
  • Proper configuration of the Databricks host URL and valid credentials are necessary.

Troubleshooting

  • Common Issues:

    • Invalid or missing Space ID: Ensure the Space ID is correct and accessible with the provided credentials.
    • Authentication failures: Verify that the API token is valid and has sufficient permissions.
    • Network errors: Check connectivity to the Databricks API endpoint.

  • Error Messages:

    • API Error: <status> <statusText>: Indicates the API responded with an error status code. Review the status and message for details.
    • Network Error: No response received from server: Suggests network issues or incorrect host configuration.
    • Unsupported Genie operation: Occurs if an unsupported operation is requested; ensure "startConversation" is selected.

In case of errors, enabling "Continue On Fail" allows the workflow to proceed while capturing error details in the output.

Links and References

Discussion