aws-sdk-bedrockagentruntime 1.0.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -0,0 +1,1272 @@
1
+ # frozen_string_literal: true
2
+
3
+ # WARNING ABOUT GENERATED CODE
4
+ #
5
+ # This file is generated. See the contributing guide for more information:
6
+ # https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
7
+ #
8
+ # WARNING ABOUT GENERATED CODE
9
+
10
+ module Aws::BedrockAgentRuntime
11
+ module Types
12
+
13
+ # This exception is thrown when a request is denied per access
14
+ # permissions
15
+ #
16
+ # @!attribute [rw] message
17
+ # Non Blank String
18
+ # @return [String]
19
+ #
20
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/AccessDeniedException AWS API Documentation
21
+ #
22
+ class AccessDeniedException < Struct.new(
23
+ :message,
24
+ :event_type)
25
+ SENSITIVE = []
26
+ include Aws::Structure
27
+ end
28
+
29
+ # input to lambda used in action group
30
+ #
31
+ # @!attribute [rw] action_group_name
32
+ # Agent Trace Action Group Name
33
+ # @return [String]
34
+ #
35
+ # @!attribute [rw] verb
36
+ # Agent Trace Action Group Action verb
37
+ # @return [String]
38
+ #
39
+ # @!attribute [rw] api_path
40
+ # Agent Trace Action Group API path
41
+ # @return [String]
42
+ #
43
+ # @!attribute [rw] parameters
44
+ # list of parameters included in action group invocation
45
+ # @return [Array<Types::Parameter>]
46
+ #
47
+ # @!attribute [rw] request_body
48
+ # Request Body Content Map
49
+ # @return [Types::RequestBody]
50
+ #
51
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/ActionGroupInvocationInput AWS API Documentation
52
+ #
53
+ class ActionGroupInvocationInput < Struct.new(
54
+ :action_group_name,
55
+ :verb,
56
+ :api_path,
57
+ :parameters,
58
+ :request_body)
59
+ SENSITIVE = [:action_group_name, :verb, :api_path]
60
+ include Aws::Structure
61
+ end
62
+
63
+ # output from lambda used in action group
64
+ #
65
+ # @!attribute [rw] text
66
+ # Agent Trace Action Group Lambda Invocation Output String
67
+ # @return [String]
68
+ #
69
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/ActionGroupInvocationOutput AWS API Documentation
70
+ #
71
+ class ActionGroupInvocationOutput < Struct.new(
72
+ :text)
73
+ SENSITIVE = [:text]
74
+ include Aws::Structure
75
+ end
76
+
77
+ # Citations associated with final agent response
78
+ #
79
+ # @!attribute [rw] citations
80
+ # List of citations
81
+ # @return [Array<Types::Citation>]
82
+ #
83
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/Attribution AWS API Documentation
84
+ #
85
+ class Attribution < Struct.new(
86
+ :citations)
87
+ SENSITIVE = []
88
+ include Aws::Structure
89
+ end
90
+
91
+ # This exception is thrown when a request fails due to dependency like
92
+ # Lambda, Bedrock, STS resource
93
+ #
94
+ # @!attribute [rw] message
95
+ # Non Blank String
96
+ # @return [String]
97
+ #
98
+ # @!attribute [rw] resource_name
99
+ # Non Blank String
100
+ # @return [String]
101
+ #
102
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/BadGatewayException AWS API Documentation
103
+ #
104
+ class BadGatewayException < Struct.new(
105
+ :message,
106
+ :resource_name,
107
+ :event_type)
108
+ SENSITIVE = []
109
+ include Aws::Structure
110
+ end
111
+
112
+ # Citation associated with the agent response
113
+ #
114
+ # @!attribute [rw] generated_response_part
115
+ # Generate response part
116
+ # @return [Types::GeneratedResponsePart]
117
+ #
118
+ # @!attribute [rw] retrieved_references
119
+ # list of retrieved references
120
+ # @return [Array<Types::RetrievedReference>]
121
+ #
122
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/Citation AWS API Documentation
123
+ #
124
+ class Citation < Struct.new(
125
+ :generated_response_part,
126
+ :retrieved_references)
127
+ SENSITIVE = []
128
+ include Aws::Structure
129
+ end
130
+
131
+ # This exception is thrown when there is a conflict performing an
132
+ # operation
133
+ #
134
+ # @!attribute [rw] message
135
+ # Non Blank String
136
+ # @return [String]
137
+ #
138
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/ConflictException AWS API Documentation
139
+ #
140
+ class ConflictException < Struct.new(
141
+ :message,
142
+ :event_type)
143
+ SENSITIVE = []
144
+ include Aws::Structure
145
+ end
146
+
147
+ # This exception is thrown when a request fails due to dependency like
148
+ # Lambda, Bedrock, STS resource due to a customer fault (i.e. bad
149
+ # configuration)
150
+ #
151
+ # @!attribute [rw] message
152
+ # Non Blank String
153
+ # @return [String]
154
+ #
155
+ # @!attribute [rw] resource_name
156
+ # Non Blank String
157
+ # @return [String]
158
+ #
159
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/DependencyFailedException AWS API Documentation
160
+ #
161
+ class DependencyFailedException < Struct.new(
162
+ :message,
163
+ :resource_name,
164
+ :event_type)
165
+ SENSITIVE = []
166
+ include Aws::Structure
167
+ end
168
+
169
+ # Trace Part which is emitted when agent trace could not be generated
170
+ #
171
+ # @!attribute [rw] trace_id
172
+ # Identifier for trace
173
+ # @return [String]
174
+ #
175
+ # @!attribute [rw] failure_reason
176
+ # Agent Trace Failed Reason String
177
+ # @return [String]
178
+ #
179
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/FailureTrace AWS API Documentation
180
+ #
181
+ class FailureTrace < Struct.new(
182
+ :trace_id,
183
+ :failure_reason)
184
+ SENSITIVE = [:failure_reason]
185
+ include Aws::Structure
186
+ end
187
+
188
+ # Agent finish output
189
+ #
190
+ # @!attribute [rw] text
191
+ # Agent Trace Action Group Lambda Invocation Output String
192
+ # @return [String]
193
+ #
194
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/FinalResponse AWS API Documentation
195
+ #
196
+ class FinalResponse < Struct.new(
197
+ :text)
198
+ SENSITIVE = [:text]
199
+ include Aws::Structure
200
+ end
201
+
202
+ # Generate response part
203
+ #
204
+ # @!attribute [rw] text_response_part
205
+ # Text response part
206
+ # @return [Types::TextResponsePart]
207
+ #
208
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/GeneratedResponsePart AWS API Documentation
209
+ #
210
+ class GeneratedResponsePart < Struct.new(
211
+ :text_response_part)
212
+ SENSITIVE = []
213
+ include Aws::Structure
214
+ end
215
+
216
+ # Configurations for controlling the inference response of an
217
+ # InvokeAgent API call
218
+ #
219
+ # @!attribute [rw] temperature
220
+ # Controls randomness, higher values increase diversity
221
+ # @return [Float]
222
+ #
223
+ # @!attribute [rw] top_p
224
+ # Cumulative probability cutoff for token selection
225
+ # @return [Float]
226
+ #
227
+ # @!attribute [rw] top_k
228
+ # Sample from the k most likely next tokens
229
+ # @return [Integer]
230
+ #
231
+ # @!attribute [rw] maximum_length
232
+ # Maximum length of output
233
+ # @return [Integer]
234
+ #
235
+ # @!attribute [rw] stop_sequences
236
+ # List of stop sequences
237
+ # @return [Array<String>]
238
+ #
239
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/InferenceConfiguration AWS API Documentation
240
+ #
241
+ class InferenceConfiguration < Struct.new(
242
+ :temperature,
243
+ :top_p,
244
+ :top_k,
245
+ :maximum_length,
246
+ :stop_sequences)
247
+ SENSITIVE = []
248
+ include Aws::Structure
249
+ end
250
+
251
+ # This exception is thrown if there was an unexpected error during
252
+ # processing of request
253
+ #
254
+ # @!attribute [rw] message
255
+ # Non Blank String
256
+ # @return [String]
257
+ #
258
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/InternalServerException AWS API Documentation
259
+ #
260
+ class InternalServerException < Struct.new(
261
+ :message,
262
+ :event_type)
263
+ SENSITIVE = []
264
+ include Aws::Structure
265
+ end
266
+
267
+ # Trace Part which contains input details for action group or knowledge
268
+ # base
269
+ #
270
+ # @!attribute [rw] trace_id
271
+ # Identifier for trace
272
+ # @return [String]
273
+ #
274
+ # @!attribute [rw] invocation_type
275
+ # types of invocations
276
+ # @return [String]
277
+ #
278
+ # @!attribute [rw] action_group_invocation_input
279
+ # input to lambda used in action group
280
+ # @return [Types::ActionGroupInvocationInput]
281
+ #
282
+ # @!attribute [rw] knowledge_base_lookup_input
283
+ # Input to lambda used in action group
284
+ # @return [Types::KnowledgeBaseLookupInput]
285
+ #
286
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/InvocationInput AWS API Documentation
287
+ #
288
+ class InvocationInput < Struct.new(
289
+ :trace_id,
290
+ :invocation_type,
291
+ :action_group_invocation_input,
292
+ :knowledge_base_lookup_input)
293
+ SENSITIVE = []
294
+ include Aws::Structure
295
+ end
296
+
297
+ # InvokeAgent Request
298
+ #
299
+ # @!attribute [rw] session_state
300
+ # Session state passed by customer. Base64 encoded json string
301
+ # representation of SessionState.
302
+ # @return [Types::SessionState]
303
+ #
304
+ # @!attribute [rw] agent_id
305
+ # Identifier for Agent
306
+ # @return [String]
307
+ #
308
+ # @!attribute [rw] agent_alias_id
309
+ # Identifier for Agent Alias
310
+ # @return [String]
311
+ #
312
+ # @!attribute [rw] session_id
313
+ # Identifier used for the current session
314
+ # @return [String]
315
+ #
316
+ # @!attribute [rw] end_session
317
+ # End current session
318
+ # @return [Boolean]
319
+ #
320
+ # @!attribute [rw] enable_trace
321
+ # Enable agent trace events for improved debugging
322
+ # @return [Boolean]
323
+ #
324
+ # @!attribute [rw] input_text
325
+ # Input data in the format specified in the Content-Type request
326
+ # header.
327
+ # @return [String]
328
+ #
329
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/InvokeAgentRequest AWS API Documentation
330
+ #
331
+ class InvokeAgentRequest < Struct.new(
332
+ :session_state,
333
+ :agent_id,
334
+ :agent_alias_id,
335
+ :session_id,
336
+ :end_session,
337
+ :enable_trace,
338
+ :input_text)
339
+ SENSITIVE = [:input_text]
340
+ include Aws::Structure
341
+ end
342
+
343
+ # InvokeAgent Response
344
+ #
345
+ # @!attribute [rw] completion
346
+ # Inference response from the model in the format specified in the
347
+ # Content-Type response header.
348
+ # @return [Types::ResponseStream]
349
+ #
350
+ # @!attribute [rw] content_type
351
+ # streaming response mimetype of the model
352
+ # @return [String]
353
+ #
354
+ # @!attribute [rw] session_id
355
+ # streaming response mimetype of the model
356
+ # @return [String]
357
+ #
358
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/InvokeAgentResponse AWS API Documentation
359
+ #
360
+ class InvokeAgentResponse < Struct.new(
361
+ :completion,
362
+ :content_type,
363
+ :session_id)
364
+ SENSITIVE = []
365
+ include Aws::Structure
366
+ end
367
+
368
+ # Input to lambda used in action group
369
+ #
370
+ # @!attribute [rw] text
371
+ # Agent Trace Action Group Lambda Invocation Output String
372
+ # @return [String]
373
+ #
374
+ # @!attribute [rw] knowledge_base_id
375
+ # Agent Trace Action Group Knowledge Base Id
376
+ # @return [String]
377
+ #
378
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/KnowledgeBaseLookupInput AWS API Documentation
379
+ #
380
+ class KnowledgeBaseLookupInput < Struct.new(
381
+ :text,
382
+ :knowledge_base_id)
383
+ SENSITIVE = [:text, :knowledge_base_id]
384
+ include Aws::Structure
385
+ end
386
+
387
+ # Input to lambda used in action group
388
+ #
389
+ # @!attribute [rw] retrieved_references
390
+ # list of retrieved references
391
+ # @return [Array<Types::RetrievedReference>]
392
+ #
393
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/KnowledgeBaseLookupOutput AWS API Documentation
394
+ #
395
+ class KnowledgeBaseLookupOutput < Struct.new(
396
+ :retrieved_references)
397
+ SENSITIVE = []
398
+ include Aws::Structure
399
+ end
400
+
401
+ # Knowledge base input query.
402
+ #
403
+ # @!attribute [rw] text
404
+ # Knowledge base input query in text
405
+ # @return [String]
406
+ #
407
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/KnowledgeBaseQuery AWS API Documentation
408
+ #
409
+ class KnowledgeBaseQuery < Struct.new(
410
+ :text)
411
+ SENSITIVE = []
412
+ include Aws::Structure
413
+ end
414
+
415
+ # Search parameters for retrieving from knowledge base.
416
+ #
417
+ # @!attribute [rw] vector_search_configuration
418
+ # Knowledge base vector search configuration
419
+ # @return [Types::KnowledgeBaseVectorSearchConfiguration]
420
+ #
421
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/KnowledgeBaseRetrievalConfiguration AWS API Documentation
422
+ #
423
+ class KnowledgeBaseRetrievalConfiguration < Struct.new(
424
+ :vector_search_configuration)
425
+ SENSITIVE = []
426
+ include Aws::Structure
427
+ end
428
+
429
+ # Result item returned from a knowledge base retrieval.
430
+ #
431
+ # @!attribute [rw] content
432
+ # Content of a retrieval result.
433
+ # @return [Types::RetrievalResultContent]
434
+ #
435
+ # @!attribute [rw] location
436
+ # The source location of a retrieval result.
437
+ # @return [Types::RetrievalResultLocation]
438
+ #
439
+ # @!attribute [rw] score
440
+ # The relevance score of a result.
441
+ # @return [Float]
442
+ #
443
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/KnowledgeBaseRetrievalResult AWS API Documentation
444
+ #
445
+ class KnowledgeBaseRetrievalResult < Struct.new(
446
+ :content,
447
+ :location,
448
+ :score)
449
+ SENSITIVE = []
450
+ include Aws::Structure
451
+ end
452
+
453
+ # Configurations for retrieval and generation for knowledge base.
454
+ #
455
+ # @!attribute [rw] knowledge_base_id
456
+ # Identifier of the KnowledgeBase
457
+ # @return [String]
458
+ #
459
+ # @!attribute [rw] model_arn
460
+ # Arn of a Bedrock model.
461
+ # @return [String]
462
+ #
463
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/KnowledgeBaseRetrieveAndGenerateConfiguration AWS API Documentation
464
+ #
465
+ class KnowledgeBaseRetrieveAndGenerateConfiguration < Struct.new(
466
+ :knowledge_base_id,
467
+ :model_arn)
468
+ SENSITIVE = []
469
+ include Aws::Structure
470
+ end
471
+
472
+ # Knowledge base vector search configuration
473
+ #
474
+ # @!attribute [rw] number_of_results
475
+ # Top-K results to retrieve from knowledge base.
476
+ # @return [Integer]
477
+ #
478
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/KnowledgeBaseVectorSearchConfiguration AWS API Documentation
479
+ #
480
+ class KnowledgeBaseVectorSearchConfiguration < Struct.new(
481
+ :number_of_results)
482
+ SENSITIVE = []
483
+ include Aws::Structure
484
+ end
485
+
486
+ # Trace Part which contains information used to call Invoke Model
487
+ #
488
+ # @!attribute [rw] trace_id
489
+ # Identifier for trace
490
+ # @return [String]
491
+ #
492
+ # @!attribute [rw] text
493
+ # Prompt Message
494
+ # @return [String]
495
+ #
496
+ # @!attribute [rw] type
497
+ # types of prompts
498
+ # @return [String]
499
+ #
500
+ # @!attribute [rw] inference_configuration
501
+ # Configurations for controlling the inference response of an
502
+ # InvokeAgent API call
503
+ # @return [Types::InferenceConfiguration]
504
+ #
505
+ # @!attribute [rw] override_lambda
506
+ # ARN of a Lambda.
507
+ # @return [String]
508
+ #
509
+ # @!attribute [rw] prompt_creation_mode
510
+ # indicates if agent uses default prompt or overriden prompt
511
+ # @return [String]
512
+ #
513
+ # @!attribute [rw] parser_mode
514
+ # indicates if agent uses default prompt or overriden prompt
515
+ # @return [String]
516
+ #
517
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/ModelInvocationInput AWS API Documentation
518
+ #
519
+ class ModelInvocationInput < Struct.new(
520
+ :trace_id,
521
+ :text,
522
+ :type,
523
+ :inference_configuration,
524
+ :override_lambda,
525
+ :prompt_creation_mode,
526
+ :parser_mode)
527
+ SENSITIVE = [:text]
528
+ include Aws::Structure
529
+ end
530
+
531
+ # Trace Part which contains output details for action group or knowledge
532
+ # base or final response
533
+ #
534
+ # @!attribute [rw] trace_id
535
+ # Identifier for trace
536
+ # @return [String]
537
+ #
538
+ # @!attribute [rw] type
539
+ # types of observations
540
+ # @return [String]
541
+ #
542
+ # @!attribute [rw] action_group_invocation_output
543
+ # output from lambda used in action group
544
+ # @return [Types::ActionGroupInvocationOutput]
545
+ #
546
+ # @!attribute [rw] knowledge_base_lookup_output
547
+ # Input to lambda used in action group
548
+ # @return [Types::KnowledgeBaseLookupOutput]
549
+ #
550
+ # @!attribute [rw] final_response
551
+ # Agent finish output
552
+ # @return [Types::FinalResponse]
553
+ #
554
+ # @!attribute [rw] reprompt_response
555
+ # Observation information if there were reprompts
556
+ # @return [Types::RepromptResponse]
557
+ #
558
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/Observation AWS API Documentation
559
+ #
560
+ class Observation < Struct.new(
561
+ :trace_id,
562
+ :type,
563
+ :action_group_invocation_output,
564
+ :knowledge_base_lookup_output,
565
+ :final_response,
566
+ :reprompt_response)
567
+ SENSITIVE = [:reprompt_response]
568
+ include Aws::Structure
569
+ end
570
+
571
+ # Trace contains intermidate response during orchestration
572
+ #
573
+ # @note OrchestrationTrace is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of OrchestrationTrace corresponding to the set member.
574
+ #
575
+ # @!attribute [rw] rationale
576
+ # Trace Part which contains information related to reasoning
577
+ # @return [Types::Rationale]
578
+ #
579
+ # @!attribute [rw] invocation_input
580
+ # Trace Part which contains input details for action group or
581
+ # knowledge base
582
+ # @return [Types::InvocationInput]
583
+ #
584
+ # @!attribute [rw] observation
585
+ # Trace Part which contains output details for action group or
586
+ # knowledge base or final response
587
+ # @return [Types::Observation]
588
+ #
589
+ # @!attribute [rw] model_invocation_input
590
+ # Trace Part which contains information used to call Invoke Model
591
+ # @return [Types::ModelInvocationInput]
592
+ #
593
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/OrchestrationTrace AWS API Documentation
594
+ #
595
+ class OrchestrationTrace < Struct.new(
596
+ :rationale,
597
+ :invocation_input,
598
+ :observation,
599
+ :model_invocation_input,
600
+ :unknown)
601
+ SENSITIVE = [:rationale, :invocation_input, :observation, :model_invocation_input]
602
+ include Aws::Structure
603
+ include Aws::Structure::Union
604
+
605
+ class Rationale < OrchestrationTrace; end
606
+ class InvocationInput < OrchestrationTrace; end
607
+ class Observation < OrchestrationTrace; end
608
+ class ModelInvocationInput < OrchestrationTrace; end
609
+ class Unknown < OrchestrationTrace; end
610
+ end
611
+
612
+ # parameters included in action group invocation
613
+ #
614
+ # @!attribute [rw] name
615
+ # Name of parameter
616
+ # @return [String]
617
+ #
618
+ # @!attribute [rw] type
619
+ # Type of parameter
620
+ # @return [String]
621
+ #
622
+ # @!attribute [rw] value
623
+ # Value of parameter
624
+ # @return [String]
625
+ #
626
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/Parameter AWS API Documentation
627
+ #
628
+ class Parameter < Struct.new(
629
+ :name,
630
+ :type,
631
+ :value)
632
+ SENSITIVE = []
633
+ include Aws::Structure
634
+ end
635
+
636
+ # Base 64 endoded byte response
637
+ #
638
+ # @!attribute [rw] bytes
639
+ # PartBody of the payload in bytes
640
+ # @return [String]
641
+ #
642
+ # @!attribute [rw] attribution
643
+ # Citations associated with final agent response
644
+ # @return [Types::Attribution]
645
+ #
646
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/PayloadPart AWS API Documentation
647
+ #
648
+ class PayloadPart < Struct.new(
649
+ :bytes,
650
+ :attribution,
651
+ :event_type)
652
+ SENSITIVE = [:bytes]
653
+ include Aws::Structure
654
+ end
655
+
656
+ # Trace Part which contains information related to postprocessing
657
+ #
658
+ # @!attribute [rw] trace_id
659
+ # Identifier for trace
660
+ # @return [String]
661
+ #
662
+ # @!attribute [rw] parsed_response
663
+ # Trace Part which contains information if preprocessing was
664
+ # successful
665
+ # @return [Types::PostProcessingParsedResponse]
666
+ #
667
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/PostProcessingModelInvocationOutput AWS API Documentation
668
+ #
669
+ class PostProcessingModelInvocationOutput < Struct.new(
670
+ :trace_id,
671
+ :parsed_response)
672
+ SENSITIVE = [:parsed_response]
673
+ include Aws::Structure
674
+ end
675
+
676
+ # Trace Part which contains information if preprocessing was successful
677
+ #
678
+ # @!attribute [rw] text
679
+ # Agent Trace Output String
680
+ # @return [String]
681
+ #
682
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/PostProcessingParsedResponse AWS API Documentation
683
+ #
684
+ class PostProcessingParsedResponse < Struct.new(
685
+ :text)
686
+ SENSITIVE = [:text]
687
+ include Aws::Structure
688
+ end
689
+
690
+ # Trace Part which contains information related to post processing step
691
+ #
692
+ # @note PostProcessingTrace is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of PostProcessingTrace corresponding to the set member.
693
+ #
694
+ # @!attribute [rw] model_invocation_input
695
+ # Trace Part which contains information used to call Invoke Model
696
+ # @return [Types::ModelInvocationInput]
697
+ #
698
+ # @!attribute [rw] model_invocation_output
699
+ # Trace Part which contains information related to postprocessing
700
+ # @return [Types::PostProcessingModelInvocationOutput]
701
+ #
702
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/PostProcessingTrace AWS API Documentation
703
+ #
704
+ class PostProcessingTrace < Struct.new(
705
+ :model_invocation_input,
706
+ :model_invocation_output,
707
+ :unknown)
708
+ SENSITIVE = [:model_invocation_input, :model_invocation_output]
709
+ include Aws::Structure
710
+ include Aws::Structure::Union
711
+
712
+ class ModelInvocationInput < PostProcessingTrace; end
713
+ class ModelInvocationOutput < PostProcessingTrace; end
714
+ class Unknown < PostProcessingTrace; end
715
+ end
716
+
717
+ # Trace Part which contains information related to preprocessing
718
+ #
719
+ # @!attribute [rw] trace_id
720
+ # Identifier for trace
721
+ # @return [String]
722
+ #
723
+ # @!attribute [rw] parsed_response
724
+ # Trace Part which contains information if preprocessing was
725
+ # successful
726
+ # @return [Types::PreProcessingParsedResponse]
727
+ #
728
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/PreProcessingModelInvocationOutput AWS API Documentation
729
+ #
730
+ class PreProcessingModelInvocationOutput < Struct.new(
731
+ :trace_id,
732
+ :parsed_response)
733
+ SENSITIVE = [:parsed_response]
734
+ include Aws::Structure
735
+ end
736
+
737
+ # Trace Part which contains information if preprocessing was successful
738
+ #
739
+ # @!attribute [rw] rationale
740
+ # Agent Trace Rationale String
741
+ # @return [String]
742
+ #
743
+ # @!attribute [rw] is_valid
744
+ # Boolean value
745
+ # @return [Boolean]
746
+ #
747
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/PreProcessingParsedResponse AWS API Documentation
748
+ #
749
+ class PreProcessingParsedResponse < Struct.new(
750
+ :rationale,
751
+ :is_valid)
752
+ SENSITIVE = [:rationale]
753
+ include Aws::Structure
754
+ end
755
+
756
+ # Trace Part which contains information related to preprocessing step
757
+ #
758
+ # @note PreProcessingTrace is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of PreProcessingTrace corresponding to the set member.
759
+ #
760
+ # @!attribute [rw] model_invocation_input
761
+ # Trace Part which contains information used to call Invoke Model
762
+ # @return [Types::ModelInvocationInput]
763
+ #
764
+ # @!attribute [rw] model_invocation_output
765
+ # Trace Part which contains information related to preprocessing
766
+ # @return [Types::PreProcessingModelInvocationOutput]
767
+ #
768
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/PreProcessingTrace AWS API Documentation
769
+ #
770
+ class PreProcessingTrace < Struct.new(
771
+ :model_invocation_input,
772
+ :model_invocation_output,
773
+ :unknown)
774
+ SENSITIVE = [:model_invocation_input, :model_invocation_output]
775
+ include Aws::Structure
776
+ include Aws::Structure::Union
777
+
778
+ class ModelInvocationInput < PreProcessingTrace; end
779
+ class ModelInvocationOutput < PreProcessingTrace; end
780
+ class Unknown < PreProcessingTrace; end
781
+ end
782
+
783
+ # Trace Part which contains information related to reasoning
784
+ #
785
+ # @!attribute [rw] trace_id
786
+ # Identifier for trace
787
+ # @return [String]
788
+ #
789
+ # @!attribute [rw] text
790
+ # Agent Trace Rationale String
791
+ # @return [String]
792
+ #
793
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/Rationale AWS API Documentation
794
+ #
795
+ class Rationale < Struct.new(
796
+ :trace_id,
797
+ :text)
798
+ SENSITIVE = [:text]
799
+ include Aws::Structure
800
+ end
801
+
802
+ # Observation information if there were reprompts
803
+ #
804
+ # @!attribute [rw] text
805
+ # Reprompt response text
806
+ # @return [String]
807
+ #
808
+ # @!attribute [rw] source
809
+ # Parsing error source
810
+ # @return [String]
811
+ #
812
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RepromptResponse AWS API Documentation
813
+ #
814
+ class RepromptResponse < Struct.new(
815
+ :text,
816
+ :source)
817
+ SENSITIVE = [:source]
818
+ include Aws::Structure
819
+ end
820
+
821
+ # Request Body Content Map
822
+ #
823
+ # @!attribute [rw] content
824
+ # Content type paramter map
825
+ # @return [Hash<String,Array<Types::Parameter>>]
826
+ #
827
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RequestBody AWS API Documentation
828
+ #
829
+ class RequestBody < Struct.new(
830
+ :content)
831
+ SENSITIVE = []
832
+ include Aws::Structure
833
+ end
834
+
835
+ # This exception is thrown when a resource referenced by the operation
836
+ # does not exist
837
+ #
838
+ # @!attribute [rw] message
839
+ # Non Blank String
840
+ # @return [String]
841
+ #
842
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/ResourceNotFoundException AWS API Documentation
843
+ #
844
+ class ResourceNotFoundException < Struct.new(
845
+ :message,
846
+ :event_type)
847
+ SENSITIVE = []
848
+ include Aws::Structure
849
+ end
850
+
851
+ # Content of a retrieval result.
852
+ #
853
+ # @!attribute [rw] text
854
+ # Content of a retrieval result in text
855
+ # @return [String]
856
+ #
857
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrievalResultContent AWS API Documentation
858
+ #
859
+ class RetrievalResultContent < Struct.new(
860
+ :text)
861
+ SENSITIVE = []
862
+ include Aws::Structure
863
+ end
864
+
865
+ # The source location of a retrieval result.
866
+ #
867
+ # @!attribute [rw] type
868
+ # The location type of a retrieval result.
869
+ # @return [String]
870
+ #
871
+ # @!attribute [rw] s3_location
872
+ # The S3 location of a retrieval result.
873
+ # @return [Types::RetrievalResultS3Location]
874
+ #
875
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrievalResultLocation AWS API Documentation
876
+ #
877
+ class RetrievalResultLocation < Struct.new(
878
+ :type,
879
+ :s3_location)
880
+ SENSITIVE = []
881
+ include Aws::Structure
882
+ end
883
+
884
+ # The S3 location of a retrieval result.
885
+ #
886
+ # @!attribute [rw] uri
887
+ # URI of S3 location
888
+ # @return [String]
889
+ #
890
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrievalResultS3Location AWS API Documentation
891
+ #
892
+ class RetrievalResultS3Location < Struct.new(
893
+ :uri)
894
+ SENSITIVE = []
895
+ include Aws::Structure
896
+ end
897
+
898
+ # Configures the retrieval and generation for the session.
899
+ #
900
+ # @!attribute [rw] type
901
+ # The type of RetrieveAndGenerate.
902
+ # @return [String]
903
+ #
904
+ # @!attribute [rw] knowledge_base_configuration
905
+ # Configurations for retrieval and generation for knowledge base.
906
+ # @return [Types::KnowledgeBaseRetrieveAndGenerateConfiguration]
907
+ #
908
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrieveAndGenerateConfiguration AWS API Documentation
909
+ #
910
+ class RetrieveAndGenerateConfiguration < Struct.new(
911
+ :type,
912
+ :knowledge_base_configuration)
913
+ SENSITIVE = []
914
+ include Aws::Structure
915
+ end
916
+
917
+ # Customer input of the turn
918
+ #
919
+ # @!attribute [rw] text
920
+ # Customer input of the turn in text
921
+ # @return [String]
922
+ #
923
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrieveAndGenerateInput AWS API Documentation
924
+ #
925
+ class RetrieveAndGenerateInput < Struct.new(
926
+ :text)
927
+ SENSITIVE = []
928
+ include Aws::Structure
929
+ end
930
+
931
+ # Service response of the turn
932
+ #
933
+ # @!attribute [rw] text
934
+ # Service response of the turn in text
935
+ # @return [String]
936
+ #
937
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrieveAndGenerateOutput AWS API Documentation
938
+ #
939
+ class RetrieveAndGenerateOutput < Struct.new(
940
+ :text)
941
+ SENSITIVE = []
942
+ include Aws::Structure
943
+ end
944
+
945
+ # @!attribute [rw] session_id
946
+ # Identifier of the session.
947
+ # @return [String]
948
+ #
949
+ # @!attribute [rw] input
950
+ # Customer input of the turn
951
+ # @return [Types::RetrieveAndGenerateInput]
952
+ #
953
+ # @!attribute [rw] retrieve_and_generate_configuration
954
+ # Configures the retrieval and generation for the session.
955
+ # @return [Types::RetrieveAndGenerateConfiguration]
956
+ #
957
+ # @!attribute [rw] session_configuration
958
+ # Configures common parameters of the session.
959
+ # @return [Types::RetrieveAndGenerateSessionConfiguration]
960
+ #
961
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrieveAndGenerateRequest AWS API Documentation
962
+ #
963
+ class RetrieveAndGenerateRequest < Struct.new(
964
+ :session_id,
965
+ :input,
966
+ :retrieve_and_generate_configuration,
967
+ :session_configuration)
968
+ SENSITIVE = [:input]
969
+ include Aws::Structure
970
+ end
971
+
972
+ # @!attribute [rw] session_id
973
+ # Identifier of the session.
974
+ # @return [String]
975
+ #
976
+ # @!attribute [rw] output
977
+ # Service response of the turn
978
+ # @return [Types::RetrieveAndGenerateOutput]
979
+ #
980
+ # @!attribute [rw] citations
981
+ # List of citations
982
+ # @return [Array<Types::Citation>]
983
+ #
984
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrieveAndGenerateResponse AWS API Documentation
985
+ #
986
+ class RetrieveAndGenerateResponse < Struct.new(
987
+ :session_id,
988
+ :output,
989
+ :citations)
990
+ SENSITIVE = [:output]
991
+ include Aws::Structure
992
+ end
993
+
994
+ # Configures common parameters of the session.
995
+ #
996
+ # @!attribute [rw] kms_key_arn
997
+ # The KMS key arn to encrypt the customer data of the session.
998
+ # @return [String]
999
+ #
1000
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrieveAndGenerateSessionConfiguration AWS API Documentation
1001
+ #
1002
+ class RetrieveAndGenerateSessionConfiguration < Struct.new(
1003
+ :kms_key_arn)
1004
+ SENSITIVE = []
1005
+ include Aws::Structure
1006
+ end
1007
+
1008
+ # @!attribute [rw] knowledge_base_id
1009
+ # Identifier of the KnowledgeBase
1010
+ # @return [String]
1011
+ #
1012
+ # @!attribute [rw] retrieval_query
1013
+ # Knowledge base input query.
1014
+ # @return [Types::KnowledgeBaseQuery]
1015
+ #
1016
+ # @!attribute [rw] retrieval_configuration
1017
+ # Search parameters for retrieving from knowledge base.
1018
+ # @return [Types::KnowledgeBaseRetrievalConfiguration]
1019
+ #
1020
+ # @!attribute [rw] next_token
1021
+ # Opaque continuation token of previous paginated response.
1022
+ # @return [String]
1023
+ #
1024
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrieveRequest AWS API Documentation
1025
+ #
1026
+ class RetrieveRequest < Struct.new(
1027
+ :knowledge_base_id,
1028
+ :retrieval_query,
1029
+ :retrieval_configuration,
1030
+ :next_token)
1031
+ SENSITIVE = [:retrieval_query]
1032
+ include Aws::Structure
1033
+ end
1034
+
1035
+ # @!attribute [rw] retrieval_results
1036
+ # List of knowledge base retrieval results
1037
+ # @return [Array<Types::KnowledgeBaseRetrievalResult>]
1038
+ #
1039
+ # @!attribute [rw] next_token
1040
+ # Opaque continuation token of previous paginated response.
1041
+ # @return [String]
1042
+ #
1043
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrieveResponse AWS API Documentation
1044
+ #
1045
+ class RetrieveResponse < Struct.new(
1046
+ :retrieval_results,
1047
+ :next_token)
1048
+ SENSITIVE = [:retrieval_results]
1049
+ include Aws::Structure
1050
+ end
1051
+
1052
+ # Retrieved reference
1053
+ #
1054
+ # @!attribute [rw] content
1055
+ # Content of a retrieval result.
1056
+ # @return [Types::RetrievalResultContent]
1057
+ #
1058
+ # @!attribute [rw] location
1059
+ # The source location of a retrieval result.
1060
+ # @return [Types::RetrievalResultLocation]
1061
+ #
1062
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/RetrievedReference AWS API Documentation
1063
+ #
1064
+ class RetrievedReference < Struct.new(
1065
+ :content,
1066
+ :location)
1067
+ SENSITIVE = []
1068
+ include Aws::Structure
1069
+ end
1070
+
1071
+ # This exception is thrown when a request is made beyond the service
1072
+ # quota
1073
+ #
1074
+ # @!attribute [rw] message
1075
+ # Non Blank String
1076
+ # @return [String]
1077
+ #
1078
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/ServiceQuotaExceededException AWS API Documentation
1079
+ #
1080
+ class ServiceQuotaExceededException < Struct.new(
1081
+ :message,
1082
+ :event_type)
1083
+ SENSITIVE = []
1084
+ include Aws::Structure
1085
+ end
1086
+
1087
+ # Session state provided
1088
+ #
1089
+ # @!attribute [rw] session_attributes
1090
+ # Session Attributes
1091
+ # @return [Hash<String,String>]
1092
+ #
1093
+ # @!attribute [rw] prompt_session_attributes
1094
+ # Prompt Session Attributes
1095
+ # @return [Hash<String,String>]
1096
+ #
1097
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/SessionState AWS API Documentation
1098
+ #
1099
+ class SessionState < Struct.new(
1100
+ :session_attributes,
1101
+ :prompt_session_attributes)
1102
+ SENSITIVE = []
1103
+ include Aws::Structure
1104
+ end
1105
+
1106
+ # Span of text
1107
+ #
1108
+ # @!attribute [rw] start
1109
+ # Start of span
1110
+ # @return [Integer]
1111
+ #
1112
+ # @!attribute [rw] end
1113
+ # End of span
1114
+ # @return [Integer]
1115
+ #
1116
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/Span AWS API Documentation
1117
+ #
1118
+ class Span < Struct.new(
1119
+ :start,
1120
+ :end)
1121
+ SENSITIVE = []
1122
+ include Aws::Structure
1123
+ end
1124
+
1125
+ # Text response part
1126
+ #
1127
+ # @!attribute [rw] text
1128
+ # Response part in text
1129
+ # @return [String]
1130
+ #
1131
+ # @!attribute [rw] span
1132
+ # Span of text
1133
+ # @return [Types::Span]
1134
+ #
1135
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/TextResponsePart AWS API Documentation
1136
+ #
1137
+ class TextResponsePart < Struct.new(
1138
+ :text,
1139
+ :span)
1140
+ SENSITIVE = []
1141
+ include Aws::Structure
1142
+ end
1143
+
1144
+ # This exception is thrown when the number of requests exceeds the limit
1145
+ #
1146
+ # @!attribute [rw] message
1147
+ # Non Blank String
1148
+ # @return [String]
1149
+ #
1150
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/ThrottlingException AWS API Documentation
1151
+ #
1152
+ class ThrottlingException < Struct.new(
1153
+ :message,
1154
+ :event_type)
1155
+ SENSITIVE = []
1156
+ include Aws::Structure
1157
+ end
1158
+
1159
+ # Trace contains intermidate response for customer
1160
+ #
1161
+ # @note Trace is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of Trace corresponding to the set member.
1162
+ #
1163
+ # @!attribute [rw] pre_processing_trace
1164
+ # Trace Part which contains information related to preprocessing step
1165
+ # @return [Types::PreProcessingTrace]
1166
+ #
1167
+ # @!attribute [rw] orchestration_trace
1168
+ # Trace contains intermidate response during orchestration
1169
+ # @return [Types::OrchestrationTrace]
1170
+ #
1171
+ # @!attribute [rw] post_processing_trace
1172
+ # Trace Part which contains information related to post processing
1173
+ # step
1174
+ # @return [Types::PostProcessingTrace]
1175
+ #
1176
+ # @!attribute [rw] failure_trace
1177
+ # Trace Part which is emitted when agent trace could not be generated
1178
+ # @return [Types::FailureTrace]
1179
+ #
1180
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/Trace AWS API Documentation
1181
+ #
1182
+ class Trace < Struct.new(
1183
+ :pre_processing_trace,
1184
+ :orchestration_trace,
1185
+ :post_processing_trace,
1186
+ :failure_trace,
1187
+ :unknown)
1188
+ SENSITIVE = [:pre_processing_trace, :orchestration_trace, :post_processing_trace, :failure_trace]
1189
+ include Aws::Structure
1190
+ include Aws::Structure::Union
1191
+
1192
+ class PreProcessingTrace < Trace; end
1193
+ class OrchestrationTrace < Trace; end
1194
+ class PostProcessingTrace < Trace; end
1195
+ class FailureTrace < Trace; end
1196
+ class Unknown < Trace; end
1197
+ end
1198
+
1199
+ # Trace Part which contains intermidate response for customer
1200
+ #
1201
+ # @!attribute [rw] agent_id
1202
+ # Identifier of the agent.
1203
+ # @return [String]
1204
+ #
1205
+ # @!attribute [rw] agent_alias_id
1206
+ # Identifier of the agent alias.
1207
+ # @return [String]
1208
+ #
1209
+ # @!attribute [rw] session_id
1210
+ # Identifier of the session.
1211
+ # @return [String]
1212
+ #
1213
+ # @!attribute [rw] trace
1214
+ # Trace contains intermidate response for customer
1215
+ # @return [Types::Trace]
1216
+ #
1217
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/TracePart AWS API Documentation
1218
+ #
1219
+ class TracePart < Struct.new(
1220
+ :agent_id,
1221
+ :agent_alias_id,
1222
+ :session_id,
1223
+ :trace,
1224
+ :event_type)
1225
+ SENSITIVE = [:trace]
1226
+ include Aws::Structure
1227
+ end
1228
+
1229
+ # This exception is thrown when the request's input validation fails
1230
+ #
1231
+ # @!attribute [rw] message
1232
+ # Non Blank String
1233
+ # @return [String]
1234
+ #
1235
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/ValidationException AWS API Documentation
1236
+ #
1237
+ class ValidationException < Struct.new(
1238
+ :message,
1239
+ :event_type)
1240
+ SENSITIVE = []
1241
+ include Aws::Structure
1242
+ end
1243
+
1244
+ # Response body of is a stream
1245
+ #
1246
+ # EventStream is an Enumerator of Events.
1247
+ # #event_types #=> Array, returns all modeled event types in the stream
1248
+ #
1249
+ # @see http://docs.aws.amazon.com/goto/WebAPI/bedrock-agent-runtime-2023-07-26/ResponseStream AWS API Documentation
1250
+ #
1251
+ class ResponseStream < Enumerator
1252
+
1253
+ def event_types
1254
+ [
1255
+ :chunk,
1256
+ :trace,
1257
+ :internal_server_exception,
1258
+ :validation_exception,
1259
+ :resource_not_found_exception,
1260
+ :service_quota_exceeded_exception,
1261
+ :throttling_exception,
1262
+ :access_denied_exception,
1263
+ :conflict_exception,
1264
+ :dependency_failed_exception,
1265
+ :bad_gateway_exception
1266
+ ]
1267
+ end
1268
+
1269
+ end
1270
+
1271
+ end
1272
+ end