1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
|
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="discoveryengine_v1beta.html">Discovery Engine API</a> . <a href="discoveryengine_v1beta.projects.html">projects</a> . <a href="discoveryengine_v1beta.projects.locations.html">locations</a> . <a href="discoveryengine_v1beta.projects.locations.collections.html">collections</a> . <a href="discoveryengine_v1beta.projects.locations.collections.engines.html">engines</a> . <a href="discoveryengine_v1beta.projects.locations.collections.engines.sessions.html">sessions</a> . <a href="discoveryengine_v1beta.projects.locations.collections.engines.sessions.answers.html">answers</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
<code><a href="#get">get(name, x__xgafv=None)</a></code></p>
<p class="firstline">Gets a Answer.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="close">close()</code>
<pre>Close httplib2 connections.</pre>
</div>
<div class="method">
<code class="details" id="get">get(name, x__xgafv=None)</code>
<pre>Gets a Answer.
Args:
name: string, Required. The resource name of the Answer to get. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine_id}/sessions/{session_id}/answers/{answer_id}` (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Defines an answer.
"answerSkippedReasons": [ # Additional answer-skipped reasons. This provides the reason for ignored cases. If nothing is skipped, this field is not set.
"A String",
],
"answerText": "A String", # The textual answer.
"blobAttachments": [ # List of blob attachments in the answer.
{ # Stores binarydata attached to text answer, e.g. image, video, audio, etc.
"attributionType": "A String", # Output only. The attribution type of the blob.
"data": { # The media type and data of the blob. # Output only. The mime type and data of the blob.
"data": "A String", # Output only. Raw bytes.
"mimeType": "A String", # Output only. The media type (MIME type) of the generated or retrieved data.
},
},
],
"citations": [ # Citations.
{ # Citation info for a segment.
"endIndex": "A String", # End of the attributed segment, exclusive. Measured in bytes (UTF-8 unicode). If there are multi-byte characters,such as non-ASCII characters, the index measurement is longer than the string length.
"sources": [ # Citation sources for the attributed segment.
{ # Citation source.
"referenceId": "A String", # ID of the citation source.
},
],
"startIndex": "A String", # Index indicates the start of the segment, measured in bytes (UTF-8 unicode). If there are multi-byte characters,such as non-ASCII characters, the index measurement is longer than the string length.
},
],
"completeTime": "A String", # Output only. Answer completed timestamp.
"createTime": "A String", # Output only. Answer creation timestamp.
"groundingScore": 3.14, # A score in the range of [0, 1] describing how grounded the answer is by the reference chunks.
"groundingSupports": [ # Optional. Grounding supports.
{ # Grounding support for a claim in `answer_text`.
"endIndex": "A String", # Required. End of the claim, exclusive.
"groundingCheckRequired": True or False, # Indicates that this claim required grounding check. When the system decided this claim didn't require attribution/grounding check, this field is set to false. In that case, no grounding check was done for the claim and therefore `grounding_score`, `sources` is not returned.
"groundingScore": 3.14, # A score in the range of [0, 1] describing how grounded is a specific claim by the references. Higher value means that the claim is better supported by the reference chunks.
"sources": [ # Optional. Citation sources for the claim.
{ # Citation source.
"referenceId": "A String", # ID of the citation source.
},
],
"startIndex": "A String", # Required. Index indicates the start of the claim, measured in bytes (UTF-8 unicode).
},
],
"name": "A String", # Immutable. Fully qualified name `projects/{project}/locations/global/collections/{collection}/engines/{engine}/sessions/*/answers/*`
"queryUnderstandingInfo": { # Query understanding information. # Query understanding information.
"queryClassificationInfo": [ # Query classification information.
{ # Query classification information.
"positive": True or False, # Classification output.
"type": "A String", # Query classification type.
},
],
},
"references": [ # References.
{ # Reference.
"chunkInfo": { # Chunk information. # Chunk information.
"blobAttachmentIndexes": [ # Output only. Stores indexes of blobattachments linked to this chunk.
"A String",
],
"chunk": "A String", # Chunk resource name.
"content": "A String", # Chunk textual content.
"documentMetadata": { # Document metadata. # Document metadata.
"document": "A String", # Document resource name.
"pageIdentifier": "A String", # Page identifier.
"structData": { # The structured JSON metadata for the document. It is populated from the struct data from the Chunk in search result.
"a_key": "", # Properties of the object.
},
"title": "A String", # Title.
"uri": "A String", # URI for the document.
},
"relevanceScore": 3.14, # The relevance of the chunk for a given query. Values range from 0.0 (completely irrelevant) to 1.0 (completely relevant). This value is for informational purpose only. It may change for the same query and chunk at any time due to a model retraining or change in implementation.
},
"structuredDocumentInfo": { # Structured search information. # Structured document information.
"document": "A String", # Document resource name.
"structData": { # Structured search data.
"a_key": "", # Properties of the object.
},
"title": "A String", # Output only. The title of the document.
"uri": "A String", # Output only. The URI of the document.
},
"unstructuredDocumentInfo": { # Unstructured document information. # Unstructured document information.
"chunkContents": [ # List of cited chunk contents derived from document content.
{ # Chunk content.
"blobAttachmentIndexes": [ # Output only. Stores indexes of blobattachments linked to this chunk.
"A String",
],
"content": "A String", # Chunk textual content.
"pageIdentifier": "A String", # Page identifier.
"relevanceScore": 3.14, # The relevance of the chunk for a given query. Values range from 0.0 (completely irrelevant) to 1.0 (completely relevant). This value is for informational purpose only. It may change for the same query and chunk at any time due to a model retraining or change in implementation.
},
],
"document": "A String", # Document resource name.
"structData": { # The structured JSON metadata for the document. It is populated from the struct data from the Chunk in search result.
"a_key": "", # Properties of the object.
},
"title": "A String", # Title.
"uri": "A String", # URI for the document.
},
},
],
"relatedQuestions": [ # Suggested related questions.
"A String",
],
"safetyRatings": [ # Optional. Safety ratings.
{ # Safety rating corresponding to the generated content.
"blocked": True or False, # Output only. Indicates whether the content was filtered out because of this rating.
"category": "A String", # Output only. Harm category.
"probability": "A String", # Output only. Harm probability levels in the content.
"probabilityScore": 3.14, # Output only. Harm probability score.
"severity": "A String", # Output only. Harm severity levels in the content.
"severityScore": 3.14, # Output only. Harm severity score.
},
],
"state": "A String", # The state of the answer generation.
"steps": [ # Answer generation steps.
{ # Step information.
"actions": [ # Actions.
{ # Action.
"observation": { # Observation. # Observation.
"searchResults": [ # Search results observed by the search action, it can be snippets info or chunk info, depending on the citation type set by the user.
{
"chunkInfo": [ # If citation_type is CHUNK_LEVEL_CITATION and chunk mode is on, populate chunk info.
{ # Chunk information.
"chunk": "A String", # Chunk resource name.
"content": "A String", # Chunk textual content.
"relevanceScore": 3.14, # The relevance of the chunk for a given query. Values range from 0.0 (completely irrelevant) to 1.0 (completely relevant). This value is for informational purpose only. It may change for the same query and chunk at any time due to a model retraining or change in implementation.
},
],
"document": "A String", # Document resource name.
"snippetInfo": [ # If citation_type is DOCUMENT_LEVEL_CITATION, populate document level snippets.
{ # Snippet information.
"snippet": "A String", # Snippet content.
"snippetStatus": "A String", # Status of the snippet defined by the search team.
},
],
"structData": { # Data representation. The structured JSON data for the document. It's populated from the struct data from the Document, or the Chunk in search result.
"a_key": "", # Properties of the object.
},
"title": "A String", # Title.
"uri": "A String", # URI for the document.
},
],
},
"searchAction": { # Search action. # Search action.
"query": "A String", # The query to search.
},
},
],
"description": "A String", # The description of the step.
"state": "A String", # The state of the step.
"thought": "A String", # The thought of the step.
},
],
}</pre>
</div>
</body></html>
|
