REST Resource: projects.locations.collections.engines.sessions.assistAnswers

资源:AssistAnswer

AssistAnswer 资源,AssistResponse 的主要组成部分。

JSON 表示法
{
  "name": string,
  "state": enum (State),
  "replies": [
    {
      object (Reply)
    }
  ],
  "diagnosticInfo": {
    object
  },
  "assistSkippedReasons": [
    enum (AssistSkippedReason)
  ],
  "requiredAuthorizations": [
    {
      object (RequiredAuthorization)
    }
  ],
  "customerPolicyEnforcementResult": {
    object (CustomerPolicyEnforcementResult)
  }
}
字段
name

string

不可变。标识符。AssistAnswer 的资源名称。格式:projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/assistAnswers/{assistAnswer}

此字段必须是采用 UTF-8 编码的字符串,长度限制为 1024 个字符。

state

enum (State)

回答生成的状态。

replies[]

object (Reply)

助理的回复。

diagnosticInfo

object (Struct format)

可选。处理请求时收集的诊断信息。此属性仅供人类读者使用,主要用于帮助调试。数据结构可能会发生变化,恕不另行通知。

assistSkippedReasons[]

enum (AssistSkippedReason)

不回答辅助通话的原因。

requiredAuthorizations[]

object (RequiredAuthorization)

仅限输出。所需授权的列表。仅当用户未获得特定 Authorization 的授权,但所调用的代理需要该授权时填充。

customerPolicyEnforcementResult

object (CustomerPolicyEnforcementResult)

可选。该字段包含有关各种政策检查结果的信息,例如禁用短语或 Model Armor 检查。仅当因违反政策而跳过辅助通话时填充。

状态

回答生成的状态。

枚举
STATE_UNSPECIFIED 未知。
IN_PROGRESS 辅助操作目前正在进行中。
FAILED 辅助操作失败。
SUCCEEDED 辅助操作已成功完成。
SKIPPED 辅助操作已被跳过。
CANCELLED 辅助操作已取消(例如,客户端关闭了流)。可能包含部分响应。

回复

多部分组成的辅助通话回答的一个部分。

JSON 表示法
{
  "replyId": string,
  "createTime": string,

  // Union field reply can be only one of the following:
  "groundedContent": {
    object (AssistantGroundedContent)
  }
  // End of list of possible types for union field reply.
}
字段
replyId

string

仅限输出。设置后,可唯一标识 AssistAnswer 资源中的回复。在 AssistantService.StreamAssist 调用期间,响应流中(在多个 StreamAssistResponse 消息中)可能会出现多个具有相同 ID 的 Reply 消息。这些元素表示最终 AssistAnswer 资源中单个 Reply 消息的部分内容。

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"

联合字段 reply。助理回复的替代方案。reply 只能是下列其中一项:
groundedContent

object (AssistantGroundedContent)

助理可能提供的接地回答文本或媒体。

AssistantGroundedContent

一段内容,可能是接地信息。

并非所有内容都需要接地。“Of course, I will gladly search it for you.”之类的短语不需要接地。

JSON 表示法
{
  "content": {
    object (AssistantContent)
  },
  "citationMetadata": {
    object (CitationMetadata)
  },
  "contentMetadata": {
    object (ContentMetadata)
  },

  // Union field metadata can be only one of the following:
  "textGroundingMetadata": {
    object (TextGroundingMetadata)
  }
  // End of list of possible types for union field metadata.
}
字段
content

object (AssistantContent)

内容。

citationMetadata

object (CitationMetadata)

生成内容的来源归因。另请参阅 https://cloud.google.com/vertex-ai/generative-ai/docs/learn/overview#citation_check

contentMetadata

object (ContentMetadata)

可选。内容的元数据。目前仅用于研究助理的回答。

联合字段 metadata。各种模态的接地元数据。目前仅支持文本。metadata 只能是下列其中一项:
textGroundingMetadata

object (TextGroundingMetadata)

基于文本来源的接地的元数据。

TextGroundingMetadata

文本来源的接地详细信息。

JSON 表示法
{
  "segments": [
    {
      object (Segment)
    }
  ],
  "visualSegments": [
    {
      object (VisualSegment)
    }
  ],
  "references": [
    {
      object (Reference)
    }
  ],
  "searchEntryPoints": [
    {
      object (SearchEntryPoint)
    }
  ]
}
字段
segments[]

object (Segment)

文本部分的接地信息。

visualSegments[]

object (VisualSegment)

视觉内容部分的接地信息。

references[]

object (Reference)

已接地文本的引用。

searchEntryPoints[]

object (SearchEntryPoint)

可选。用于建立依据的网页搜索的 Google 搜索入口点。

细分

文本段的接地信息。

JSON 表示法
{
  "startIndex": string,
  "endIndex": string,
  "referenceIndices": [
    integer
  ],
  "groundingScore": number,
  "text": string
}
字段
startIndex

string (int64 format)

从零开始的索引,用于指示片段的起始位置,以 UTF-8 字符串的字节数来衡量(即,以多个字节编码的字符的长度大于 1)。

endIndex

string (int64 format)

片段的结束位置(不含)。

referenceIndices[]

integer

片段的引用。

groundingScore

number

片段得分。

text

string

片段本身。

VisualSegment

视觉片段的接地信息。

JSON 表示法
{
  "referenceIndices": [
    integer
  ],
  "contentId": string
}
字段
referenceIndices[]

integer

视觉片段的参考。

contentId

string

视觉片段的内容 ID。为了显示视觉元素的引用信息,此 contentId 需要与 groundedContent.content_metadata.content_id 字段匹配。

参考文档

引用的内容和相关文档元数据。

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

string

引用的文本内容。

codeSnippet

string

引用文档中的代码段块。

documentMetadata

object (DocumentMetadata)

文档元数据

DocumentMetadata

文档元数据

JSON 表示法
{
  "language": enum (Language),
  "boundingBoxes": [
    {
      object (BoundingBox)
    }
  ],
  "document": string,
  "uri": string,
  "title": string,
  "pageIdentifier": string,
  "domain": string,
  "mimeType": string
}
字段
language

enum (Language)

boundingBoxes[]

object (BoundingBox)

可选。相应参考的边界框。重复使用以支持跨多个页面的引用。

document

string

文档资源名称。

uri

string

文档的 URI。它可能包含重定向到实际网站的网址。

title

string

标题。

pageIdentifier

string

页面标识符。

domain

string

文档 URI 中的域名。请注意,uri 字段可能包含重定向到实际网站的网址,在这种情况下,该字段会包含目标网站的域名。

mimeType

string

文档的 MIME 类型。https://www.iana.org/assignments/media-types/media-types.xhtml

语言

所引用内容的语言。目前,它仅用于代码。

枚举
LANGUAGE_UNSPECIFIED
PYTHON
SQL

BoundingBox

生成单个网页的边界框。

JSON 表示法
{
  "pageNumber": string,
  "boundingPoly": {
    object (BoundingPoly)
  }
}
字段
pageNumber

string

boundingPoly

object (BoundingPoly)

文档中文字内容的边界多边形。

BoundingPoly

文档中文字内容的边界多边形。

JSON 表示法
{
  "normalizedVertices": [
    {
      object (NormalizedVertex)
    }
  ]
}
字段
normalizedVertices[]

object (NormalizedVertex)

NormalizedVertex

顶点表示图片中的 2D 点。

注意:标准化顶点坐标相对于原始图片,范围介于 0 和 1 之间。

JSON 表示法
{
  "x": number,
  "y": number
}
字段
x

number

X 坐标。

y

number

Y 坐标(从图片顶部开始)。

SearchEntryPoint

Google 搜索入口点。

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

string

可嵌入网页或应用 WebView 中的 Web 内容代码段。

AssistantContent

多模态内容。

JSON 表示法
{
  "role": string,
  "thought": boolean,

  // Union field data can be only one of the following:
  "text": string,
  "inlineData": {
    object (Blob)
  },
  "file": {
    object (File)
  },
  "executableCode": {
    object (ExecutableCode)
  },
  "codeExecutionResult": {
    object (CodeExecutionResult)
  }
  // End of list of possible types for union field data.
}
字段
role

string

内容的提供方。可以是“model”或“user”。

thought

boolean

可选。表示相应部分是否为模型生成的。

联合字段 data。包含的数据。data 只能是下列其中一项:
text

string

内嵌文本。

inlineData

object (Blob)

内嵌二进制数据。

file

object (File)

一个文件,例如音频摘要。

executableCode

object (ExecutableCode)

由模型生成且旨在执行的代码。

codeExecutionResult

object (CodeExecutionResult)

执行 ExecutableCode 的结果。

Blob

内嵌 blob。

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

string

必需。生成的数据的媒体类型(MIME 类型)。

data

string (bytes format)

必需。原始字节。

使用 base64 编码的字符串。

文件

一个文件,例如音频摘要。

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

string

必需。文件的媒体类型(MIME 类型)。

fileId

string

必需。文件 ID。

ExecutableCode

由模型生成且旨在由模型执行的代码。

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

string

必需。代码内容。目前仅支持 Python。

CodeExecutionResult

执行 ExecutableCode 的结果。

JSON 表示法
{
  "outcome": enum (Outcome),
  "output": string
}
字段
outcome

enum (Outcome)

必需。代码执行结果。

output

string

可选。如果代码执行成功,则包含 stdout;否则包含 stderr 或其他说明。

结果

代码执行的可能结果的枚举。

枚举
OUTCOME_UNSPECIFIED 未指定状态。不应使用此值。
OUTCOME_OK 代码执行已成功完成。
OUTCOME_FAILED 代码执行已完成,但失败了。stderr 应包含原因。
OUTCOME_DEADLINE_EXCEEDED 代码执行时间过长,已被取消。可能存在部分输出,也可能不存在。

CitationMetadata

一段内容的一组来源归因。

JSON 表示法
{
  "citations": [
    {
      object (Citation)
    }
  ]
}
字段
citations[]

object (Citation)

仅限输出。引用列表。

引用

内容来源归因。

JSON 表示法
{
  "startIndex": integer,
  "endIndex": integer,
  "uri": string,
  "title": string,
  "license": string,
  "publicationDate": {
    object (Date)
  }
}
字段
startIndex

integer

仅限输出。内容中的起始索引。

endIndex

integer

仅限输出。内容中的结束索引。

uri

string

仅限输出。归因的网址引用。

title

string

仅限输出。归因标题。

license

string

仅限输出。归因许可。

publicationDate

object (Date)

仅限输出。归因的发布日期。

ContentMetadata

内容的元数据。

JSON 表示法
{
  "contentKind": enum (ContentKind),
  "contentId": string
}
字段
contentKind

enum (ContentKind)

内容的类型。显示相应内容属于研究助理回答的哪个部分。

contentId

string

内容的 ID。用于将研究问题与答案相关联。例如,研究问题的答案的各个部分与问题具有相同的 contentId

ContentKind

可能的内容种类。目前仅用于区分研究助理完整回答中的各个部分。

枚举
CONTENT_KIND_UNSPECIFIED 未知。
RESEARCH_PLAN 研究计划。
RESEARCH_QUESTION 研究问题。
RESEARCH_ANSWER 研究回答。
RESEARCH_REPORT 研究报告。
RESEARCH_AUDIO_SUMMARY 研究音频摘要。

AssistSkippedReason

未接听辅助通话的可能原因。

枚举
ASSIST_SKIPPED_REASON_UNSPECIFIED 默认值。未指定跳过原因。
NON_ASSIST_SEEKING_QUERY_IGNORED 助理忽略了查询,因为该查询似乎不是在寻求答案。
CUSTOMER_POLICY_VIOLATION 由于违反了客户政策(例如,查询或回答中包含禁用短语),助理忽略了查询或拒绝回答。

RequiredAuthorization

表示代理正常运行所需的授权。

JSON 表示法
{
  "authorization": string,
  "displayName": string,
  "authorizationUri": string,
  "authConfig": {
    object (AuthConfig)
  }
}
字段
authorization

string

仅限输出。Authorization 的名称。

displayName

string

仅限输出。授权的显示名称。

authorizationUri

string

仅限输出。用户应打开的授权 URI。

authConfig

object (AuthConfig)

仅限输出。第三方 (ADK) 代理所需的授权的配置。当授权源自 ADK 代理时,系统会填充此字段;在这种情况下,通常不会设置上述第一方 authorization 资源名称。

AuthConfig

第三方授权的配置。

JSON 表示法
{

  // Union field credential can be only one of the following:
  "oauth2": {
    object (OAuth2Credential)
  }
  // End of list of possible types for union field credential.
}
字段
联合字段 credential。凭据的配置。credential 只能是下列其中一项:
oauth2

object (OAuth2Credential)

OAuth2 凭据配置。

OAuth2Credential

OAuth2 授权的配置。

JSON 表示法
{
  "clientId": string,
  "clientSecret": string,
  "nonce": string,
  "state": string,
  "redirectUri": string,
  "authResponseUri": string,
  "authCode": string,
  "accessToken": string,
  "refreshToken": string,
  "idToken": string,
  "expireTime": string,
  "expireDuration": string,
  "audience": string,
  "codeVerifier": string,
  "codeChallengeMethod": string,
  "tokenEndpointAuthMethod": string
}
字段
clientId

string

仅限输出。客户端 ID。

clientSecret

string

仅限输出。客户端密钥。

nonce

string

仅限输出。nonce 值。

state

string

仅限输出。状态值。

redirectUri

string

仅限输出。重定向 URI。

authResponseUri

string

仅限输出。授权响应 URI。

authCode

string

仅限输出。授权代码。

accessToken

string

仅限输出。访问令牌。

refreshToken

string

仅限输出。刷新令牌。

idToken

string

仅限输出。ID 令牌。

expireTime

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"

expireDuration

string (Duration format)

仅限输出。到期时长。

该时长以秒为单位,最多包含九个小数位,以“s”结尾。示例:"3.5s"

audience

string

仅限输出。观众。

codeVerifier

string

仅限输出。代码验证器。

codeChallengeMethod

string

仅限输出。代码质询方法。

tokenEndpointAuthMethod

string

仅限输出。令牌端点授权方法。

CustomerPolicyEnforcementResult

客户政策执行结果。包含各种政策检查的结果,例如禁用短语或 Model Armor 检查。

JSON 表示法
{
  "verdict": enum (Verdict),
  "policyResults": [
    {
      object (PolicyEnforcementResult)
    }
  ]
}
字段
verdict

enum (Verdict)

客户政策执行的最终判定。如果只有一项政策阻止了处理,则判定为 BLOCK。

policyResults[]

object (PolicyEnforcementResult)

客户政策执行结果。仅当因违反政策而跳过辅助通话时填充。它包含阻止查询处理的过滤条件的结果。

判定

客户政策执行的判定。

枚举
UNSPECIFIED 未知的值。
ALLOW 没有违反政策。
BLOCK 处理因客户政策而被阻止。

PolicyEnforcementResult

单个政策类型的客户政策执行结果。

JSON 表示法
{

  // Union field enforcement_result can be only one of the following:
  "bannedPhraseEnforcementResult": {
    object (BannedPhraseEnforcementResult)
  },
  "modelArmorEnforcementResult": {
    object (ModelArmorEnforcementResult)
  }
  // End of list of possible types for union field enforcement_result.
}
字段
联合字段 enforcement_result。特定于政策类型的结果。可能是错误,也可能是有关政策执行结果的详细信息。enforcement_result 只能是下列其中一项:
bannedPhraseEnforcementResult

object (BannedPhraseEnforcementResult)

禁用短语政策的政策执行结果。

modelArmorEnforcementResult

object (ModelArmorEnforcementResult)

Model Armor 政策的政策执行结果。

BannedPhraseEnforcementResult

针对禁用短语政策的客户政策执行结果。

JSON 表示法
{
  "bannedPhrases": [
    string
  ]
}
字段
bannedPhrases[]

string

在查询或回答中发现的禁用短语。

ModelArmorEnforcementResult

Model Armor 政策的客户政策执行结果。

JSON 表示法
{

  // Union field result can be only one of the following:
  "modelArmorViolation": string,
  "error": {
    object (Status)
  }
  // End of list of possible types for union field result.
}
字段
联合字段 result。Model Armor 政策结果。result 只能是下列其中一项:
modelArmorViolation

string

发现的 Model Armor 违规行为。

error

object (Status)

因某种原因导致政策执行失败时由 Model Armor 返回的错误。

方法

get

获取 AssistAnswer