Actions14
Import CSV File
AI-generatedOverview
This node operation imports a CSV file into a conversation set within a specified namespace. It supports importing raw or base64 gzipped CSV data, with options to specify CSV format, delimiter, header inclusion, and column mappings for IDs, dates, roles, text, and metadata. It can also import the CSV data as utterances only. This operation is useful for integrating conversation data from CSV files into a HumanFirst conversation source for further processing or analysis.
Use Case Examples
- Importing customer support chat logs stored in CSV format into a conversation source for analysis.
- Uploading conversation data with custom metadata columns for training conversational AI models.
- Importing CSV files as utterances only to quickly add conversational phrases without full metadata.
Properties
| Name | Meaning |
|---|---|
| Namespace | The namespace under which the conversation set exists. Required to identify the scope for the import. |
| Conversation Source Name or ID | The target conversation source dataset where the CSV file will be imported. Can be selected from a list or specified by ID. |
| File Data (Raw or Base64 Gzipped) | The CSV file content to import, provided as raw or base64 gzipped string data. |
| File Name | The name of the CSV file being imported. |
| Format | The format of the CSV file. Currently supports 'Simple CSV' format. |
| Header Included | Indicates whether the CSV file includes a header row. |
| Import Only As Utterances | If true, imports the CSV data only as utterances without additional metadata. |
| ID Column Index | The index of the column containing IDs in the CSV file. Used only if not importing as utterances. |
| Date Column Index | The index of the column containing date values in the CSV file. Used only if not importing as utterances. |
| Date Column Format | The format of the date values in the date column. Used only if not importing as utterances. |
| Source Role Column Index | The index of the column indicating the source role in the conversation. Used only if not importing as utterances. |
| Client Role Name | The name to assign to the client role in the conversation. Used only if not importing as utterances. |
| Agent Role Name | The name to assign to the agent role in the conversation. Used only if not importing as utterances. |
| Text Column Index | The index of the column containing the text content of the conversation. |
| Metadata Columns Indexes (Comma-Separated) | Comma-separated list of column indexes to treat as metadata. If left blank, metadata columns are auto-derived. |
| Delimiter | The delimiter character used in the CSV file. Default is a comma. |
Output
JSON
json- The JSON response from the HumanFirst API after importing the CSV file, containing import status and details.
Dependencies
- Requires an API key credential for HumanFirst API access.
Troubleshooting
- Error if no Conversation Source is selected before importing.
- Error if the file data is not provided or improperly encoded.
- Ensure the file name ends with .csv or .csv.gz for proper processing.
- Check that column indexes and formats match the CSV file structure to avoid import errors.