Content

包含消息的多部分内容的基本结构化数据类型。

Content 包含一个 role 字段(用于指定 Content 的提供方)和一个 parts 字段(后者包含多部分数据,其中包含消息回合的内容)。

JSON 表示法
{
  "parts": [
    {
      object (Part)
    }
  ],
  "role": string
}
字段
parts[]

object (Part)

构成单个消息的有序 Parts。各个部分可能具有不同的 MIME 类型。

role

string

可选。内容的制作者。必须是“user”或“model”。

对于多轮对话非常有用,否则可留空或未设置。

部分

数据类型,包含属于多部分 Content 消息一部分的媒体。

Part 由具有关联数据类型的数据组成。Part 只能包含 Part.data 中可接受的类型之一。

如果 inlineData 字段填充了原始字节,则 Part 必须具有固定的 IANA MIME 类型,用于标识媒体的类型和子类型。

JSON 表示法
{

  // Union field data can be only one of the following:
  "text": string,
  "inlineData": {
    object (Blob)
  },
  "functionCall": {
    object (FunctionCall)
  },
  "functionResponse": {
    object (FunctionResponse)
  },
  "fileData": {
    object (FileData)
  }
  // End of list of possible types for union field data.
}
字段

联合字段 data

data 只能是下列其中一项:

text

string

内嵌文本。

inlineData

object (Blob)

内嵌媒体字节。

functionCall

object (FunctionCall)

从模型返回的预测 FunctionCall,其中包含一个表示 FunctionDeclaration.name 的字符串以及相应参数及其值。

functionResponse

object (FunctionResponse)

FunctionCall 的结果输出(包含表示 FunctionDeclaration.name 的字符串和包含函数任何输出的结构化 JSON 对象)将用作模型的上下文。

fileData

object (FileData)

基于 URI 的数据。

Blob

原始媒体字节。

文本不应以原始字节的形式发送,请使用“text”字段。

JSON 表示法
{
  "mimeType": string,
  "data": string
}
字段
mimeType

string

源数据的 IANA 标准 MIME 类型。接受的类型包括:“image/png”、“image/jpeg”、“image/heic”、“image/heif”、“image/webp”。

data

string (bytes format)

媒体格式的原始字节。

使用 base64 编码的字符串。

FunctionCall

从模型返回的预测 FunctionCall,其中包含一个表示 FunctionDeclaration.name 的字符串以及相应参数及其值。

JSON 表示法
{
  "name": string,
  "args": {
    object
  }
}
字段
name

string

必需。要调用的函数名称。必须为 a-z、A-Z、0-9,或包含下划线和短划线,长度上限为 63 个字符。

args

object (Struct format)

可选。采用 JSON 对象格式的函数参数和值。

FunctionResponse

FunctionCall 的结果输出(包含表示 FunctionDeclaration.name 的字符串)和包含函数任何输出的结构化 JSON 对象将用作模型的上下文。它应包含基于模型预测结果进行的 FunctionCall 的结果。

JSON 表示法
{
  "name": string,
  "response": {
    object
  }
}
字段
name

string

必需。要调用的函数名称。必须为 a-z、A-Z、0-9,或包含下划线和短划线,长度上限为 63 个字符。

response

object (Struct format)

必需。JSON 对象格式的函数响应。

FileData

基于 URI 的数据。

JSON 表示法
{
  "mimeType": string,
  "fileUri": string
}
字段
mimeType

string

可选。源数据的 IANA 标准 MIME 类型。

fileUri

string

必需。URI。