聊天机器人

在聊天机器人中显示的默认消息列表，每条消息的格式为 {"role": "user", "content": "Help me."}。Role 可以是 "user"、"assistant" 或 "system" 之一。Content 应为文本，或作为 Gradio 组件传递的媒体，例如 {"content": gr.Image("lion.jpg")}。如果提供了函数，则每次加载应用程序时都会调用该函数来设置此组件的初始值。

此组件的标签。显示在组件上方，如果该组件有示例表格，也用作标题。如果为 None 且在 `gr.Interface` 中使用，则标签将是此组件分配到的参数名称。

持续调用 `value` 来重新计算它（如果 `value` 是一个函数，否则无效）。可以提供一个 Timer，其滴答声会重置 `value`，或者提供一个浮点数来为重置 Timer 提供常规间隔。

用作计算 `value` 的输入的组件（如果 `value` 是一个函数，否则无效）。`value` 在输入更改时会重新计算。

如果为 True，将显示标签。

如果为 True，则会将组件放置在容器中，在边框周围提供一些额外的填充。

与相邻组件相比的相对大小。例如，如果组件 A 和 B 在一个 Row 中，A 的 scale 为 2，B 的 scale 为 1，则 A 的宽度将是 B 的两倍。应为整数。scale 适用于 Rows，以及 Blocks 中 fill_height=True 的顶级组件。

最小像素宽度，如果屏幕空间不足以满足此值，则会换行。如果某个 scale 值导致此组件比 min_width 窄，则将首先考虑 min_width 参数。

如果为 False，则组件将隐藏。如果为“hidden”，则组件将视觉上隐藏并且不会在布局中占用空间，但仍存在于 DOM 中。

一个可选字符串，用作此组件在 HTML DOM 中的 id。可用于定位 CSS 样式。

一个可选的字符串列表，用作此组件在 HTML DOM 中的类。可用于定位 CSS 样式。

如果为 True，当值更改时，文本框将自动滚动到底部，除非用户向上滚动。如果为 False，当值更改时，文本框将不会滚动到底部。

如果为 False，则组件不会在 Blocks 上下文中渲染。如果打算现在分配事件监听器，但稍后渲染组件，则应使用此选项。

在 `gr.render` 中，跨重渲染具有相同键的组件被视为同一个组件，而不是一个新组件。在 `preserved_by_key` 中设置的属性在重渲染时不会重置。

此组件构造函数中的参数列表。在 `gr.render()` 函数内部，如果一个组件使用相同的键进行重渲染，则这些（也是唯一的）参数将在 UI 中被保留（如果它们已被用户或事件监听器更改），而不是根据构造函数中提供的值进行重渲染。

组件的高度，如果传递数字，则以像素为单位指定；如果传递字符串，则以 CSS 单位指定。如果消息超过高度，组件将滚动。

如果为 True，则 Gradio 应用程序的用户可以通过拖动右下角来调整聊天机器人的大小。

组件的最大高度，如果传递数字，则以像素为单位指定；如果传递字符串，则以 CSS 单位指定。如果消息超过高度，组件将滚动。如果消息短于高度，组件将收缩以适应内容。如果设置了 height 且其值小于 max_height，则此参数将不起作用。

组件的最小高度，如果传递数字，则以像素为单位指定；如果传递字符串，则以 CSS 单位指定。如果消息超过高度，组件将扩展以适应内容。如果设置了 height 且其值大于 min_height，则此参数将不起作用。

允许用户编辑聊天机器人中的消息。如果设置为 "user"，则允许编辑用户消息。如果设置为 "all"，则还允许编辑助手消息。

一个字典列表，形式为 {"left": 开头定界符 (str), "right": 结尾定界符 (str), "display": 是否在新行中显示 (bool)}，用于渲染 LaTeX 表达式。如果未提供，则 `latex_delimiters` 设置为 `[{ "left": "$$", "right": "$$", "display": True }]`，因此只有用 $$ 定界符括起来的表达式将在新行中渲染为 LaTeX。传递空列表可禁用 LaTeX 渲染。有关更多信息，请参阅 KaTeX 文档。

如果为 True，则将渲染文本的方向设置为从右到左。默认为 False，表示从左到右渲染文本。

显示在组件右上角的按钮列表。有效选项是 "share"、"copy"、"copy_all" 或 gr.Button() 实例。"share" 按钮允许用户将输出共享到 Hugging Face Spaces 讨论。"copy" 按钮将在每个单独的聊天机器人消息旁边显示一个复制按钮。"copy_all" 按钮显示在组件级别，允许用户复制所有聊天机器人消息。自定义 gr.Button() 实例将以其配置的图标和/或标签显示在工具栏中，单击它们将触发在按钮上注册的任何 .click() 事件。默认情况下，显示 "share" 和 "copy_all" 按钮。

如果提供，此文本将在聊天机器人中复制的消息末尾追加，后跟一个空行。有助于表明消息是由 AI 模型生成的。

用户和机器人的头像图片路径或 URL 的元组（按此顺序）。为用户或机器人图像传递 None 以跳过。必须在 Gradio 应用程序的工作目录内或作为外部 URL。

如果为 False，将禁用对聊天机器人消息的 HTML 清理。不推荐这样做，因为它可能导致安全漏洞。

如果为 False，将禁用聊天机器人消息的 Markdown 渲染。

用户将看到的反馈选项字符串列表。精确的大小写敏感字符串 "Like" 和 "Dislike" 将渲染为拇指图标，但任何其他选择将出现在单独的旗帜图标下。

整个聊天的反馈状态的字符串列表。仅当 type="messages" 时有效。列表中的每个条目对应于该助手消息（按顺序），值是给出的反馈（例如，“Like”、“Dislike”或任何自定义反馈选项），如果没有为该消息提供反馈，则为 None。

如果为 True（默认），将启用聊天机器人消息中的 Github 风格 Markdown 换行符。如果为 False，则单个换行符将被忽略。仅当 `render_markdown` 为 True 时有效。

如果为 "panel"，则将以 LLM 风格的布局显示聊天机器人。如果为 "bubble"，则将以消息气泡的形式显示聊天机器人，用户和机器人消息将交替显示。将默认为 "bubble"。

在聊天机器人为空时显示的占位符消息。在聊天机器人中垂直和水平居中。支持 Markdown 和 HTML。如果为 None，则不显示占位符。

在显示任何用户/助手消息之前，在聊天机器人中显示的示例消息列表。每个示例都应是一个字典，其中包含一个可选的 "text" 键，表示单击时应填充到聊天机器人中的消息，一个可选的 "files" 键，其值应为要填充到聊天机器人中的文件列表，一个可选的 "icon" 键，其值应为显示在示例框中的图像的文件路径或 URL，以及一个可选的 "display_text" 键，其值应为显示在示例框中的文本。如果未提供 "display_text"，则将显示 "text" 的值。

如果为 True，将为包含媒体的聊天机器人消息显示下载按钮。默认为 True。

如果为 True，将把来自同一角色的连续消息显示在同一个气泡中。如果为 False，则将每条消息显示在单独的气泡中。默认为 True。

如果提供了标签列表，这些标签将在输出的聊天机器人消息中保留，即使 `sanitize_html` 为 `True`。例如，如果此列表为 ["thinking"]，则 `<thinking>` 和 `</thinking>` 标签将不会被删除。如果为 True，则所有自定义标签（非标准 HTML 标签）都将保留。如果为 False，则不保留任何标签。默认值为 'True'。

如果提供，则是一个元组列表，包含 (open_tag, close_tag) 字符串。这些标签之间的任何文本都将被提取并显示在一个单独的可折叠消息中，元数据为 {"title": "Reasoning"}。例如，[("<thinking>", "</thinking>")] 将提取 <thinking> 和 </thinking> 标签之间的内容。每个思考块将显示为一个单独的可折叠消息，位于主响应之前。如果为 None（默认），则不执行自动提取。

如果为 True，还将为用户消息显示喜欢/不喜欢按钮。默认为 False。