Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / 4ed7d3f9b61ac35e08a22b4995076a95451cf7c8 / . / docs / dyn / dialogflow_v2beta1.projects.agent.html
blob: dc04c32fabf8ff9fa2e089f99636d672ca7637db [file] [log] [blame]
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]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.agent.html">agent</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="dialogflow_v2beta1.projects.agent.entityTypes.html">entityTypes()</a></code>
79</p>
80<p class="firstline">Returns the entityTypes Resource.</p>
81
82<p class="toc_element">
83 <code><a href="dialogflow_v2beta1.projects.agent.environments.html">environments()</a></code>
84</p>
85<p class="firstline">Returns the environments Resource.</p>
86
87<p class="toc_element">
88 <code><a href="dialogflow_v2beta1.projects.agent.intents.html">intents()</a></code>
89</p>
90<p class="firstline">Returns the intents Resource.</p>
91
92<p class="toc_element">
93 <code><a href="dialogflow_v2beta1.projects.agent.knowledgeBases.html">knowledgeBases()</a></code>
94</p>
95<p class="firstline">Returns the knowledgeBases Resource.</p>
96
97<p class="toc_element">
98 <code><a href="dialogflow_v2beta1.projects.agent.sessions.html">sessions()</a></code>
99</p>
100<p class="firstline">Returns the sessions Resource.</p>
101
102<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]103 <code><a href="#export">export(parent, body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]104<p class="firstline">Exports the specified agent to a ZIP file.</p>
105<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]106 <code><a href="#getFulfillment">getFulfillment(name, x__xgafv=None)</a></code></p>
107<p class="firstline">Retrieves the fulfillment.</p>
108<p class="toc_element">
109 <code><a href="#getValidationResult">getValidationResult(parent, languageCode=None, x__xgafv=None)</a></code></p>
110<p class="firstline">Gets agent validation result. Agent validation is performed during</p>
111<p class="toc_element">
112 <code><a href="#import_">import_(parent, body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]113<p class="firstline">Imports the specified agent from a ZIP file.</p>
114<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]115 <code><a href="#restore">restore(parent, body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]116<p class="firstline">Restores the specified agent from a ZIP file.</p>
117<p class="toc_element">
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]118 <code><a href="#search">search(parent, pageToken=None, pageSize=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]119<p class="firstline">Returns the list of agents.</p>
120<p class="toc_element">
121 <code><a href="#search_next">search_next(previous_request, previous_response)</a></code></p>
122<p class="firstline">Retrieves the next page of results.</p>
123<p class="toc_element">
124 <code><a href="#train">train(parent, body=None, x__xgafv=None)</a></code></p>
125<p class="firstline">Trains the specified agent.</p>
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]126<p class="toc_element">
127 <code><a href="#updateFulfillment">updateFulfillment(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
128<p class="firstline">Updates the fulfillment.</p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]129<h3>Method Details</h3>
130<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]131 <code class="details" id="export">export(parent, body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]132 <pre>Exports the specified agent to a ZIP file.
133
134
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]135Operation &lt;response: ExportAgentResponse&gt;
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]136
137Args:
138 parent: string, Required. The project that the agent to export is associated with.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]139Format: `projects/&lt;Project ID&gt;`. (required)
140 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]141 The object takes the form of:
142
143{ # The request message for Agents.ExportAgent.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]144 &quot;agentUri&quot;: &quot;A String&quot;, # Optional. The
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]145 # [Google Cloud Storage](https://cloud.google.com/storage/docs/)
146 # URI to export the agent to.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]147 # The format of this URI must be `gs://&lt;bucket-name&gt;/&lt;object-name&gt;`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]148 # If left unspecified, the serialized agent is returned inline.
149 }
150
151 x__xgafv: string, V1 error format.
152 Allowed values
153 1 - v1 error format
154 2 - v2 error format
155
156Returns:
157 An object of the form:
158
159 { # This resource represents a long-running operation that is the result of a
160 # network API call.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame^]161 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
162 # originally returns it. If you use the default HTTP mapping, the
163 # `name` should be a resource name ending with `operations/{unique_id}`.
164 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
165 # different programming environments, including REST APIs and RPC APIs. It is
166 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
167 # three pieces of data: error code, error message, and error details.
168 #
169 # You can find out more about this error model and how to work with it in the
170 # [API Design Guide](https://cloud.google.com/apis/design/errors).
171 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
172 # user-facing error message should be localized and sent in the
173 # google.rpc.Status.details field, or localized by the client.
174 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
175 # message types for APIs to use.
176 {
177 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
178 },
179 ],
180 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
181 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]182 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically
183 # contains progress information and common metadata such as create time.
184 # Some services might not provide such metadata. Any method that returns a
185 # long-running operation should document the metadata type, if any.
186 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
187 },
188 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
189 # If `true`, the operation is completed, and either `error` or `response` is
190 # available.
191 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]192 # method returns no data on success, such as `Delete`, the response is
193 # `google.protobuf.Empty`. If the original method is standard
194 # `Get`/`Create`/`Update`, the response should be the resource. For other
195 # methods, the response should have the type `XxxResponse`, where `Xxx`
196 # is the original method name. For example, if the original method name
197 # is `TakeSnapshot()`, the inferred response type is
198 # `TakeSnapshotResponse`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]199 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]200 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]201 }</pre>
202</div>
203
204<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]205 <code class="details" id="getFulfillment">getFulfillment(name, x__xgafv=None)</code>
206 <pre>Retrieves the fulfillment.
207
208Args:
209 name: string, Required. The name of the fulfillment.
210Format: `projects/&lt;Project ID&gt;/agent/fulfillment`. (required)
211 x__xgafv: string, V1 error format.
212 Allowed values
213 1 - v1 error format
214 2 - v2 error format
215
216Returns:
217 An object of the form:
218
219 { # Represents a fulfillment.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame^]220 &quot;features&quot;: [ # Optional. The field defines whether the fulfillment is enabled for certain features.
221 { # Whether fulfillment is enabled for the specific feature.
222 &quot;type&quot;: &quot;A String&quot;, # The type of the feature that enabled for fulfillment.
223 },
224 ],
225 &quot;name&quot;: &quot;A String&quot;, # Required. The unique identifier of the fulfillment.
226 # Format: `projects/&lt;Project ID&gt;/agent/fulfillment`.
227 &quot;displayName&quot;: &quot;A String&quot;, # Optional. The human-readable name of the fulfillment, unique within the agent.
228 &quot;enabled&quot;: True or False, # Optional. Whether fulfillment is enabled.
229 &quot;genericWebService&quot;: { # Represents configuration for a generic web service. # Configuration for a generic web service.
230 # Dialogflow supports two mechanisms for authentications:
231 # - Basic authentication with username and password.
232 # - Authentication with additional authentication headers.
233 # More information could be found at:
234 # https://cloud.google.com/dialogflow/docs/fulfillment-configure.
235 &quot;uri&quot;: &quot;A String&quot;, # Required. The fulfillment URI for receiving POST requests.
236 # It must use https protocol.
237 &quot;password&quot;: &quot;A String&quot;, # Optional. The password for HTTP Basic authentication.
238 &quot;isCloudFunction&quot;: True or False, # Optional. Indicates if generic web service is created through Cloud Functions
239 # integration. Defaults to false.
240 &quot;username&quot;: &quot;A String&quot;, # Optional. The user name for HTTP Basic authentication.
241 &quot;requestHeaders&quot;: { # Optional. The HTTP request headers to send together with fulfillment requests.
242 &quot;a_key&quot;: &quot;A String&quot;,
243 },
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]244 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame^]245 }</pre>
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]246</div>
247
248<div class="method">
249 <code class="details" id="getValidationResult">getValidationResult(parent, languageCode=None, x__xgafv=None)</code>
250 <pre>Gets agent validation result. Agent validation is performed during
251training time and is updated automatically when training is completed.
252
253Args:
254 parent: string, Required. The project that the agent is associated with.
255Format: `projects/&lt;Project ID&gt;`. (required)
256 languageCode: string, Optional. The language for which you want a validation result. If not
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]257specified, the agent&#x27;s default language is used. [Many
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]258languages](https://cloud.google.com/dialogflow/docs/reference/language)
259are supported. Note: languages must be enabled in the agent before they can
260be used.
261 x__xgafv: string, V1 error format.
262 Allowed values
263 1 - v1 error format
264 2 - v2 error format
265
266Returns:
267 An object of the form:
268
269 { # Represents the output of agent validation.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]270 &quot;validationErrors&quot;: [ # Contains all validation errors.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]271 { # Represents a single validation error.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]272 &quot;entries&quot;: [ # The names of the entries that the error is associated with.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]273 # Format:
274 #
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]275 # - &quot;projects/&lt;Project ID&gt;/agent&quot;, if the error is associated with the entire
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]276 # agent.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]277 # - &quot;projects/&lt;Project ID&gt;/agent/intents/&lt;Intent ID&gt;&quot;, if the error is
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]278 # associated with certain intents.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]279 # - &quot;projects/&lt;Project
280 # ID&gt;/agent/intents/&lt;Intent Id&gt;/trainingPhrases/&lt;Training Phrase ID&gt;&quot;, if the
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]281 # error is associated with certain intent training phrases.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]282 # - &quot;projects/&lt;Project ID&gt;/agent/intents/&lt;Intent Id&gt;/parameters/&lt;Parameter
283 # ID&gt;&quot;, if the error is associated with certain intent parameters.
284 # - &quot;projects/&lt;Project ID&gt;/agent/entities/&lt;Entity ID&gt;&quot;, if the error is
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]285 # associated with certain entities.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]286 &quot;A String&quot;,
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]287 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]288 &quot;errorMessage&quot;: &quot;A String&quot;, # The detailed error messsage.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame^]289 &quot;severity&quot;: &quot;A String&quot;, # The severity of the error.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]290 },
291 ],
292 }</pre>
293</div>
294
295<div class="method">
296 <code class="details" id="import_">import_(parent, body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]297 <pre>Imports the specified agent from a ZIP file.
298
299Uploads new intents and entity types without deleting the existing ones.
300Intents and entity types with the same name are replaced with the new
301versions from ImportAgentRequest.
302
303
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]304Operation &lt;response: google.protobuf.Empty&gt;
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]305
306Args:
307 parent: string, Required. The project that the agent to import is associated with.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]308Format: `projects/&lt;Project ID&gt;`. (required)
309 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]310 The object takes the form of:
311
312{ # The request message for Agents.ImportAgent.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]313 &quot;agentContent&quot;: &quot;A String&quot;, # Zip compressed raw byte content for agent.
314 &quot;agentUri&quot;: &quot;A String&quot;, # The URI to a Google Cloud Storage file containing the agent to import.
315 # Note: The URI must start with &quot;gs://&quot;.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]316 }
317
318 x__xgafv: string, V1 error format.
319 Allowed values
320 1 - v1 error format
321 2 - v2 error format
322
323Returns:
324 An object of the form:
325
326 { # This resource represents a long-running operation that is the result of a
327 # network API call.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame^]328 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
329 # originally returns it. If you use the default HTTP mapping, the
330 # `name` should be a resource name ending with `operations/{unique_id}`.
331 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
332 # different programming environments, including REST APIs and RPC APIs. It is
333 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
334 # three pieces of data: error code, error message, and error details.
335 #
336 # You can find out more about this error model and how to work with it in the
337 # [API Design Guide](https://cloud.google.com/apis/design/errors).
338 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
339 # user-facing error message should be localized and sent in the
340 # google.rpc.Status.details field, or localized by the client.
341 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
342 # message types for APIs to use.
343 {
344 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
345 },
346 ],
347 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
348 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]349 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically
350 # contains progress information and common metadata such as create time.
351 # Some services might not provide such metadata. Any method that returns a
352 # long-running operation should document the metadata type, if any.
353 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
354 },
355 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
356 # If `true`, the operation is completed, and either `error` or `response` is
357 # available.
358 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]359 # method returns no data on success, such as `Delete`, the response is
360 # `google.protobuf.Empty`. If the original method is standard
361 # `Get`/`Create`/`Update`, the response should be the resource. For other
362 # methods, the response should have the type `XxxResponse`, where `Xxx`
363 # is the original method name. For example, if the original method name
364 # is `TakeSnapshot()`, the inferred response type is
365 # `TakeSnapshotResponse`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]366 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]367 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]368 }</pre>
369</div>
370
371<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]372 <code class="details" id="restore">restore(parent, body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]373 <pre>Restores the specified agent from a ZIP file.
374
375Replaces the current agent version with a new one. All the intents and
376entity types in the older version are deleted.
377
378
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]379Operation &lt;response: google.protobuf.Empty&gt;
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]380
381Args:
382 parent: string, Required. The project that the agent to restore is associated with.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]383Format: `projects/&lt;Project ID&gt;`. (required)
384 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]385 The object takes the form of:
386
387{ # The request message for Agents.RestoreAgent.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame^]388 &quot;agentContent&quot;: &quot;A String&quot;, # Zip compressed raw byte content for agent.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]389 &quot;agentUri&quot;: &quot;A String&quot;, # The URI to a Google Cloud Storage file containing the agent to restore.
390 # Note: The URI must start with &quot;gs://&quot;.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]391 }
392
393 x__xgafv: string, V1 error format.
394 Allowed values
395 1 - v1 error format
396 2 - v2 error format
397
398Returns:
399 An object of the form:
400
401 { # This resource represents a long-running operation that is the result of a
402 # network API call.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame^]403 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
404 # originally returns it. If you use the default HTTP mapping, the
405 # `name` should be a resource name ending with `operations/{unique_id}`.
406 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
407 # different programming environments, including REST APIs and RPC APIs. It is
408 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
409 # three pieces of data: error code, error message, and error details.
410 #
411 # You can find out more about this error model and how to work with it in the
412 # [API Design Guide](https://cloud.google.com/apis/design/errors).
413 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
414 # user-facing error message should be localized and sent in the
415 # google.rpc.Status.details field, or localized by the client.
416 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
417 # message types for APIs to use.
418 {
419 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
420 },
421 ],
422 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
423 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]424 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically
425 # contains progress information and common metadata such as create time.
426 # Some services might not provide such metadata. Any method that returns a
427 # long-running operation should document the metadata type, if any.
428 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
429 },
430 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
431 # If `true`, the operation is completed, and either `error` or `response` is
432 # available.
433 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]434 # method returns no data on success, such as `Delete`, the response is
435 # `google.protobuf.Empty`. If the original method is standard
436 # `Get`/`Create`/`Update`, the response should be the resource. For other
437 # methods, the response should have the type `XxxResponse`, where `Xxx`
438 # is the original method name. For example, if the original method name
439 # is `TakeSnapshot()`, the inferred response type is
440 # `TakeSnapshotResponse`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]441 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]442 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]443 }</pre>
444</div>
445
446<div class="method">
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]447 <code class="details" id="search">search(parent, pageToken=None, pageSize=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]448 <pre>Returns the list of agents.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]449Since there is at most one conversational agent per project, this method is
450useful primarily for listing all agents across projects the caller has
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]451access to. One can achieve that with a wildcard project collection id &quot;-&quot;.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]452Refer to [List
453Sub-Collections](https://cloud.google.com/apis/design/design_patterns#list_sub-collections).
454
455Args:
456 parent: string, Required. The project to list agents from.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]457Format: `projects/&lt;Project ID or &#x27;-&#x27;&gt;`. (required)
458 pageToken: string, Optional. The next_page_token value returned from a previous list request.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]459 pageSize: integer, Optional. The maximum number of items to return in a single page. By
460default 100 and at most 1000.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]461 x__xgafv: string, V1 error format.
462 Allowed values
463 1 - v1 error format
464 2 - v2 error format
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]465
466Returns:
467 An object of the form:
468
469 { # The response message for Agents.SearchAgents.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]470 &quot;agents&quot;: [ # The list of agents. There will be a maximum number of items returned based
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]471 # on the page_size field in the request.
472 { # Represents a conversational agent.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]473 &quot;timeZone&quot;: &quot;A String&quot;, # Required. The time zone of this agent from the
474 # [time zone database](https://www.iana.org/time-zones), e.g.,
475 # America/New_York, Europe/Paris.
476 &quot;description&quot;: &quot;A String&quot;, # Optional. The description of this agent.
477 # The maximum length is 500 characters. If exceeded, the request is rejected.
478 &quot;parent&quot;: &quot;A String&quot;, # Required. The project of this agent.
479 # Format: `projects/&lt;Project ID&gt;`.
480 &quot;supportedLanguageCodes&quot;: [ # Optional. The list of all languages supported by this agent (except for the
481 # `default_language_code`).
482 &quot;A String&quot;,
483 ],
484 &quot;avatarUri&quot;: &quot;A String&quot;, # Optional. The URI of the agent&#x27;s avatar.
485 # Avatars are used throughout the Dialogflow console and in the self-hosted
486 # [Web
487 # Demo](https://cloud.google.com/dialogflow/docs/integrations/web-demo)
488 # integration.
489 &quot;defaultLanguageCode&quot;: &quot;A String&quot;, # Required. The default language of the agent as a language tag. See
490 # [Language
491 # Support](https://cloud.google.com/dialogflow/docs/reference/language)
492 # for a list of the currently supported language codes. This field cannot be
493 # set by the `Update` method.
494 &quot;tier&quot;: &quot;A String&quot;, # Optional. The agent tier. If not specified, TIER_STANDARD is assumed.
495 &quot;displayName&quot;: &quot;A String&quot;, # Required. The name of this agent.
496 &quot;matchMode&quot;: &quot;A String&quot;, # Optional. Determines how intents are detected from user queries.
497 &quot;enableLogging&quot;: True or False, # Optional. Determines whether this agent should log conversation queries.
498 &quot;apiVersion&quot;: &quot;A String&quot;, # Optional. API version displayed in Dialogflow console. If not specified,
499 # V2 API is assumed. Clients are free to query different service endpoints
500 # for different API versions. However, bots connectors and webhook calls will
501 # follow the specified API version.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame^]502 &quot;classificationThreshold&quot;: 3.14, # Optional. To filter out false positive results and still get variety in
503 # matched natural language inputs for your agent, you can tune the machine
504 # learning classification threshold. If the returned score value is less than
505 # the threshold value, then a fallback intent will be triggered or, if there
506 # are no fallback intents defined, no intent will be triggered. The score
507 # values range from 0.0 (completely uncertain) to 1.0 (completely certain).
508 # If set to 0.0, the default of 0.3 is used.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]509 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]510 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]511 &quot;nextPageToken&quot;: &quot;A String&quot;, # Token to retrieve the next page of results, or empty if there are no
512 # more results in the list.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]513 }</pre>
514</div>
515
516<div class="method">
517 <code class="details" id="search_next">search_next(previous_request, previous_response)</code>
518 <pre>Retrieves the next page of results.
519
520Args:
521 previous_request: The request for the previous page. (required)
522 previous_response: The response from the request for the previous page. (required)
523
524Returns:
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]525 A request object that you can call &#x27;execute()&#x27; on to request the next
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]526 page. Returns None if there are no more items in the collection.
527 </pre>
528</div>
529
530<div class="method">
531 <code class="details" id="train">train(parent, body=None, x__xgafv=None)</code>
532 <pre>Trains the specified agent.
533
534
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]535Operation &lt;response: google.protobuf.Empty&gt;
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]536
537Args:
538 parent: string, Required. The project that the agent to train is associated with.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]539Format: `projects/&lt;Project ID&gt;`. (required)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]540 body: object, The request body.
541 The object takes the form of:
542
543{ # The request message for Agents.TrainAgent.
544 }
545
546 x__xgafv: string, V1 error format.
547 Allowed values
548 1 - v1 error format
549 2 - v2 error format
550
551Returns:
552 An object of the form:
553
554 { # This resource represents a long-running operation that is the result of a
555 # network API call.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame^]556 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
557 # originally returns it. If you use the default HTTP mapping, the
558 # `name` should be a resource name ending with `operations/{unique_id}`.
559 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
560 # different programming environments, including REST APIs and RPC APIs. It is
561 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
562 # three pieces of data: error code, error message, and error details.
563 #
564 # You can find out more about this error model and how to work with it in the
565 # [API Design Guide](https://cloud.google.com/apis/design/errors).
566 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
567 # user-facing error message should be localized and sent in the
568 # google.rpc.Status.details field, or localized by the client.
569 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
570 # message types for APIs to use.
571 {
572 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
573 },
574 ],
575 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
576 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]577 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically
578 # contains progress information and common metadata such as create time.
579 # Some services might not provide such metadata. Any method that returns a
580 # long-running operation should document the metadata type, if any.
581 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
582 },
583 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
584 # If `true`, the operation is completed, and either `error` or `response` is
585 # available.
586 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]587 # method returns no data on success, such as `Delete`, the response is
588 # `google.protobuf.Empty`. If the original method is standard
589 # `Get`/`Create`/`Update`, the response should be the resource. For other
590 # methods, the response should have the type `XxxResponse`, where `Xxx`
591 # is the original method name. For example, if the original method name
592 # is `TakeSnapshot()`, the inferred response type is
593 # `TakeSnapshotResponse`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]594 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]595 },
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]596 }</pre>
597</div>
598
599<div class="method">
600 <code class="details" id="updateFulfillment">updateFulfillment(name, body=None, updateMask=None, x__xgafv=None)</code>
601 <pre>Updates the fulfillment.
602
603Args:
604 name: string, Required. The unique identifier of the fulfillment.
605Format: `projects/&lt;Project ID&gt;/agent/fulfillment`. (required)
606 body: object, The request body.
607 The object takes the form of:
608
609{ # Represents a fulfillment.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame^]610 &quot;features&quot;: [ # Optional. The field defines whether the fulfillment is enabled for certain features.
611 { # Whether fulfillment is enabled for the specific feature.
612 &quot;type&quot;: &quot;A String&quot;, # The type of the feature that enabled for fulfillment.
613 },
614 ],
615 &quot;name&quot;: &quot;A String&quot;, # Required. The unique identifier of the fulfillment.
616 # Format: `projects/&lt;Project ID&gt;/agent/fulfillment`.
617 &quot;displayName&quot;: &quot;A String&quot;, # Optional. The human-readable name of the fulfillment, unique within the agent.
618 &quot;enabled&quot;: True or False, # Optional. Whether fulfillment is enabled.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]619 &quot;genericWebService&quot;: { # Represents configuration for a generic web service. # Configuration for a generic web service.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]620 # Dialogflow supports two mechanisms for authentications:
621 # - Basic authentication with username and password.
622 # - Authentication with additional authentication headers.
623 # More information could be found at:
624 # https://cloud.google.com/dialogflow/docs/fulfillment-configure.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]625 &quot;uri&quot;: &quot;A String&quot;, # Required. The fulfillment URI for receiving POST requests.
626 # It must use https protocol.
627 &quot;password&quot;: &quot;A String&quot;, # Optional. The password for HTTP Basic authentication.
628 &quot;isCloudFunction&quot;: True or False, # Optional. Indicates if generic web service is created through Cloud Functions
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]629 # integration. Defaults to false.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]630 &quot;username&quot;: &quot;A String&quot;, # Optional. The user name for HTTP Basic authentication.
631 &quot;requestHeaders&quot;: { # Optional. The HTTP request headers to send together with fulfillment requests.
632 &quot;a_key&quot;: &quot;A String&quot;,
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]633 },
634 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame^]635 }
636
637 updateMask: string, Required. The mask to control which fields get updated. If the mask is not
638present, all fields will be updated.
639 x__xgafv: string, V1 error format.
640 Allowed values
641 1 - v1 error format
642 2 - v2 error format
643
644Returns:
645 An object of the form:
646
647 { # Represents a fulfillment.
648 &quot;features&quot;: [ # Optional. The field defines whether the fulfillment is enabled for certain features.
649 { # Whether fulfillment is enabled for the specific feature.
650 &quot;type&quot;: &quot;A String&quot;, # The type of the feature that enabled for fulfillment.
651 },
652 ],
653 &quot;name&quot;: &quot;A String&quot;, # Required. The unique identifier of the fulfillment.
654 # Format: `projects/&lt;Project ID&gt;/agent/fulfillment`.
655 &quot;displayName&quot;: &quot;A String&quot;, # Optional. The human-readable name of the fulfillment, unique within the agent.
656 &quot;enabled&quot;: True or False, # Optional. Whether fulfillment is enabled.
657 &quot;genericWebService&quot;: { # Represents configuration for a generic web service. # Configuration for a generic web service.
658 # Dialogflow supports two mechanisms for authentications:
659 # - Basic authentication with username and password.
660 # - Authentication with additional authentication headers.
661 # More information could be found at:
662 # https://cloud.google.com/dialogflow/docs/fulfillment-configure.
663 &quot;uri&quot;: &quot;A String&quot;, # Required. The fulfillment URI for receiving POST requests.
664 # It must use https protocol.
665 &quot;password&quot;: &quot;A String&quot;, # Optional. The password for HTTP Basic authentication.
666 &quot;isCloudFunction&quot;: True or False, # Optional. Indicates if generic web service is created through Cloud Functions
667 # integration. Defaults to false.
668 &quot;username&quot;: &quot;A String&quot;, # Optional. The user name for HTTP Basic authentication.
669 &quot;requestHeaders&quot;: { # Optional. The HTTP request headers to send together with fulfillment requests.
670 &quot;a_key&quot;: &quot;A String&quot;,
671 },
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]672 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame^]673 }</pre>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]674</div>
675
676</body></html>