> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/sessions-and-transcripts/export-a-transcript.md).

# 导出文字记录

从历史会话、会话列表或仍在运行的房间中，将聊天体验对话下载为 Markdown 文件。

聊天体验中的对话可以下载为 Markdown 文件，无论它已经结束还是仍在运行。使用此页面导出一个，并在打开前了解文件内容。

### 前提条件

* 其中包含消息的一个聊天体验会话。参见 [会话和文字记录](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/sessions-and-transcripts.md).

### 从体验历史中导出会话

**导出转录** 有三个位置可用：体验页面上某个会话行里、你已打开的会话标题栏里，以及对话仍在进行时该房间自己的菜单里。它们都会生成同一个文件。下面的步骤以第一个为例。

{% stepper %}
{% step %}

#### 打开体验历史

打开体验卡片或行上的三点菜单 **我的体验** 并选择 **之前的会话**.

体验页面会打开并显示它记录的每个会话，最新的在前。
{% endstep %}

{% step %}

#### 选择要导出的会话

根据会话编号、第一条问题或运行日期来找到该会话。每一行都包含这三项。
{% endstep %}

{% step %}

#### 从会话菜单导出

打开会话行右侧的三点菜单并选择 **导出转录**.

相同的导出也可在会话内部使用：选择 **打开** 在该行上，然后选择 **导出转录** 标题栏右上角的
{% endstep %}

{% step %}

#### 确认下载

浏览器会保存该文件，页面会提示 **转录已下载**。任何其他消息都意味着没有写入文件，并且会说明应改做什么。参见 [简报和文字记录](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/troubleshooting/briefs-and-transcripts.md).
{% endstep %}
{% endstepper %}

### 导出你正在进行的对话

一个房间会导出其中正在运行的会话所记录的对话，涵盖到目前为止发送的每一条消息。在有任何可导出的内容之前，角色必须已就座且对话必须已经开始。打开房间顶部栏中的三点菜单并选择 **导出转录**.

返回到 **我的体验** 之后不会让你失去这段对话。它会被记录为该体验的一个会话，并且可以再次从体验页面导出。

### Markdown 文件包含什么

{% hint style="warning" %}
超过 200 [轮](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/running-the-room/how-a-turn-works.md) 会导出其前 200 个回合，不多不少，无论是哪三种路径中的哪一种生成了该文件。若某个会话已经超过该限制，在导出前，它自己的线程顶部备注中会说明这一点。
{% endhint %}

该文件是纯 Markdown，可在任何文本编辑器中读取。它以一个标题开头，写着 `# 房间` ，后面跟着该会话的标识符；这是文件中唯一将其与某个会话关联起来的内容：文件里既没有写入会话编号，也没有写入体验名称或运行日期。

标题之后是每个回合各一节：你的消息，后面跟着它引出的每个回复各一行。若某个回合包含文件，则会在两者之间加入一行斜体文字，列出这些文件：

{% code title="room-3f8c1a44-e2d7-4f5c-9d0e-2a416f0c2b7e.md" %}

```markdown
# 房间 3f8c1a44-e2d7-4f5c-9d0e-2a416f0c2b7e

## 回合 1 — open

这是上季度的定价。有什么特别之处？

_附件：q3-pricing.pdf_

**Maya**：续订率是那个异常值。
**Luis**：_已通过_

## 回合 2 — 标记

Maya，你怎么看这个价格？

**Maya**：就它所提供的内容而言，感觉偏高。
```

{% endcode %}

回合按对话开始时的顺序编号，回合编号后面的词表示该回合是如何被称呼的： `全部` 用于需要所有人都回应的消息， `标记` 用于点名需要的角色的消息，和 `开放` 用于房间可以自由回应或不回应的消息。最后这个词涵盖了在 **自动 · 房间简介决定** 下发送的回合和在 **任何人都可回复** 下发送的回合，因此文件不会说明某个回合究竟是在这两者中的哪一种下进行的。参见 [转录不会记录什么](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/sessions-and-transcripts/review-a-past-session.md#what-a-transcript-does-not-record) 以及已保存对话还会留下的其他内容。

在一个 `开放` 回合中保持沉默的角色，会单独占一行，写作 `_已通过_`，而不是会话页面在其位置上显示的那条单一说明。附件行会列出该回合共享的文件名，这些名字就是它保留的全部内容：转录中不会携带文件内容。

### 该文件叫什么

名称是 `room-` 后接会话自身的标识符，以及 `.md`，因此上面的示例会下载为 `room-3f8c1a44-e2d7-4f5c-9d0e-2a416f0c2b7e.md`.

每个会话都有自己的标识符。因此，导出同一体验的多个会话会生成多个名称不同的文件，而且它们互不覆盖。该名称不使用房间顶部栏中显示的房间 ID，而后者对于一个体验中的每个会话都是相同的。

### 下一步

{% content-ref url="/pages/3891ccc0535444943ba47b4ffa0609cbcbe6ec1c" %}
[回顾过去的会话](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/sessions-and-transcripts/review-a-past-session.md)
{% endcontent-ref %}

{% content-ref url="/pages/bd8ecd0a747fe5a0b24502f315519d2b336ad2d9" %}
[简报与文字记录](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/troubleshooting/briefs-and-transcripts.md)
{% endcontent-ref %}

{% content-ref url="/pages/509e5c9e359bae6108394a8d3af4b9edef4c4c86" %}
[会话与文字记录](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/sessions-and-transcripts.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.convai.com/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/sessions-and-transcripts/export-a-transcript.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.