Actions20
- Assistant Actions
- Embedding Actions
- File Actions
- Report Actions
- Text Actions
- Thread Actions
Overview
The "Run Existing Thread" operation in the OpenAI Analytics node allows users to execute a previously created conversation thread with an AI assistant. This operation sends messages to an existing thread, optionally attaches files, and waits for the assistant's response. It is useful for continuing or reusing prior conversations without creating new threads from scratch.
Common scenarios include:
- Resuming a paused or ongoing AI conversation.
- Running predefined conversation flows stored as threads.
- Automating interactions where the context is preserved in a thread.
Practical example:
- You have a support chatbot thread that handles customer queries. Using this operation, you can send new messages to that thread and get updated responses based on the previous conversation context.
Properties
| Name | Meaning |
|---|---|
| Authentication | Choose between using dedicated OpenAI Analytics API credentials or existing OpenAI API credentials. Options: "OpenAI Analytics API", "OpenAI API". |
| File IDs | Select one or more file IDs to attach to the thread from existing uploaded files. |
| Select Assistant | Method to select the assistant for running the thread. Options: "From List" (select from available assistants), "By ID" (enter assistant ID manually). |
| Assistant | When selecting assistant "From List", choose the assistant from a dynamically loaded list. |
| Assistant ID | When selecting assistant "By ID", enter the assistant's ID string directly. |
Output
The node outputs the result of running the existing thread. The output JSON typically contains the assistant's response messages and any relevant metadata about the run.
If the thread execution involves binary data attachments or file uploads, those are handled internally but not explicitly exposed in the output JSON.
Dependencies
- Requires valid API authentication credentials for either the OpenAI Analytics API or the standard OpenAI API.
- Needs access to the OpenAI environment configured with appropriate API keys and optional organization IDs.
- Uses OpenAI SDK client initialized per execution to interact with the OpenAI services.
- Dynamically loads assistants and files via helper methods that call OpenAI endpoints.
Troubleshooting
- Invalid Assistant ID: If the assistant ID provided does not exist or is incorrect, the node will fail to run the thread. Verify the assistant ID or select from the list.
- File Attachment Errors: Attaching invalid or unauthorized file IDs may cause errors. Ensure files are uploaded and accessible with correct permissions.
- Authentication Failures: Incorrect or missing API credentials will prevent the node from connecting to OpenAI services. Check credential configuration.
- Timeouts Waiting for Completion: If waiting for the thread run to complete exceeds the maximum poll time, the node may timeout. Adjust the "Maximum Poll Time" property accordingly.
- Empty or Missing Thread ID: Although not shown in the properties here, ensure the thread ID used corresponds to an existing thread.
Links and References
- OpenAI API Documentation
- OpenAI Analytics API Overview
- n8n documentation on Creating Custom Nodes
This summary is based solely on static analysis of the provided source code and property definitions for the "Thread" resource and "Run Existing Thread" operation.