Skip to content
This repository was archived by the owner on Sep 16, 2023. It is now read-only.

Commit a3432ed

Browse files
feat: mark agent.default_language_code as required (#246)
PiperOrigin-RevId: 380726996 Source-Link: googleapis/googleapis@a5cec0a Source-Link: https://github.com/googleapis/googleapis-gen/commit/1e4922a1a812a78ebf324213df2ae079623020cb feat: add return_partial response to Fulfillment docs: add notes to train agent before sending queries
1 parent ff6f759 commit a3432ed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

41 files changed

+1840
-480
lines changed

google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/AgentsClient.java

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -391,6 +391,9 @@ public final UnaryCallable<GetAgentRequest, Agent> getAgentCallable() {
391391
/**
392392
* Creates an agent in the specified location.
393393
*
394+
* <p>Note: You should always train flows prior to sending them queries. See the [training
395+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
396+
*
394397
* <p>Sample code:
395398
*
396399
* <pre>{@code
@@ -419,6 +422,9 @@ public final Agent createAgent(LocationName parent, Agent agent) {
419422
/**
420423
* Creates an agent in the specified location.
421424
*
425+
* <p>Note: You should always train flows prior to sending them queries. See the [training
426+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
427+
*
422428
* <p>Sample code:
423429
*
424430
* <pre>{@code
@@ -444,6 +450,9 @@ public final Agent createAgent(String parent, Agent agent) {
444450
/**
445451
* Creates an agent in the specified location.
446452
*
453+
* <p>Note: You should always train flows prior to sending them queries. See the [training
454+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
455+
*
447456
* <p>Sample code:
448457
*
449458
* <pre>{@code
@@ -468,6 +477,9 @@ public final Agent createAgent(CreateAgentRequest request) {
468477
/**
469478
* Creates an agent in the specified location.
470479
*
480+
* <p>Note: You should always train flows prior to sending them queries. See the [training
481+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
482+
*
471483
* <p>Sample code:
472484
*
473485
* <pre>{@code
@@ -491,6 +503,9 @@ public final UnaryCallable<CreateAgentRequest, Agent> createAgentCallable() {
491503
/**
492504
* Updates the specified agent.
493505
*
506+
* <p>Note: You should always train flows prior to sending them queries. See the [training
507+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
508+
*
494509
* <p>Sample code:
495510
*
496511
* <pre>{@code
@@ -516,6 +531,9 @@ public final Agent updateAgent(Agent agent, FieldMask updateMask) {
516531
/**
517532
* Updates the specified agent.
518533
*
534+
* <p>Note: You should always train flows prior to sending them queries. See the [training
535+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
536+
*
519537
* <p>Sample code:
520538
*
521539
* <pre>{@code
@@ -540,6 +558,9 @@ public final Agent updateAgent(UpdateAgentRequest request) {
540558
/**
541559
* Updates the specified agent.
542560
*
561+
* <p>Note: You should always train flows prior to sending them queries. See the [training
562+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
563+
*
543564
* <p>Sample code:
544565
*
545566
* <pre>{@code
@@ -738,6 +759,9 @@ public final UnaryCallable<ExportAgentRequest, Operation> exportAgentCallable()
738759
* <p>Replaces the current agent with a new one. Note that all existing resources in agent (e.g.
739760
* intents, entity types, flows) will be removed.
740761
*
762+
* <p>Note: You should always train flows prior to sending them queries. See the [training
763+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
764+
*
741765
* <p>Sample code:
742766
*
743767
* <pre>{@code
@@ -764,6 +788,9 @@ public final OperationFuture<Empty, Struct> restoreAgentAsync(RestoreAgentReques
764788
* <p>Replaces the current agent with a new one. Note that all existing resources in agent (e.g.
765789
* intents, entity types, flows) will be removed.
766790
*
791+
* <p>Note: You should always train flows prior to sending them queries. See the [training
792+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
793+
*
767794
* <p>Sample code:
768795
*
769796
* <pre>{@code
@@ -791,6 +818,9 @@ public final OperationFuture<Empty, Struct> restoreAgentAsync(RestoreAgentReques
791818
* <p>Replaces the current agent with a new one. Note that all existing resources in agent (e.g.
792819
* intents, entity types, flows) will be removed.
793820
*
821+
* <p>Note: You should always train flows prior to sending them queries. See the [training
822+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
823+
*
794824
* <p>Sample code:
795825
*
796826
* <pre>{@code

google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/EntityTypesClient.java

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -405,6 +405,9 @@ public final UnaryCallable<GetEntityTypeRequest, EntityType> getEntityTypeCallab
405405
/**
406406
* Creates an entity type in the specified agent.
407407
*
408+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
409+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
410+
*
408411
* <p>Sample code:
409412
*
410413
* <pre>{@code
@@ -433,6 +436,9 @@ public final EntityType createEntityType(AgentName parent, EntityType entityType
433436
/**
434437
* Creates an entity type in the specified agent.
435438
*
439+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
440+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
441+
*
436442
* <p>Sample code:
437443
*
438444
* <pre>{@code
@@ -459,6 +465,9 @@ public final EntityType createEntityType(String parent, EntityType entityType) {
459465
/**
460466
* Creates an entity type in the specified agent.
461467
*
468+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
469+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
470+
*
462471
* <p>Sample code:
463472
*
464473
* <pre>{@code
@@ -486,6 +495,9 @@ public final EntityType createEntityType(CreateEntityTypeRequest request) {
486495
/**
487496
* Creates an entity type in the specified agent.
488497
*
498+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
499+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
500+
*
489501
* <p>Sample code:
490502
*
491503
* <pre>{@code
@@ -513,6 +525,9 @@ public final UnaryCallable<CreateEntityTypeRequest, EntityType> createEntityType
513525
/**
514526
* Updates the specified entity type.
515527
*
528+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
529+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
530+
*
516531
* <p>Sample code:
517532
*
518533
* <pre>{@code
@@ -540,6 +555,9 @@ public final EntityType updateEntityType(EntityType entityType, FieldMask update
540555
/**
541556
* Updates the specified entity type.
542557
*
558+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
559+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
560+
*
543561
* <p>Sample code:
544562
*
545563
* <pre>{@code
@@ -565,6 +583,9 @@ public final EntityType updateEntityType(UpdateEntityTypeRequest request) {
565583
/**
566584
* Updates the specified entity type.
567585
*
586+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
587+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
588+
*
568589
* <p>Sample code:
569590
*
570591
* <pre>{@code
@@ -590,6 +611,9 @@ public final UnaryCallable<UpdateEntityTypeRequest, EntityType> updateEntityType
590611
/**
591612
* Deletes the specified entity type.
592613
*
614+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
615+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
616+
*
593617
* <p>Sample code:
594618
*
595619
* <pre>{@code
@@ -615,6 +639,9 @@ public final void deleteEntityType(EntityTypeName name) {
615639
/**
616640
* Deletes the specified entity type.
617641
*
642+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
643+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
644+
*
618645
* <p>Sample code:
619646
*
620647
* <pre>{@code
@@ -639,6 +666,9 @@ public final void deleteEntityType(String name) {
639666
/**
640667
* Deletes the specified entity type.
641668
*
669+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
670+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
671+
*
642672
* <p>Sample code:
643673
*
644674
* <pre>{@code
@@ -665,6 +695,9 @@ public final void deleteEntityType(DeleteEntityTypeRequest request) {
665695
/**
666696
* Deletes the specified entity type.
667697
*
698+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
699+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
700+
*
668701
* <p>Sample code:
669702
*
670703
* <pre>{@code

google-cloud-dialogflow-cx/src/main/java/com/google/cloud/dialogflow/cx/v3/FlowsClient.java

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -167,6 +167,9 @@ public final OperationsClient getOperationsClient() {
167167
/**
168168
* Creates a flow in the specified agent.
169169
*
170+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
171+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
172+
*
170173
* <p>Sample code:
171174
*
172175
* <pre>{@code
@@ -195,6 +198,9 @@ public final Flow createFlow(AgentName parent, Flow flow) {
195198
/**
196199
* Creates a flow in the specified agent.
197200
*
201+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
202+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
203+
*
198204
* <p>Sample code:
199205
*
200206
* <pre>{@code
@@ -220,6 +226,9 @@ public final Flow createFlow(String parent, Flow flow) {
220226
/**
221227
* Creates a flow in the specified agent.
222228
*
229+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
230+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
231+
*
223232
* <p>Sample code:
224233
*
225234
* <pre>{@code
@@ -245,6 +254,9 @@ public final Flow createFlow(CreateFlowRequest request) {
245254
/**
246255
* Creates a flow in the specified agent.
247256
*
257+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
258+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
259+
*
248260
* <p>Sample code:
249261
*
250262
* <pre>{@code
@@ -591,6 +603,9 @@ public final UnaryCallable<GetFlowRequest, Flow> getFlowCallable() {
591603
/**
592604
* Updates the specified flow.
593605
*
606+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
607+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
608+
*
594609
* <p>Sample code:
595610
*
596611
* <pre>{@code
@@ -616,6 +631,9 @@ public final Flow updateFlow(Flow flow, FieldMask updateMask) {
616631
/**
617632
* Updates the specified flow.
618633
*
634+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
635+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
636+
*
619637
* <p>Sample code:
620638
*
621639
* <pre>{@code
@@ -641,6 +659,9 @@ public final Flow updateFlow(UpdateFlowRequest request) {
641659
/**
642660
* Updates the specified flow.
643661
*
662+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
663+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
664+
*
644665
* <p>Sample code:
645666
*
646667
* <pre>{@code
@@ -665,6 +686,9 @@ public final UnaryCallable<UpdateFlowRequest, Flow> updateFlowCallable() {
665686
/**
666687
* Trains the specified flow. Note that only the flow in 'draft' environment is trained.
667688
*
689+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
690+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
691+
*
668692
* <p>Sample code:
669693
*
670694
* <pre>{@code
@@ -688,6 +712,9 @@ public final OperationFuture<Empty, Struct> trainFlowAsync(FlowName name) {
688712
/**
689713
* Trains the specified flow. Note that only the flow in 'draft' environment is trained.
690714
*
715+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
716+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
717+
*
691718
* <p>Sample code:
692719
*
693720
* <pre>{@code
@@ -710,6 +737,9 @@ public final OperationFuture<Empty, Struct> trainFlowAsync(String name) {
710737
/**
711738
* Trains the specified flow. Note that only the flow in 'draft' environment is trained.
712739
*
740+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
741+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
742+
*
713743
* <p>Sample code:
714744
*
715745
* <pre>{@code
@@ -733,6 +763,9 @@ public final OperationFuture<Empty, Struct> trainFlowAsync(TrainFlowRequest requ
733763
/**
734764
* Trains the specified flow. Note that only the flow in 'draft' environment is trained.
735765
*
766+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
767+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
768+
*
736769
* <p>Sample code:
737770
*
738771
* <pre>{@code
@@ -756,6 +789,9 @@ public final OperationCallable<TrainFlowRequest, Empty, Struct> trainFlowOperati
756789
/**
757790
* Trains the specified flow. Note that only the flow in 'draft' environment is trained.
758791
*
792+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
793+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
794+
*
759795
* <p>Sample code:
760796
*
761797
* <pre>{@code
@@ -938,6 +974,9 @@ public final FlowValidationResult getFlowValidationResult(
938974
/**
939975
* Imports the specified flow to the specified agent from a binary file.
940976
*
977+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
978+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
979+
*
941980
* <p>Sample code:
942981
*
943982
* <pre>{@code
@@ -962,6 +1001,9 @@ public final OperationFuture<ImportFlowResponse, Struct> importFlowAsync(
9621001
/**
9631002
* Imports the specified flow to the specified agent from a binary file.
9641003
*
1004+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
1005+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
1006+
*
9651007
* <p>Sample code:
9661008
*
9671009
* <pre>{@code
@@ -986,6 +1028,9 @@ public final OperationFuture<ImportFlowResponse, Struct> importFlowAsync(
9861028
/**
9871029
* Imports the specified flow to the specified agent from a binary file.
9881030
*
1031+
* <p>Note: You should always train a flow prior to sending it queries. See the [training
1032+
* documentation](https://cloud.google.com/dialogflow/cx/docs/concept/training).
1033+
*
9891034
* <p>Sample code:
9901035
*
9911036
* <pre>{@code

0 commit comments

Comments
 (0)