包含消息的多部分内容的基本结构化数据类型。
Content
包含一个 role
字段(用于指定 Content
的提供方)和一个 parts
字段(后者包含多部分数据,其中包含消息回合的内容)。
JSON 表示法 |
---|
{
"parts": [
{
object ( |
字段 | |
---|---|
parts[] |
构成单个消息的有序 |
role |
可选。内容的制作者。必须是“user”或“model”。 对于多轮对话非常有用,否则可留空或未设置。 |
部分
数据类型,包含属于多部分 Content
消息一部分的媒体。
Part
由具有关联数据类型的数据组成。Part
只能包含 Part.data
中可接受的类型之一。
如果 inlineData
字段填充了原始字节,则 Part
必须具有固定的 IANA MIME 类型,用于标识媒体的类型和子类型。
JSON 表示法 |
---|
{ // Union field |
字段 | |
---|---|
联合字段
|
|
text |
内嵌文本。 |
inlineData |
内嵌媒体字节。 |
functionCall |
从模型返回的预测 |
functionResponse |
|
fileData |
基于 URI 的数据。 |
Blob
原始媒体字节。
文本不应以原始字节的形式发送,请使用“text”字段。
JSON 表示法 |
---|
{ "mimeType": string, "data": string } |
字段 | |
---|---|
mimeType |
源数据的 IANA 标准 MIME 类型。接受的类型包括:“image/png”、“image/jpeg”、“image/heic”、“image/heif”、“image/webp”。 |
data |
媒体格式的原始字节。 使用 base64 编码的字符串。 |
FunctionCall
从模型返回的预测 FunctionCall
,其中包含一个表示 FunctionDeclaration.name
的字符串以及相应参数及其值。
JSON 表示法 |
---|
{ "name": string, "args": { object } } |
字段 | |
---|---|
name |
必需。要调用的函数名称。必须为 a-z、A-Z、0-9,或包含下划线和短划线,长度上限为 63 个字符。 |
args |
可选。采用 JSON 对象格式的函数参数和值。 |
FunctionResponse
FunctionCall
的结果输出(包含表示 FunctionDeclaration.name
的字符串)和包含函数任何输出的结构化 JSON 对象将用作模型的上下文。它应包含基于模型预测结果进行的 FunctionCall
的结果。
JSON 表示法 |
---|
{ "name": string, "response": { object } } |
字段 | |
---|---|
name |
必需。要调用的函数名称。必须为 a-z、A-Z、0-9,或包含下划线和短划线,长度上限为 63 个字符。 |
response |
必需。JSON 对象格式的函数响应。 |
FileData
基于 URI 的数据。
JSON 表示法 |
---|
{ "mimeType": string, "fileUri": string } |
字段 | |
---|---|
mimeType |
可选。源数据的 IANA 标准 MIME 类型。 |
fileUri |
必需。URI。 |