> 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 · 无法描述` | 仅文件名                 |

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

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

无法描述的图片仍会仅以名称发送。角色只会得到文件名，除此之外别无其他，而且消息不会被拦截。

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

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