1<html><body> 2<style> 3 4body, h1, h2, h3, div, span, p, pre, a { 5 margin: 0; 6 padding: 0; 7 border: 0; 8 font-weight: inherit; 9 font-style: inherit; 10 font-size: 100%; 11 font-family: inherit; 12 vertical-align: baseline; 13} 14 15body { 16 font-size: 13px; 17 padding: 1em; 18} 19 20h1 { 21 font-size: 26px; 22 margin-bottom: 1em; 23} 24 25h2 { 26 font-size: 24px; 27 margin-bottom: 1em; 28} 29 30h3 { 31 font-size: 20px; 32 margin-bottom: 1em; 33 margin-top: 1em; 34} 35 36pre, code { 37 line-height: 1.5; 38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; 39} 40 41pre { 42 margin-top: 0.5em; 43} 44 45h1, h2, h3, p { 46 font-family: Arial, sans serif; 47} 48 49h1, h2, h3 { 50 border-bottom: solid #CCC 1px; 51} 52 53.toc_element { 54 margin-top: 0.5em; 55} 56 57.firstline { 58 margin-left: 2 em; 59} 60 61.method { 62 margin-top: 1em; 63 border: solid 1px #CCC; 64 padding: 1em; 65 background: #EEE; 66} 67 68.details { 69 font-weight: bold; 70 font-size: 14px; 71} 72 73</style> 74 75<h1><a href="dialogflow_v2beta1.html">Dialogflow API</a> . <a href="dialogflow_v2beta1.projects.html">projects</a> . <a href="dialogflow_v2beta1.projects.locations.html">locations</a> . <a href="dialogflow_v2beta1.projects.locations.answerRecords.html">answerRecords</a></h1> 76<h2>Instance Methods</h2> 77<p class="toc_element"> 78 <code><a href="#close">close()</a></code></p> 79<p class="firstline">Close httplib2 connections.</p> 80<p class="toc_element"> 81 <code><a href="#get">get(name, x__xgafv=None)</a></code></p> 82<p class="firstline">Deprecated. Retrieves a specific answer record.</p> 83<p class="toc_element"> 84 <code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p> 85<p class="firstline">Returns the list of all answer records in the specified project in reverse chronological order.</p> 86<p class="toc_element"> 87 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> 88<p class="firstline">Retrieves the next page of results.</p> 89<p class="toc_element"> 90 <code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p> 91<p class="firstline">Updates the specified answer record.</p> 92<h3>Method Details</h3> 93<div class="method"> 94 <code class="details" id="close">close()</code> 95 <pre>Close httplib2 connections.</pre> 96</div> 97 98<div class="method"> 99 <code class="details" id="get">get(name, x__xgafv=None)</code> 100 <pre>Deprecated. Retrieves a specific answer record. 101 102Args: 103 name: string, Required. The name of the answer record to retrieve. Format: `projects//locations//answerRecords/`. (required) 104 x__xgafv: string, V1 error format. 105 Allowed values 106 1 - v1 error format 107 2 - v2 error format 108 109Returns: 110 An object of the form: 111 112 { # Answer records are records to manage answer history and feedbacks for Dialogflow. Currently, answer record includes: - human agent assistant article suggestion - human agent assistant faq article It doesn't include: - `DetectIntent` intent matching - `DetectIntent` knowledge Answer records are not related to the conversation history in the Dialogflow Console. A Record is generated even when the end-user disables conversation history in the console. Records are created when there's a human agent assistant suggestion generated. A typical workflow for customers provide feedback to an answer is: 1. For human agent assistant, customers get suggestion via ListSuggestions API. Together with the answers, AnswerRecord.name are returned to the customers. 2. The customer uses the AnswerRecord.name to call the UpdateAnswerRecord method to send feedback about a specific answer that they believe is wrong. 113 "agentAssistantRecord": { # Represents a record of a human agent assistant answer. # Output only. The record for human agent assistant. 114 "articleSuggestionAnswer": { # Represents article answer. # Output only. The article suggestion answer. 115 "answerRecord": "A String", # The name of answer record, in the format of "projects//locations//answerRecords/" 116 "metadata": { # A map that contains metadata about the answer and the document from which it originates. 117 "a_key": "A String", 118 }, 119 "snippets": [ # Output only. Article snippets. 120 "A String", 121 ], 122 "title": "A String", # The article title. 123 "uri": "A String", # The article URI. 124 }, 125 "faqAnswer": { # Represents answer from "frequently asked questions". # Output only. The FAQ answer. 126 "answer": "A String", # The piece of text from the `source` knowledge base document. 127 "answerRecord": "A String", # The name of answer record, in the format of "projects//locations//answerRecords/" 128 "confidence": 3.14, # The system's confidence score that this Knowledge answer is a good match for this conversational query, range from 0.0 (completely uncertain) to 1.0 (completely certain). 129 "metadata": { # A map that contains metadata about the answer and the document from which it originates. 130 "a_key": "A String", 131 }, 132 "question": "A String", # The corresponding FAQ question. 133 "source": "A String", # Indicates which Knowledge Document this answer was extracted from. Format: `projects//locations//agent/knowledgeBases//documents/`. 134 }, 135 }, 136 "answerFeedback": { # Represents feedback the customer has about the quality & correctness of a certain answer in a conversation. # Optional. The AnswerFeedback for this record. You can set this with AnswerRecords.UpdateAnswerRecord in order to give us feedback about this answer. 137 "agentAssistantDetailFeedback": { # Detail feedback of Agent Assistant result. # Optional. Detail feedback of agent assistant suggestions. 138 "answerRelevance": "A String", # Optional. Whether or not the suggested answer is relevant. For example: * Query: "Can I change my mailing address?" * Suggested document says: "Items must be returned/exchanged within 60 days of the purchase date." * answer_relevance: AnswerRelevance.IRRELEVANT 139 "documentCorrectness": "A String", # Optional. Whether or not the information in the document is correct. For example: * Query: "Can I return the package in 2 days once received?" * Suggested document says: "Items must be returned/exchanged within 60 days of the purchase date." * Ground truth: "No return or exchange is allowed." * [document_correctness]: INCORRECT 140 "documentEfficiency": "A String", # Optional. Whether or not the suggested document is efficient. For example, if the document is poorly written, hard to understand, hard to use or too long to find useful information, document_efficiency is DocumentEfficiency.INEFFICIENT. 141 "summarizationFeedback": { # Feedback for conversation summarization. # Feedback for conversation summarization. 142 "startTimestamp": "A String", # Timestamp when composing of the summary starts. 143 "submitTimestamp": "A String", # Timestamp when the summary was submitted. 144 "summaryText": "A String", # Text of actual submitted summary. 145 }, 146 }, 147 "clickTime": "A String", # Time when the answer/item was clicked. 148 "clicked": True or False, # Indicates whether the answer/item was clicked by the human agent or not. Default to false. 149 "correctnessLevel": "A String", # The correctness level of the specific answer. 150 "displayTime": "A String", # Time when the answer/item was displayed. 151 "displayed": True or False, # Indicates whether the answer/item was displayed to the human agent in the agent desktop UI. Default to false. 152 }, 153 "name": "A String", # The unique identifier of this answer record. Required for AnswerRecords.UpdateAnswerRecord method. Format: `projects//locations//answerRecords/`. 154}</pre> 155</div> 156 157<div class="method"> 158 <code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code> 159 <pre>Returns the list of all answer records in the specified project in reverse chronological order. 160 161Args: 162 parent: string, Required. The project to list all answer records for in reverse chronological order. Format: `projects//locations/`. (required) 163 pageSize: integer, Optional. The maximum number of records to return in a single page. The server may return fewer records than this. If unspecified, we use 10. The maximum is 100. 164 pageToken: string, Optional. The ListAnswerRecordsResponse.next_page_token value returned from a previous list request used to continue listing on the next page. 165 x__xgafv: string, V1 error format. 166 Allowed values 167 1 - v1 error format 168 2 - v2 error format 169 170Returns: 171 An object of the form: 172 173 { # Response message for AnswerRecords.ListAnswerRecords. 174 "answerRecords": [ # The list of answer records. 175 { # Answer records are records to manage answer history and feedbacks for Dialogflow. Currently, answer record includes: - human agent assistant article suggestion - human agent assistant faq article It doesn't include: - `DetectIntent` intent matching - `DetectIntent` knowledge Answer records are not related to the conversation history in the Dialogflow Console. A Record is generated even when the end-user disables conversation history in the console. Records are created when there's a human agent assistant suggestion generated. A typical workflow for customers provide feedback to an answer is: 1. For human agent assistant, customers get suggestion via ListSuggestions API. Together with the answers, AnswerRecord.name are returned to the customers. 2. The customer uses the AnswerRecord.name to call the UpdateAnswerRecord method to send feedback about a specific answer that they believe is wrong. 176 "agentAssistantRecord": { # Represents a record of a human agent assistant answer. # Output only. The record for human agent assistant. 177 "articleSuggestionAnswer": { # Represents article answer. # Output only. The article suggestion answer. 178 "answerRecord": "A String", # The name of answer record, in the format of "projects//locations//answerRecords/" 179 "metadata": { # A map that contains metadata about the answer and the document from which it originates. 180 "a_key": "A String", 181 }, 182 "snippets": [ # Output only. Article snippets. 183 "A String", 184 ], 185 "title": "A String", # The article title. 186 "uri": "A String", # The article URI. 187 }, 188 "faqAnswer": { # Represents answer from "frequently asked questions". # Output only. The FAQ answer. 189 "answer": "A String", # The piece of text from the `source` knowledge base document. 190 "answerRecord": "A String", # The name of answer record, in the format of "projects//locations//answerRecords/" 191 "confidence": 3.14, # The system's confidence score that this Knowledge answer is a good match for this conversational query, range from 0.0 (completely uncertain) to 1.0 (completely certain). 192 "metadata": { # A map that contains metadata about the answer and the document from which it originates. 193 "a_key": "A String", 194 }, 195 "question": "A String", # The corresponding FAQ question. 196 "source": "A String", # Indicates which Knowledge Document this answer was extracted from. Format: `projects//locations//agent/knowledgeBases//documents/`. 197 }, 198 }, 199 "answerFeedback": { # Represents feedback the customer has about the quality & correctness of a certain answer in a conversation. # Optional. The AnswerFeedback for this record. You can set this with AnswerRecords.UpdateAnswerRecord in order to give us feedback about this answer. 200 "agentAssistantDetailFeedback": { # Detail feedback of Agent Assistant result. # Optional. Detail feedback of agent assistant suggestions. 201 "answerRelevance": "A String", # Optional. Whether or not the suggested answer is relevant. For example: * Query: "Can I change my mailing address?" * Suggested document says: "Items must be returned/exchanged within 60 days of the purchase date." * answer_relevance: AnswerRelevance.IRRELEVANT 202 "documentCorrectness": "A String", # Optional. Whether or not the information in the document is correct. For example: * Query: "Can I return the package in 2 days once received?" * Suggested document says: "Items must be returned/exchanged within 60 days of the purchase date." * Ground truth: "No return or exchange is allowed." * [document_correctness]: INCORRECT 203 "documentEfficiency": "A String", # Optional. Whether or not the suggested document is efficient. For example, if the document is poorly written, hard to understand, hard to use or too long to find useful information, document_efficiency is DocumentEfficiency.INEFFICIENT. 204 "summarizationFeedback": { # Feedback for conversation summarization. # Feedback for conversation summarization. 205 "startTimestamp": "A String", # Timestamp when composing of the summary starts. 206 "submitTimestamp": "A String", # Timestamp when the summary was submitted. 207 "summaryText": "A String", # Text of actual submitted summary. 208 }, 209 }, 210 "clickTime": "A String", # Time when the answer/item was clicked. 211 "clicked": True or False, # Indicates whether the answer/item was clicked by the human agent or not. Default to false. 212 "correctnessLevel": "A String", # The correctness level of the specific answer. 213 "displayTime": "A String", # Time when the answer/item was displayed. 214 "displayed": True or False, # Indicates whether the answer/item was displayed to the human agent in the agent desktop UI. Default to false. 215 }, 216 "name": "A String", # The unique identifier of this answer record. Required for AnswerRecords.UpdateAnswerRecord method. Format: `projects//locations//answerRecords/`. 217 }, 218 ], 219 "nextPageToken": "A String", # A token to retrieve next page of results. Or empty if there are no more results. Pass this value in the ListAnswerRecordsRequest.page_token field in the subsequent call to `ListAnswerRecords` method to retrieve the next page of results. 220}</pre> 221</div> 222 223<div class="method"> 224 <code class="details" id="list_next">list_next(previous_request, previous_response)</code> 225 <pre>Retrieves the next page of results. 226 227Args: 228 previous_request: The request for the previous page. (required) 229 previous_response: The response from the request for the previous page. (required) 230 231Returns: 232 A request object that you can call 'execute()' on to request the next 233 page. Returns None if there are no more items in the collection. 234 </pre> 235</div> 236 237<div class="method"> 238 <code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code> 239 <pre>Updates the specified answer record. 240 241Args: 242 name: string, The unique identifier of this answer record. Required for AnswerRecords.UpdateAnswerRecord method. Format: `projects//locations//answerRecords/`. (required) 243 body: object, The request body. 244 The object takes the form of: 245 246{ # Answer records are records to manage answer history and feedbacks for Dialogflow. Currently, answer record includes: - human agent assistant article suggestion - human agent assistant faq article It doesn't include: - `DetectIntent` intent matching - `DetectIntent` knowledge Answer records are not related to the conversation history in the Dialogflow Console. A Record is generated even when the end-user disables conversation history in the console. Records are created when there's a human agent assistant suggestion generated. A typical workflow for customers provide feedback to an answer is: 1. For human agent assistant, customers get suggestion via ListSuggestions API. Together with the answers, AnswerRecord.name are returned to the customers. 2. The customer uses the AnswerRecord.name to call the UpdateAnswerRecord method to send feedback about a specific answer that they believe is wrong. 247 "agentAssistantRecord": { # Represents a record of a human agent assistant answer. # Output only. The record for human agent assistant. 248 "articleSuggestionAnswer": { # Represents article answer. # Output only. The article suggestion answer. 249 "answerRecord": "A String", # The name of answer record, in the format of "projects//locations//answerRecords/" 250 "metadata": { # A map that contains metadata about the answer and the document from which it originates. 251 "a_key": "A String", 252 }, 253 "snippets": [ # Output only. Article snippets. 254 "A String", 255 ], 256 "title": "A String", # The article title. 257 "uri": "A String", # The article URI. 258 }, 259 "faqAnswer": { # Represents answer from "frequently asked questions". # Output only. The FAQ answer. 260 "answer": "A String", # The piece of text from the `source` knowledge base document. 261 "answerRecord": "A String", # The name of answer record, in the format of "projects//locations//answerRecords/" 262 "confidence": 3.14, # The system's confidence score that this Knowledge answer is a good match for this conversational query, range from 0.0 (completely uncertain) to 1.0 (completely certain). 263 "metadata": { # A map that contains metadata about the answer and the document from which it originates. 264 "a_key": "A String", 265 }, 266 "question": "A String", # The corresponding FAQ question. 267 "source": "A String", # Indicates which Knowledge Document this answer was extracted from. Format: `projects//locations//agent/knowledgeBases//documents/`. 268 }, 269 }, 270 "answerFeedback": { # Represents feedback the customer has about the quality & correctness of a certain answer in a conversation. # Optional. The AnswerFeedback for this record. You can set this with AnswerRecords.UpdateAnswerRecord in order to give us feedback about this answer. 271 "agentAssistantDetailFeedback": { # Detail feedback of Agent Assistant result. # Optional. Detail feedback of agent assistant suggestions. 272 "answerRelevance": "A String", # Optional. Whether or not the suggested answer is relevant. For example: * Query: "Can I change my mailing address?" * Suggested document says: "Items must be returned/exchanged within 60 days of the purchase date." * answer_relevance: AnswerRelevance.IRRELEVANT 273 "documentCorrectness": "A String", # Optional. Whether or not the information in the document is correct. For example: * Query: "Can I return the package in 2 days once received?" * Suggested document says: "Items must be returned/exchanged within 60 days of the purchase date." * Ground truth: "No return or exchange is allowed." * [document_correctness]: INCORRECT 274 "documentEfficiency": "A String", # Optional. Whether or not the suggested document is efficient. For example, if the document is poorly written, hard to understand, hard to use or too long to find useful information, document_efficiency is DocumentEfficiency.INEFFICIENT. 275 "summarizationFeedback": { # Feedback for conversation summarization. # Feedback for conversation summarization. 276 "startTimestamp": "A String", # Timestamp when composing of the summary starts. 277 "submitTimestamp": "A String", # Timestamp when the summary was submitted. 278 "summaryText": "A String", # Text of actual submitted summary. 279 }, 280 }, 281 "clickTime": "A String", # Time when the answer/item was clicked. 282 "clicked": True or False, # Indicates whether the answer/item was clicked by the human agent or not. Default to false. 283 "correctnessLevel": "A String", # The correctness level of the specific answer. 284 "displayTime": "A String", # Time when the answer/item was displayed. 285 "displayed": True or False, # Indicates whether the answer/item was displayed to the human agent in the agent desktop UI. Default to false. 286 }, 287 "name": "A String", # The unique identifier of this answer record. Required for AnswerRecords.UpdateAnswerRecord method. Format: `projects//locations//answerRecords/`. 288} 289 290 updateMask: string, Required. The mask to control which fields get updated. 291 x__xgafv: string, V1 error format. 292 Allowed values 293 1 - v1 error format 294 2 - v2 error format 295 296Returns: 297 An object of the form: 298 299 { # Answer records are records to manage answer history and feedbacks for Dialogflow. Currently, answer record includes: - human agent assistant article suggestion - human agent assistant faq article It doesn't include: - `DetectIntent` intent matching - `DetectIntent` knowledge Answer records are not related to the conversation history in the Dialogflow Console. A Record is generated even when the end-user disables conversation history in the console. Records are created when there's a human agent assistant suggestion generated. A typical workflow for customers provide feedback to an answer is: 1. For human agent assistant, customers get suggestion via ListSuggestions API. Together with the answers, AnswerRecord.name are returned to the customers. 2. The customer uses the AnswerRecord.name to call the UpdateAnswerRecord method to send feedback about a specific answer that they believe is wrong. 300 "agentAssistantRecord": { # Represents a record of a human agent assistant answer. # Output only. The record for human agent assistant. 301 "articleSuggestionAnswer": { # Represents article answer. # Output only. The article suggestion answer. 302 "answerRecord": "A String", # The name of answer record, in the format of "projects//locations//answerRecords/" 303 "metadata": { # A map that contains metadata about the answer and the document from which it originates. 304 "a_key": "A String", 305 }, 306 "snippets": [ # Output only. Article snippets. 307 "A String", 308 ], 309 "title": "A String", # The article title. 310 "uri": "A String", # The article URI. 311 }, 312 "faqAnswer": { # Represents answer from "frequently asked questions". # Output only. The FAQ answer. 313 "answer": "A String", # The piece of text from the `source` knowledge base document. 314 "answerRecord": "A String", # The name of answer record, in the format of "projects//locations//answerRecords/" 315 "confidence": 3.14, # The system's confidence score that this Knowledge answer is a good match for this conversational query, range from 0.0 (completely uncertain) to 1.0 (completely certain). 316 "metadata": { # A map that contains metadata about the answer and the document from which it originates. 317 "a_key": "A String", 318 }, 319 "question": "A String", # The corresponding FAQ question. 320 "source": "A String", # Indicates which Knowledge Document this answer was extracted from. Format: `projects//locations//agent/knowledgeBases//documents/`. 321 }, 322 }, 323 "answerFeedback": { # Represents feedback the customer has about the quality & correctness of a certain answer in a conversation. # Optional. The AnswerFeedback for this record. You can set this with AnswerRecords.UpdateAnswerRecord in order to give us feedback about this answer. 324 "agentAssistantDetailFeedback": { # Detail feedback of Agent Assistant result. # Optional. Detail feedback of agent assistant suggestions. 325 "answerRelevance": "A String", # Optional. Whether or not the suggested answer is relevant. For example: * Query: "Can I change my mailing address?" * Suggested document says: "Items must be returned/exchanged within 60 days of the purchase date." * answer_relevance: AnswerRelevance.IRRELEVANT 326 "documentCorrectness": "A String", # Optional. Whether or not the information in the document is correct. For example: * Query: "Can I return the package in 2 days once received?" * Suggested document says: "Items must be returned/exchanged within 60 days of the purchase date." * Ground truth: "No return or exchange is allowed." * [document_correctness]: INCORRECT 327 "documentEfficiency": "A String", # Optional. Whether or not the suggested document is efficient. For example, if the document is poorly written, hard to understand, hard to use or too long to find useful information, document_efficiency is DocumentEfficiency.INEFFICIENT. 328 "summarizationFeedback": { # Feedback for conversation summarization. # Feedback for conversation summarization. 329 "startTimestamp": "A String", # Timestamp when composing of the summary starts. 330 "submitTimestamp": "A String", # Timestamp when the summary was submitted. 331 "summaryText": "A String", # Text of actual submitted summary. 332 }, 333 }, 334 "clickTime": "A String", # Time when the answer/item was clicked. 335 "clicked": True or False, # Indicates whether the answer/item was clicked by the human agent or not. Default to false. 336 "correctnessLevel": "A String", # The correctness level of the specific answer. 337 "displayTime": "A String", # Time when the answer/item was displayed. 338 "displayed": True or False, # Indicates whether the answer/item was displayed to the human agent in the agent desktop UI. Default to false. 339 }, 340 "name": "A String", # The unique identifier of this answer record. Required for AnswerRecords.UpdateAnswerRecord method. Format: `projects//locations//answerRecords/`. 341}</pre> 342</div> 343 344</body></html>