> 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/share-files-with-the-room/share-an-image.md).

# 共享图片

在聊天体验房间中给消息附加图片，并了解角色收到的是文字描述，而不是图片本身。

你在聊天体验房间中附加到消息上的图片，会以文字形式到达角色。使用此页面来附加一张 `.png`, `.jpg`，或者 `.jpeg` 图片，将其随消息发送，并确切了解角色会被告知什么。

### 前提条件

* 至少已有一个角色在内的聊天体验房间。参见 [向房间添加角色](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/add-characters-to-the-room.md).
* 一种受支持格式的图片。参见 [文件限制参考](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/share-files-with-the-room/file-limits-reference.md).

### 附加图片并发送

{% stepper %}
{% step %}

#### 选择图片

选择输入框左侧、位于你输入位置下方的回形针图标，然后选择文件。你可以一次选择多个文件。

在你输入的位置上方会出现一个标签，包含格式、文件名，以及第二行，写着 `正在读取…` ，在大小之后。
{% endstep %}

{% step %}

#### 等待描述

第二行会变为 `正在描述…` ，在图片被描述期间，并在完成后变为 `已描述` 在每个标签都稳定下来之前，发送控件一直不可用。

描述图片需要几秒，而不是文本文件那种瞬间完成的速度。等待是正常的，发送控件会自行恢复。
{% endstep %}

{% step %}

#### 撰写消息并发送

像往常一样写下你的问题并发送消息。该标签会移动到你文字上方的对话线程中，文件会被添加到侧边栏的 **在房间中共享** 部分。

如果你想就图片获得回答，可以在同一条消息中提问。在 **自动 · 由房间简介决定**，房间打开时所处的模式下，发出的图片如果没有附带问题，就不会指向任何特定对象，而未被点名的角色会保持沉默。
{% endstep %}
{% endstepper %}

{% hint style="success" %}
图片到达角色时，其在对话线程中的标签显示为 `已描述` 在大小之后，而文件会列在 **在房间中共享** 于侧边栏中。
{% endhint %}

### 谁会收到图片

无论回合指向谁，谁就会收到图片。消息未指向的角色不会得到描述，随后出现的回复也不会再转述它。若要让图片出现在每个角色面前，请标记 `@everyone` 或者将回复标签设为 **所有人都必须回复** ，然后再发送。参见 [选择谁回复](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/running-the-room/choose-who-replies.md).

### 角色被告知了什么

角色永远不会收到图片。他们收到的是对图片的文字描述，而他们的回答就是基于这段描述。

这段描述不是自行传递的：角色会被告知这些文字是在描述你附加的一张图片，并会被要求根据这些文字作答，仿佛他们正在看图片，而不是说自己看不见它。因此，回答看起来就像角色确实看过这张图片一样，而描述遗漏的任何内容，其回答时的笃定程度与它涵盖的内容相同。

由此会带来两点，在你附加之前都值得知道：

* **描述不是图片。** 描述中未提及的细节，角色就没有这些细节，而回答中不会标明这种差异。若答案取决于细微细节，请把它与眼前的图片核对。
* **询问你希望涵盖的内容。** 用问题点明图片中重要之处，比不加任何问题直接附加它更能得到有用的回答。

### 标签报告的内容

标签的第二行总是以文件大小开头。后面的内容告诉你角色得到了什么：

| 第二行显示为           | 角色收到的内容              |
| ---------------- | -------------------- |
| `1.1 MB · 正在描述…` | 还没有。图片正在被描述，发送控件正在等待 |
| `1.1 MB · 已描述`   | 对图片的文字描述             |
| `1.1 MB · 无法描述`  | 仅文件名                 |

侧边栏会重复显示第二行，并在旁边添加一条简短说明。在 **在房间中共享**中，已描述的图片标记为 `已描述`，而仅以其名称共享的图片标记为 `仅名称`.

### 当图片仅以名称共享时

无法描述的图片仍会发送，但只会以名称形式发送。角色只会得到文件名，其他什么都不会得到，消息也不会被拦下。

房间会在两个地方同时告诉你。标签的第二行会变为 `无法描述` 在大小之后，并且会显示一条消息：“无法描述⟨名称⟩；将只共享其名称”。

{% hint style="warning" %}
在发送会影响对话的图片之前，请先检查标签。文件名只会告诉角色有东西被附加了，却不会说明其中有什么，所以他们作答时根本不会提及图片内容。
{% endhint %}

### 后续步骤

一份自身几乎没有文字内容的 PDF，会像图片一样被描述，其标签也会显示页数。

{% content-ref url="/pages/249ce1883d72f03fd0e4615caaa45c3e1b7cfee3" %}
[共享文档](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/share-files-with-the-room/share-a-document.md)
{% endcontent-ref %}

关于受支持的格式、大小和文本限制，以及各自会发生什么：

{% content-ref url="/pages/ef00b5fe3ac7c15b9e6fdc1fbf5eec9658ba9228" %}
[文件限制参考](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/share-files-with-the-room/file-limits-reference.md)
{% endcontent-ref %}

如果一张图片引来的回答偏离了图片本身，或者根本没有回答，请从屏幕上你能看到的内容开始排查： [排查聊天体验问题](/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/troubleshooting.md).


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.convai.com/api-docs/zh/wu-dai-ma-ti-yan/chat-experiences/share-files-with-the-room/share-an-image.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.