Content

메시지의 여러 부분으로 구성된 콘텐츠를 포함하는 기본 구조화된 데이터 유형입니다.

Content에는 Content의 생산자를 지정하는 role 필드와 메시지 차례의 콘텐츠를 포함하는 멀티파트 데이터가 포함된 parts 필드가 있습니다.

JSON 표현
{
  "parts": [
    {
      object (Part)
    }
  ],
  "role": string
}
입력란
parts[]

object (Part)

단일 메시지를 구성하는 Parts를 정렬했습니다. 부분마다 MIME 유형이 다를 수 있습니다.

role

string

선택사항입니다. 콘텐츠 제작자입니다. 'user' 또는 'model'이어야 합니다.

멀티턴 대화에 설정할 때 유용하며, 그렇지 않으면 비워두거나 설정하지 않을 수 있습니다.

부품

여러 부분으로 구성된 Content 메시지의 일부인 미디어를 포함하는 데이터 유형입니다.

Part는 연결된 데이터 유형이 있는 데이터로 구성됩니다. Part에는 Part.data에서 허용되는 유형 중 하나만 포함할 수 있습니다.

Part에는 inlineData 필드가 원시 바이트로 채워진 경우 미디어의 유형과 하위 유형을 식별하는 고정된 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)

FunctionDeclaration.name를 나타내는 문자열과 함수의 출력을 포함하는 구조화된 JSON 객체가 포함된 FunctionCall의 결과 출력은 모델의 컨텍스트로 사용됩니다.

fileData

object (FileData)

URI 기반 데이터입니다.

Blob

원시 미디어 바이트입니다.

텍스트는 원시 바이트로 전송해서는 안 됩니다. '텍스트' 필드를 사용하세요.

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

FunctionDeclaration.name를 나타내는 문자열과 함수의 출력을 포함하는 구조화된 JSON 객체가 포함된 FunctionCall의 결과 출력은 모델의 컨텍스트로 사용됩니다. 여기에는 모델 예측에 따라 수행된 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를 선택합니다.