Importing historical data from a file into AI agents

You can import historical data to the conversation logs to help your AI agent learn about your customers' behavior faster. Historical data is all the conversations your customers have had with your support team.
You can import data directly from your CRM platform or manually in a TSV file as described in this article.

This article covers the following topics:

About historical data
Creating the file
Importing the file



About historical data

Historical data is all the conversations your customers have had with your support team. It gives the AI agent an accurate picture of your most frequent inquiries.
By running the data through a pre-trained model and using AI-based clustering, you can identify the most frequent topics in your historical data. These topics are a great starting point for you to create the initial intents. The initial intents and their structure is the foundation of your AI model that directly impacts your AI agent's ability to understand different inquiries from your customers.
All imported data is sanitized and GDPR compliant. No PII data is imported. To learn more about how data is processed, see About data processing in AI agents.


Creating the file

You must create a file with your historical data to upload. The file should contain the necessary parameters, separated with a tab, and be saved as TSV format. A sample file and a template are attached to the bottom of this article.
The following table lists the parameters to include in the file.






Parameter
Description



conversationId
Identifies messages that are part of the same conversation. Messages in the same conversation have the same conversationId. Format is up to you.


sendTime
Timestamp when the message was sent. Format should follow the ISO 8601 standard. For example, 2025-03-22T04:55:51+00:00.


senderType
Indicates who the message is from, either "agent" or "customer."


text
Message that was sent.


agentId
(Optional) Identifier for the customer support agent. This is used for agent statistics.



Table 1.


Importing the file

After you create your file, you can import it.

To import the file


In the AI agents workspace, select the AI agent you want to work with.

Click Conversation logs in the sidebar.
Click the options menu in the bottom right corner, then select Import TSV.
Click Select a file, then select the import file you created.
Under Benchmark Model, select one of the following:
Clustering generates a report based on clustering. Select this if your AI agent has been running for a while and you want to gain insights into how you can improve your AI agent.
Import only does not generate an automation report. Select this if your AI agent is new and you're just importing historical data. You can generate a report later, if you want.


Click Import.


The imported data appears in the conversation logs. If you receive an error message importing the file, see Data import error.


{
"@context": "https://schema.org",
"@type": "TechArticle",
"@id": "https://support.zendesk.com/hc/en-us/articles/8357758700570",
"url": "https://support.zendesk.com/hc/en-us/articles/8357758700570",
"headline": "Importing historical data from a file into AI agents - Advanced",
"description": "You can import historical customer conversation data in TSV format to train your AI agent by creating a file with specific parameters and uploading it through the conversation logs interface.",
"articleSection": "Importing data for advanced AI agents",
"datePublished": "2024-11-11T22:28:05+00:00",
"dateModified": "2026-04-21T16:16:15.144182+00:00",
"inLanguage": "en-US",
"mainEntityOfPage": {
"@type": "WebPage",
"@id": "https://support.zendesk.com/hc/en-us/articles/8357758700570"
},
"author": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"publisher": {
"@type": "Organization",
"name": "Zendesk",
"@id": "https://www.zendesk.com"
},
"isPartOf": {
"@type": "WebSite",
"name": "Zendesk Help",
"@id": "https://support.zendesk.com/hc/"
},
"about": {
"@type": "SoftwareApplication",
"name": "Zendesk",
"@id": "https://www.zendesk.com",
"softwareAddOn": {
"@type": "SoftwareApplication",
"name": "AI agents",
"@id": "https://support.zendesk.com/hc/en-us/sections/8988994355994"
}
}
}