REST Resource: projects.locations.collections.dataStores.sessions.answers

资源：Answer

定义答案。

JSON 表示法 
{
  "name": string,
  "state": enum (State),
  "answerText": string,
  "citations": [
    {
      object (Citation)
    }
  ],
  "groundingSupports": [
    {
      object (GroundingSupport)
    }
  ],
  "references": [
    {
      object (Reference)
    }
  ],
  "relatedQuestions": [
    string
  ],
  "steps": [
    {
      object (Step)
    }
  ],
  "queryUnderstandingInfo": {
    object (QueryUnderstandingInfo)
  },
  "answerSkippedReasons": [
    enum (AnswerSkippedReason)
  ],
  "createTime": string,
  "completeTime": string,
  "safetyRatings": [
    {
      object (SafetyRating)
    }
  ],
  "groundingScore": number
}
字段
name

string

不可变。完全限定名称 projects/{project}/locations/global/collections/{collection}/engines/{engine}/sessions/*/answers/*
state

enum (State)

答案生成的状态。
answerText

string

文本答案。
citations[]

object (Citation)

引用。
groundingSupports[]

object (GroundingSupport)

可选。接地支持。
references[]

object (Reference)

参考。
relatedQuestions[]

string

建议的相关问题。
steps[]

object (Step)

回答生成步骤。
queryUnderstandingInfo

object (QueryUnderstandingInfo)

查询理解信息。
answerSkippedReasons[]

enum (AnswerSkippedReason)

其他跳过回答的原因。这提供了忽略的案例的原因。如果未跳过任何内容，则不会设置此字段。
createTime

string (Timestamp format)

仅限输出。回答创建时间戳。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
completeTime

string (Timestamp format)

仅限输出。回答完成时间戳。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"
safetyRatings[]

object (SafetyRating)

可选。安全等级。
groundingScore

number

一个介于 [0, 1] 之间的分数，用于描述答案与参考块的关联程度。

州

答案生成状态的枚举。

枚举
STATE_UNSPECIFIED 未知。
IN_PROGRESS 目前正在生成回答。
FAILED 目前无法生成回答。
SUCCEEDED 已成功生成答案。
STREAMING 目前正在生成回答。

引用

细分的引用信息。

JSON 表示法 
{
  "startIndex": string,
  "endIndex": string,
  "sources": [
    {
      object (CitationSource)
    }
  ]
}
字段
startIndex

string (int64 format)

索引表示分段的起始位置，以字节（UTF-8 Unicode）为单位。如果存在多字节字符（例如非 ASCII 字符），则索引测量值会大于字符串长度。
endIndex

string (int64 format)

归因区段的结束时间（不含）。以字节（UTF-8 Unicode）为单位。如果存在多字节字符（例如非 ASCII 字符），则索引测量值会大于字符串长度。
sources[]

object (CitationSource)

归因细分的引用来源。

CitationSource

引用来源。

JSON 表示法 
{
  "referenceId": string
}
字段
referenceId

string

引用来源的 ID。

GroundingSupport

为 answerText 中的声明提供事实依据支持。

JSON 表示法 
{
  "startIndex": string,
  "endIndex": string,
  "sources": [
    {
      object (CitationSource)
    }
  ],
  "groundingScore": number,
  "groundingCheckRequired": boolean
}
字段
startIndex

string (int64 format)

必需。索引表示声明的起始位置，以字节（UTF-8 Unicode）为单位。
endIndex

string (int64 format)

必需。声明的结束时间（不含）。
sources[]

object (CitationSource)

可选。相应声明的引用来源。
groundingScore

number

一个介于 [0, 1] 之间的分数，用于描述特定声明的依据程度。值越高，表示参考块对声明的支持程度越高。
groundingCheckRequired

boolean

表示相应声明需要进行事实依据检查。如果系统认为此声明不需要归因/依据检查，则此字段设置为 false。在这种情况下，系统不会对声明进行事实依据检查，因此不会返回 groundingScore、sources。

参考文档

参考。

JSON 表示法 
{

  // Union field content can be only one of the following:
  "unstructuredDocumentInfo": {
    object (UnstructuredDocumentInfo)
  },
  "chunkInfo": {
    object (ChunkInfo)
  },
  "structuredDocumentInfo": {
    object (StructuredDocumentInfo)
  }
  // End of list of possible types for union field content.
}
字段
联合字段 content。搜索结果内容。content 只能是下列其中一项：
unstructuredDocumentInfo

object (UnstructuredDocumentInfo)

非结构化文档信息。
chunkInfo

object (ChunkInfo)

分块信息。
structuredDocumentInfo

object (StructuredDocumentInfo)

结构化文档信息。

UnstructuredDocumentInfo

非结构化文档信息。

JSON 表示法 
{
  "document": string,
  "uri": string,
  "title": string,
  "chunkContents": [
    {
      object (ChunkContent)
    }
  ],
  "structData": {
    object
  }
}
字段
document

string

文档资源名称。
uri

string

相应文档的 URI。
title

string

标题。
chunkContents[]

object (ChunkContent)

从文档内容派生的引用块内容列表。
structData

object (Struct format)

文档的结构化 JSON 元数据。它会根据搜索结果中块的结构数据进行填充。

ChunkContent

分块内容。

JSON 表示法 
{
  "content": string,
  "pageIdentifier": string,
  "relevanceScore": number
}
字段
content

string

块状文本内容。
pageIdentifier

string

网页标识符。
relevanceScore

number

相应块与给定查询的相关性。值范围为 0.0（完全不相关）到 1.0（完全相关）。此值仅供参考。由于模型重新训练或实现的更改，此值可能会根据同一查询和块随时更改。

ChunkInfo

分块信息。

JSON 表示法 
{
  "chunk": string,
  "content": string,
  "documentMetadata": {
    object (DocumentMetadata)
  },
  "relevanceScore": number
}
字段
chunk

string

块资源名称。
content

string

块状文本内容。
documentMetadata

object (DocumentMetadata)

文档元数据。
relevanceScore

number

相应块与给定查询的相关性。值范围为 0.0（完全不相关）到 1.0（完全相关）。此值仅供参考。由于模型重新训练或实现的更改，此值可能会根据同一查询和块随时更改。

DocumentMetadata

文档元数据。

JSON 表示法 
{
  "document": string,
  "uri": string,
  "title": string,
  "pageIdentifier": string,
  "structData": {
    object
  }
}
字段
document

string

文档资源名称。
uri

string

相应文档的 URI。
title

string

标题。
pageIdentifier

string

网页标识符。
structData

object (Struct format)

文档的结构化 JSON 元数据。它会根据搜索结果中块的结构数据进行填充。

StructuredDocumentInfo

结构化搜索信息。

JSON 表示法 
{
  "document": string,
  "structData": {
    object
  },
  "title": string,
  "uri": string
}
字段
document

string

文档资源名称。
structData

object (Struct format)

结构化搜索数据。
title

string

仅限输出。文档的标题。
uri

string

仅限输出。相应文档的 URI。

步骤

步骤信息。

JSON 表示法 
{
  "state": enum (State),
  "description": string,
  "thought": string,
  "actions": [
    {
      object (Action)
    }
  ]
}
字段
state

enum (State)

相应步骤的状态。
description

string

相应步骤的说明。
thought

string

相应步骤的想法。
actions[]

object (Action)

操作。

州

相应步骤的状态枚举。

枚举
STATE_UNSPECIFIED 未知。
IN_PROGRESS 相应步骤目前正在进行中。
FAILED 相应步骤目前失败。
SUCCEEDED 相应步骤已成功完成。

操作

操作。

JSON 表示法 
{
  "observation": {
    object (Observation)
  },

  // Union field action can be only one of the following:
  "searchAction": {
    object (SearchAction)
  }
  // End of list of possible types for union field action.
}
字段
observation

object (Observation)

观察。
联合字段 action。操作。action 只能是下列其中一项：
searchAction

object (SearchAction)

搜索操作。

SearchAction

搜索操作。

JSON 表示法 
{
  "query": string
}
字段
query

string

要搜索的查询。

观察

观察。

JSON 表示法 
{
  "searchResults": [
    {
      object (SearchResult)
    }
  ]
}
字段
searchResults[]

object (SearchResult)

搜索操作观察到的搜索结果，可以是摘要信息或块信息，具体取决于用户设置的引用类型。

SearchResult

JSON 表示法 
{
  "document": string,
  "uri": string,
  "title": string,
  "snippetInfo": [
    {
      object (SnippetInfo)
    }
  ],
  "chunkInfo": [
    {
      object (ChunkInfo)
    }
  ],
  "structData": {
    object
  }
}
字段
document

string

文档资源名称。
uri

string

相应文档的 URI。
title

string

标题。
snippetInfo[]

object (SnippetInfo)

如果 citation_type 为 DOCUMENT_LEVEL_CITATION，则填充文档级摘要。
chunkInfo[]

object (ChunkInfo)

如果 citation_type 为 CHUNK_LEVEL_CITATION 且启用了块模式，则填充块信息。
structData

object (Struct format)

数据表示法。相应文档的结构化 JSON 数据。它会根据文档或搜索结果中的块的结构化数据进行填充。

SnippetInfo

代码段信息。

JSON 表示法 
{
  "snippet": string,
  "snippetStatus": string
}
字段
snippet

string

摘要内容。
snippetStatus

string

由搜索团队定义的摘要的状态。

ChunkInfo

分块信息。

JSON 表示法 
{
  "chunk": string,
  "content": string,
  "relevanceScore": number
}
字段
chunk

string

块资源名称。
content

string

块状文本内容。
relevanceScore

number

相应块与给定查询的相关性。值范围为 0.0（完全不相关）到 1.0（完全相关）。此值仅供参考。由于模型重新训练或实现的更改，此值可能会根据同一查询和块随时更改。

QueryUnderstandingInfo

查询理解信息。

JSON 表示法 
{
  "queryClassificationInfo": [
    {
      object (QueryClassificationInfo)
    }
  ]
}
字段
queryClassificationInfo[]

object (QueryClassificationInfo)

查询分类信息。

QueryClassificationInfo

查询分类信息。

JSON 表示法 
{
  "type": enum (Type),
  "positive": boolean
}
字段
type

enum (Type)

查询分类类型。
positive

boolean

分类输出。

类型

查询分类类型。

枚举
TYPE_UNSPECIFIED 未指定查询分类类型。
ADVERSARIAL_QUERY 对抗性查询分类类型。
NON_ANSWER_SEEKING_QUERY 非寻求答案的查询分类类型，用于闲聊。
JAIL_BREAKING_QUERY 越狱查询分类类型。
NON_ANSWER_SEEKING_QUERY_V2 非寻求答案的查询分类类型，表示没有明确的意图。
USER_DEFINED_CLASSIFICATION_QUERY 用户定义的查询分类类型。

AnswerSkippedReason

一个用于表示回答跳过原因的枚举。

枚举
ANSWER_SKIPPED_REASON_UNSPECIFIED 默认值。未指定跳过回答的原因。
ADVERSARIAL_QUERY_IGNORED 忽略了对抗性查询的案例。
NON_ANSWER_SEEKING_QUERY_IGNORED

不寻求答案的查询（不区分大小写）

如果查询是闲聊，Google 会跳过回答。
OUT_OF_DOMAIN_QUERY_IGNORED

网域外查询忽略了大小写。

如果没有高度相关的搜索结果，Google 会跳过回答。
POTENTIAL_POLICY_VIOLATION

可能违反政策的情况。

如果检测到潜在的违规情况，Google 会跳过回答。包括可能包含暴力或有害内容的内容。
NO_RELEVANT_CONTENT

无相关内容的情况。

如果检索到的搜索结果中没有相关内容，Google 会跳过回答。
JAIL_BREAKING_QUERY_IGNORED

越狱查询忽略了大小写。

例如，“以竞争对手公司 CEO 的语气回复”。如果查询被归类为越狱查询，Google 会跳过回答。
CUSTOMER_POLICY_VIOLATION

客户政策违规支持请求。

如果检测到违反客户政策的情况，Google 会跳过摘要。政策由客户定义。
NON_ANSWER_SEEKING_QUERY_IGNORED_V2

不寻求答案的查询（忽略大小写）。

如果查询没有明确的意图，Google 会跳过回答。
LOW_GROUNDED_ANSWER

低接地程度的回答示例。

如果无法生成有理有据的回答，Google 会跳过该回答。
USER_DEFINED_CLASSIFICATION_QUERY_IGNORED

用户定义的查询分类（忽略大小写）。

如果查询被归类为用户定义的查询类别，Google 会跳过回答。
UNHELPFUL_ANSWER

无用回答示例。

如果答案无用，Google 会跳过该答案。这可能是由多种因素造成的，包括但不限于：问题无法回答、答案与问题无关，或者答案格式不正确。

SafetyRating

与生成的内容对应的安全等级。

JSON 表示法 
{
  "category": enum (HarmCategory),
  "probability": enum (HarmProbability),
  "probabilityScore": number,
  "severity": enum (HarmSeverity),
  "severityScore": number,
  "blocked": boolean
}
字段
category

enum (HarmCategory)

仅限输出。危害类别。
probability

enum (HarmProbability)

仅限输出。内容中的有害概率级别。
probabilityScore

number

仅限输出。有害概率得分。
severity

enum (HarmSeverity)

仅限输出。内容中的危害严重程度级别。
severityScore

number

仅限输出。有害程度得分。
blocked

boolean

仅限输出。表示相应内容是否因该分级而被过滤掉。

HarmCategory

将屏蔽内容的有害类别。

枚举
HARM_CATEGORY_UNSPECIFIED 未指定有害类别。
HARM_CATEGORY_HATE_SPEECH 有害类别为仇恨言论。
HARM_CATEGORY_DANGEROUS_CONTENT 有害类别为危险内容。
HARM_CATEGORY_HARASSMENT 有害类别为骚扰。
HARM_CATEGORY_SEXUALLY_EXPLICIT 有害类别为露骨色情内容。
HARM_CATEGORY_CIVIC_INTEGRITY 有害类别为公民诚信。

HarmProbability

内容中的有害概率级别。

枚举
HARM_PROBABILITY_UNSPECIFIED 未指定有害概率。
NEGLIGIBLE 危害程度可忽略不计。
LOW 低程度的伤害。
MEDIUM 中等程度的危害。
HIGH 高程度的伤害。

HarmSeverity

危害严重程度。

枚举
HARM_SEVERITY_UNSPECIFIED 未指定有害程度。
HARM_SEVERITY_NEGLIGIBLE 可忽略的伤害严重程度。
HARM_SEVERITY_LOW 伤害严重程度较低。
HARM_SEVERITY_MEDIUM 中等程度的危害严重程度。
HARM_SEVERITY_HIGH 伤害严重程度较高。

方法

get

 获取回答。