Overview
This node integrates with the Dust API to enable two main operations: talking to an AI assistant and uploading documents to a workspace. The "Talk to an Agent" operation allows users to send messages to a configured AI assistant and receive conversational responses, useful for automating customer support, virtual assistants, or interactive chatbots. For example, you can send a user query and get an AI-generated reply within your workflow.
Properties
| Name | Meaning |
|---|---|
| Message | The text message to send to the AI assistant. |
| Assistant Configuration ID | Identifier of the assistant configuration to direct the message to the correct AI agent. |
| Additional Fields | Optional extra information about the user or context, including: |
| - Username: User's display name | |
| - Email: User's email address | |
| - Timezone: User's timezone (defaults to "Europe/Paris" if not provided) |
Output
The output is a JSON array where each item corresponds to one input item processed. For the "Talk to an Agent" operation, each output object contains:
agentMessage: The concatenated response(s) from the AI assistant extracted from the conversation content.conversationUrl: A URL linking to the conversation in the Dust workspace UI.userMessage: The original user message sent to the assistant.
No binary data is produced by this operation.
Dependencies
- Requires an API key credential for authenticating with the Dust API.
- The node uses the Dust API endpoint, which varies based on the region ("EU" or default).
- Requires workspace ID and assistant configuration ID to target the correct assistant instance.
Troubleshooting
- Common issues:
- Invalid or missing API key will cause authentication failures.
- Incorrect assistant configuration ID may result in no response or errors.
- Network or region misconfiguration could lead to unreachable endpoints.
- Error messages:
- HTTP request failures will log error messages and stack traces.
- If the node is set to continue on failure, errors are returned as part of the output JSON with error details.
- Resolution tips:
- Verify API credentials and permissions.
- Confirm assistant configuration IDs are correct and active.
- Check network connectivity and region settings.
Links and References
- Dust API Documentation (general reference for API endpoints and usage)
- n8n documentation on HTTP Request Node for understanding underlying HTTP calls