qbusiness.d.ts 139 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640164116421643164416451646164716481649165016511652165316541655165616571658165916601661166216631664166516661667166816691670167116721673167416751676167716781679168016811682168316841685168616871688168916901691169216931694169516961697169816991700170117021703170417051706170717081709171017111712171317141715171617171718171917201721172217231724172517261727172817291730173117321733173417351736173717381739174017411742174317441745174617471748174917501751175217531754175517561757175817591760176117621763176417651766176717681769177017711772177317741775177617771778177917801781178217831784178517861787178817891790179117921793179417951796179717981799180018011802180318041805180618071808180918101811181218131814181518161817181818191820182118221823182418251826182718281829183018311832183318341835183618371838183918401841184218431844184518461847184818491850185118521853185418551856185718581859186018611862186318641865186618671868186918701871187218731874187518761877187818791880188118821883188418851886188718881889189018911892189318941895189618971898189919001901190219031904190519061907190819091910191119121913191419151916191719181919192019211922192319241925192619271928192919301931193219331934193519361937193819391940194119421943194419451946194719481949195019511952195319541955195619571958195919601961196219631964196519661967196819691970197119721973197419751976197719781979198019811982198319841985198619871988198919901991199219931994199519961997199819992000200120022003200420052006200720082009201020112012201320142015201620172018201920202021202220232024202520262027202820292030203120322033203420352036203720382039204020412042204320442045204620472048204920502051205220532054205520562057205820592060206120622063206420652066206720682069207020712072207320742075207620772078207920802081208220832084208520862087208820892090209120922093209420952096209720982099210021012102210321042105210621072108210921102111211221132114211521162117211821192120212121222123212421252126212721282129213021312132213321342135213621372138213921402141214221432144214521462147214821492150215121522153215421552156215721582159216021612162216321642165216621672168216921702171217221732174217521762177217821792180218121822183218421852186218721882189219021912192219321942195219621972198219922002201220222032204220522062207220822092210221122122213221422152216221722182219222022212222222322242225222622272228222922302231223222332234223522362237223822392240224122422243224422452246224722482249225022512252225322542255225622572258225922602261226222632264226522662267226822692270227122722273227422752276227722782279228022812282228322842285228622872288228922902291229222932294229522962297229822992300230123022303230423052306230723082309231023112312231323142315231623172318231923202321232223232324232523262327232823292330233123322333233423352336233723382339234023412342234323442345234623472348234923502351235223532354235523562357235823592360236123622363236423652366236723682369237023712372237323742375237623772378237923802381238223832384238523862387238823892390239123922393239423952396239723982399240024012402240324042405240624072408240924102411241224132414241524162417241824192420242124222423242424252426242724282429243024312432243324342435243624372438243924402441244224432444244524462447244824492450245124522453245424552456245724582459246024612462246324642465246624672468246924702471247224732474247524762477247824792480248124822483248424852486248724882489249024912492249324942495249624972498249925002501250225032504250525062507250825092510251125122513251425152516251725182519252025212522252325242525252625272528252925302531253225332534253525362537253825392540254125422543254425452546254725482549255025512552255325542555255625572558255925602561256225632564256525662567256825692570257125722573257425752576257725782579258025812582258325842585258625872588258925902591259225932594259525962597259825992600260126022603260426052606260726082609261026112612261326142615261626172618261926202621262226232624262526262627262826292630263126322633263426352636263726382639264026412642264326442645264626472648264926502651265226532654265526562657265826592660266126622663266426652666266726682669267026712672267326742675267626772678267926802681268226832684268526862687268826892690269126922693269426952696269726982699270027012702270327042705270627072708270927102711271227132714271527162717271827192720272127222723272427252726272727282729273027312732273327342735273627372738273927402741274227432744274527462747274827492750275127522753275427552756275727582759276027612762276327642765276627672768276927702771277227732774277527762777277827792780278127822783278427852786278727882789279027912792279327942795279627972798279928002801280228032804280528062807280828092810281128122813281428152816281728182819282028212822282328242825282628272828282928302831283228332834283528362837283828392840284128422843284428452846284728482849285028512852285328542855285628572858285928602861286228632864286528662867286828692870287128722873287428752876287728782879288028812882288328842885288628872888288928902891289228932894289528962897289828992900290129022903290429052906290729082909291029112912291329142915291629172918291929202921292229232924292529262927292829292930293129322933293429352936293729382939294029412942294329442945294629472948294929502951295229532954295529562957295829592960296129622963296429652966296729682969297029712972297329742975297629772978297929802981298229832984298529862987298829892990299129922993299429952996299729982999300030013002300330043005300630073008300930103011301230133014301530163017301830193020302130223023302430253026302730283029303030313032303330343035303630373038303930403041304230433044304530463047304830493050305130523053305430553056305730583059306030613062306330643065306630673068306930703071307230733074307530763077307830793080308130823083308430853086308730883089309030913092309330943095309630973098309931003101310231033104310531063107310831093110311131123113311431153116311731183119312031213122312331243125312631273128312931303131313231333134313531363137313831393140314131423143314431453146314731483149315031513152315331543155315631573158315931603161316231633164316531663167316831693170317131723173317431753176317731783179318031813182318331843185318631873188318931903191319231933194319531963197319831993200320132023203320432053206320732083209321032113212321332143215321632173218321932203221322232233224322532263227322832293230323132323233323432353236323732383239324032413242324332443245324632473248324932503251325232533254325532563257325832593260326132623263326432653266326732683269327032713272327332743275327632773278327932803281328232833284328532863287328832893290329132923293329432953296329732983299330033013302330333043305330633073308330933103311331233133314331533163317331833193320332133223323332433253326332733283329333033313332333333343335333633373338333933403341334233433344334533463347334833493350335133523353335433553356335733583359336033613362336333643365336633673368336933703371337233733374337533763377337833793380338133823383338433853386338733883389339033913392339333943395339633973398339934003401340234033404340534063407340834093410341134123413341434153416341734183419342034213422342334243425342634273428342934303431343234333434343534363437343834393440344134423443344434453446344734483449345034513452345334543455345634573458345934603461346234633464346534663467346834693470347134723473
  1. import {Request} from '../lib/request';
  2. import {Response} from '../lib/response';
  3. import {AWSError} from '../lib/error';
  4. import {Service} from '../lib/service';
  5. import {ServiceConfigurationOptions} from '../lib/service';
  6. import {ConfigBase as Config} from '../lib/config-base';
  7. interface Blob {}
  8. declare class QBusiness extends Service {
  9. /**
  10. * Constructs a service object. This object has one method for each API operation.
  11. */
  12. constructor(options?: QBusiness.Types.ClientConfiguration)
  13. config: Config & QBusiness.Types.ClientConfiguration;
  14. /**
  15. * Asynchronously deletes one or more documents added using the BatchPutDocument API from an Amazon Q Business index. You can see the progress of the deletion, and any error messages related to the process, by using CloudWatch.
  16. */
  17. batchDeleteDocument(params: QBusiness.Types.BatchDeleteDocumentRequest, callback?: (err: AWSError, data: QBusiness.Types.BatchDeleteDocumentResponse) => void): Request<QBusiness.Types.BatchDeleteDocumentResponse, AWSError>;
  18. /**
  19. * Asynchronously deletes one or more documents added using the BatchPutDocument API from an Amazon Q Business index. You can see the progress of the deletion, and any error messages related to the process, by using CloudWatch.
  20. */
  21. batchDeleteDocument(callback?: (err: AWSError, data: QBusiness.Types.BatchDeleteDocumentResponse) => void): Request<QBusiness.Types.BatchDeleteDocumentResponse, AWSError>;
  22. /**
  23. * Adds one or more documents to an Amazon Q Business index. You use this API to: ingest your structured and unstructured documents and documents stored in an Amazon S3 bucket into an Amazon Q Business index. add custom attributes to documents in an Amazon Q Business index. attach an access control list to the documents added to an Amazon Q Business index. You can see the progress of the deletion, and any error messages related to the process, by using CloudWatch.
  24. */
  25. batchPutDocument(params: QBusiness.Types.BatchPutDocumentRequest, callback?: (err: AWSError, data: QBusiness.Types.BatchPutDocumentResponse) => void): Request<QBusiness.Types.BatchPutDocumentResponse, AWSError>;
  26. /**
  27. * Adds one or more documents to an Amazon Q Business index. You use this API to: ingest your structured and unstructured documents and documents stored in an Amazon S3 bucket into an Amazon Q Business index. add custom attributes to documents in an Amazon Q Business index. attach an access control list to the documents added to an Amazon Q Business index. You can see the progress of the deletion, and any error messages related to the process, by using CloudWatch.
  28. */
  29. batchPutDocument(callback?: (err: AWSError, data: QBusiness.Types.BatchPutDocumentResponse) => void): Request<QBusiness.Types.BatchPutDocumentResponse, AWSError>;
  30. /**
  31. * Starts or continues a non-streaming Amazon Q Business conversation.
  32. */
  33. chatSync(params: QBusiness.Types.ChatSyncInput, callback?: (err: AWSError, data: QBusiness.Types.ChatSyncOutput) => void): Request<QBusiness.Types.ChatSyncOutput, AWSError>;
  34. /**
  35. * Starts or continues a non-streaming Amazon Q Business conversation.
  36. */
  37. chatSync(callback?: (err: AWSError, data: QBusiness.Types.ChatSyncOutput) => void): Request<QBusiness.Types.ChatSyncOutput, AWSError>;
  38. /**
  39. * Creates an Amazon Q Business application. There are new tiers for Amazon Q Business. Not all features in Amazon Q Business Pro are also available in Amazon Q Business Lite. For information on what's included in Amazon Q Business Lite and what's included in Amazon Q Business Pro, see Amazon Q Business tiers. You must use the Amazon Q Business console to assign subscription tiers to users.
  40. */
  41. createApplication(params: QBusiness.Types.CreateApplicationRequest, callback?: (err: AWSError, data: QBusiness.Types.CreateApplicationResponse) => void): Request<QBusiness.Types.CreateApplicationResponse, AWSError>;
  42. /**
  43. * Creates an Amazon Q Business application. There are new tiers for Amazon Q Business. Not all features in Amazon Q Business Pro are also available in Amazon Q Business Lite. For information on what's included in Amazon Q Business Lite and what's included in Amazon Q Business Pro, see Amazon Q Business tiers. You must use the Amazon Q Business console to assign subscription tiers to users.
  44. */
  45. createApplication(callback?: (err: AWSError, data: QBusiness.Types.CreateApplicationResponse) => void): Request<QBusiness.Types.CreateApplicationResponse, AWSError>;
  46. /**
  47. * Creates a data source connector for an Amazon Q Business application. CreateDataSource is a synchronous operation. The operation returns 200 if the data source was successfully created. Otherwise, an exception is raised.
  48. */
  49. createDataSource(params: QBusiness.Types.CreateDataSourceRequest, callback?: (err: AWSError, data: QBusiness.Types.CreateDataSourceResponse) => void): Request<QBusiness.Types.CreateDataSourceResponse, AWSError>;
  50. /**
  51. * Creates a data source connector for an Amazon Q Business application. CreateDataSource is a synchronous operation. The operation returns 200 if the data source was successfully created. Otherwise, an exception is raised.
  52. */
  53. createDataSource(callback?: (err: AWSError, data: QBusiness.Types.CreateDataSourceResponse) => void): Request<QBusiness.Types.CreateDataSourceResponse, AWSError>;
  54. /**
  55. * Creates an Amazon Q Business index. To determine if index creation has completed, check the Status field returned from a call to DescribeIndex. The Status field is set to ACTIVE when the index is ready to use. Once the index is active, you can index your documents using the BatchPutDocument API or the CreateDataSource API.
  56. */
  57. createIndex(params: QBusiness.Types.CreateIndexRequest, callback?: (err: AWSError, data: QBusiness.Types.CreateIndexResponse) => void): Request<QBusiness.Types.CreateIndexResponse, AWSError>;
  58. /**
  59. * Creates an Amazon Q Business index. To determine if index creation has completed, check the Status field returned from a call to DescribeIndex. The Status field is set to ACTIVE when the index is ready to use. Once the index is active, you can index your documents using the BatchPutDocument API or the CreateDataSource API.
  60. */
  61. createIndex(callback?: (err: AWSError, data: QBusiness.Types.CreateIndexResponse) => void): Request<QBusiness.Types.CreateIndexResponse, AWSError>;
  62. /**
  63. * Creates an Amazon Q Business plugin.
  64. */
  65. createPlugin(params: QBusiness.Types.CreatePluginRequest, callback?: (err: AWSError, data: QBusiness.Types.CreatePluginResponse) => void): Request<QBusiness.Types.CreatePluginResponse, AWSError>;
  66. /**
  67. * Creates an Amazon Q Business plugin.
  68. */
  69. createPlugin(callback?: (err: AWSError, data: QBusiness.Types.CreatePluginResponse) => void): Request<QBusiness.Types.CreatePluginResponse, AWSError>;
  70. /**
  71. * Adds a retriever to your Amazon Q Business application.
  72. */
  73. createRetriever(params: QBusiness.Types.CreateRetrieverRequest, callback?: (err: AWSError, data: QBusiness.Types.CreateRetrieverResponse) => void): Request<QBusiness.Types.CreateRetrieverResponse, AWSError>;
  74. /**
  75. * Adds a retriever to your Amazon Q Business application.
  76. */
  77. createRetriever(callback?: (err: AWSError, data: QBusiness.Types.CreateRetrieverResponse) => void): Request<QBusiness.Types.CreateRetrieverResponse, AWSError>;
  78. /**
  79. * Creates a universally unique identifier (UUID) mapped to a list of local user ids within an application.
  80. */
  81. createUser(params: QBusiness.Types.CreateUserRequest, callback?: (err: AWSError, data: QBusiness.Types.CreateUserResponse) => void): Request<QBusiness.Types.CreateUserResponse, AWSError>;
  82. /**
  83. * Creates a universally unique identifier (UUID) mapped to a list of local user ids within an application.
  84. */
  85. createUser(callback?: (err: AWSError, data: QBusiness.Types.CreateUserResponse) => void): Request<QBusiness.Types.CreateUserResponse, AWSError>;
  86. /**
  87. * Creates an Amazon Q Business web experience.
  88. */
  89. createWebExperience(params: QBusiness.Types.CreateWebExperienceRequest, callback?: (err: AWSError, data: QBusiness.Types.CreateWebExperienceResponse) => void): Request<QBusiness.Types.CreateWebExperienceResponse, AWSError>;
  90. /**
  91. * Creates an Amazon Q Business web experience.
  92. */
  93. createWebExperience(callback?: (err: AWSError, data: QBusiness.Types.CreateWebExperienceResponse) => void): Request<QBusiness.Types.CreateWebExperienceResponse, AWSError>;
  94. /**
  95. * Deletes an Amazon Q Business application.
  96. */
  97. deleteApplication(params: QBusiness.Types.DeleteApplicationRequest, callback?: (err: AWSError, data: QBusiness.Types.DeleteApplicationResponse) => void): Request<QBusiness.Types.DeleteApplicationResponse, AWSError>;
  98. /**
  99. * Deletes an Amazon Q Business application.
  100. */
  101. deleteApplication(callback?: (err: AWSError, data: QBusiness.Types.DeleteApplicationResponse) => void): Request<QBusiness.Types.DeleteApplicationResponse, AWSError>;
  102. /**
  103. * Deletes chat controls configured for an existing Amazon Q Business application.
  104. */
  105. deleteChatControlsConfiguration(params: QBusiness.Types.DeleteChatControlsConfigurationRequest, callback?: (err: AWSError, data: QBusiness.Types.DeleteChatControlsConfigurationResponse) => void): Request<QBusiness.Types.DeleteChatControlsConfigurationResponse, AWSError>;
  106. /**
  107. * Deletes chat controls configured for an existing Amazon Q Business application.
  108. */
  109. deleteChatControlsConfiguration(callback?: (err: AWSError, data: QBusiness.Types.DeleteChatControlsConfigurationResponse) => void): Request<QBusiness.Types.DeleteChatControlsConfigurationResponse, AWSError>;
  110. /**
  111. * Deletes an Amazon Q Business web experience conversation.
  112. */
  113. deleteConversation(params: QBusiness.Types.DeleteConversationRequest, callback?: (err: AWSError, data: QBusiness.Types.DeleteConversationResponse) => void): Request<QBusiness.Types.DeleteConversationResponse, AWSError>;
  114. /**
  115. * Deletes an Amazon Q Business web experience conversation.
  116. */
  117. deleteConversation(callback?: (err: AWSError, data: QBusiness.Types.DeleteConversationResponse) => void): Request<QBusiness.Types.DeleteConversationResponse, AWSError>;
  118. /**
  119. * Deletes an Amazon Q Business data source connector. While the data source is being deleted, the Status field returned by a call to the DescribeDataSource API is set to DELETING.
  120. */
  121. deleteDataSource(params: QBusiness.Types.DeleteDataSourceRequest, callback?: (err: AWSError, data: QBusiness.Types.DeleteDataSourceResponse) => void): Request<QBusiness.Types.DeleteDataSourceResponse, AWSError>;
  122. /**
  123. * Deletes an Amazon Q Business data source connector. While the data source is being deleted, the Status field returned by a call to the DescribeDataSource API is set to DELETING.
  124. */
  125. deleteDataSource(callback?: (err: AWSError, data: QBusiness.Types.DeleteDataSourceResponse) => void): Request<QBusiness.Types.DeleteDataSourceResponse, AWSError>;
  126. /**
  127. * Deletes a group so that all users and sub groups that belong to the group can no longer access documents only available to that group. For example, after deleting the group "Summer Interns", all interns who belonged to that group no longer see intern-only documents in their chat results. If you want to delete, update, or replace users or sub groups of a group, you need to use the PutGroup operation. For example, if a user in the group "Engineering" leaves the engineering team and another user takes their place, you provide an updated list of users or sub groups that belong to the "Engineering" group when calling PutGroup.
  128. */
  129. deleteGroup(params: QBusiness.Types.DeleteGroupRequest, callback?: (err: AWSError, data: QBusiness.Types.DeleteGroupResponse) => void): Request<QBusiness.Types.DeleteGroupResponse, AWSError>;
  130. /**
  131. * Deletes a group so that all users and sub groups that belong to the group can no longer access documents only available to that group. For example, after deleting the group "Summer Interns", all interns who belonged to that group no longer see intern-only documents in their chat results. If you want to delete, update, or replace users or sub groups of a group, you need to use the PutGroup operation. For example, if a user in the group "Engineering" leaves the engineering team and another user takes their place, you provide an updated list of users or sub groups that belong to the "Engineering" group when calling PutGroup.
  132. */
  133. deleteGroup(callback?: (err: AWSError, data: QBusiness.Types.DeleteGroupResponse) => void): Request<QBusiness.Types.DeleteGroupResponse, AWSError>;
  134. /**
  135. * Deletes an Amazon Q Business index.
  136. */
  137. deleteIndex(params: QBusiness.Types.DeleteIndexRequest, callback?: (err: AWSError, data: QBusiness.Types.DeleteIndexResponse) => void): Request<QBusiness.Types.DeleteIndexResponse, AWSError>;
  138. /**
  139. * Deletes an Amazon Q Business index.
  140. */
  141. deleteIndex(callback?: (err: AWSError, data: QBusiness.Types.DeleteIndexResponse) => void): Request<QBusiness.Types.DeleteIndexResponse, AWSError>;
  142. /**
  143. * Deletes an Amazon Q Business plugin.
  144. */
  145. deletePlugin(params: QBusiness.Types.DeletePluginRequest, callback?: (err: AWSError, data: QBusiness.Types.DeletePluginResponse) => void): Request<QBusiness.Types.DeletePluginResponse, AWSError>;
  146. /**
  147. * Deletes an Amazon Q Business plugin.
  148. */
  149. deletePlugin(callback?: (err: AWSError, data: QBusiness.Types.DeletePluginResponse) => void): Request<QBusiness.Types.DeletePluginResponse, AWSError>;
  150. /**
  151. * Deletes the retriever used by an Amazon Q Business application.
  152. */
  153. deleteRetriever(params: QBusiness.Types.DeleteRetrieverRequest, callback?: (err: AWSError, data: QBusiness.Types.DeleteRetrieverResponse) => void): Request<QBusiness.Types.DeleteRetrieverResponse, AWSError>;
  154. /**
  155. * Deletes the retriever used by an Amazon Q Business application.
  156. */
  157. deleteRetriever(callback?: (err: AWSError, data: QBusiness.Types.DeleteRetrieverResponse) => void): Request<QBusiness.Types.DeleteRetrieverResponse, AWSError>;
  158. /**
  159. * Deletes a user by email id.
  160. */
  161. deleteUser(params: QBusiness.Types.DeleteUserRequest, callback?: (err: AWSError, data: QBusiness.Types.DeleteUserResponse) => void): Request<QBusiness.Types.DeleteUserResponse, AWSError>;
  162. /**
  163. * Deletes a user by email id.
  164. */
  165. deleteUser(callback?: (err: AWSError, data: QBusiness.Types.DeleteUserResponse) => void): Request<QBusiness.Types.DeleteUserResponse, AWSError>;
  166. /**
  167. * Deletes an Amazon Q Business web experience.
  168. */
  169. deleteWebExperience(params: QBusiness.Types.DeleteWebExperienceRequest, callback?: (err: AWSError, data: QBusiness.Types.DeleteWebExperienceResponse) => void): Request<QBusiness.Types.DeleteWebExperienceResponse, AWSError>;
  170. /**
  171. * Deletes an Amazon Q Business web experience.
  172. */
  173. deleteWebExperience(callback?: (err: AWSError, data: QBusiness.Types.DeleteWebExperienceResponse) => void): Request<QBusiness.Types.DeleteWebExperienceResponse, AWSError>;
  174. /**
  175. * Gets information about an existing Amazon Q Business application.
  176. */
  177. getApplication(params: QBusiness.Types.GetApplicationRequest, callback?: (err: AWSError, data: QBusiness.Types.GetApplicationResponse) => void): Request<QBusiness.Types.GetApplicationResponse, AWSError>;
  178. /**
  179. * Gets information about an existing Amazon Q Business application.
  180. */
  181. getApplication(callback?: (err: AWSError, data: QBusiness.Types.GetApplicationResponse) => void): Request<QBusiness.Types.GetApplicationResponse, AWSError>;
  182. /**
  183. * Gets information about an chat controls configured for an existing Amazon Q Business application.
  184. */
  185. getChatControlsConfiguration(params: QBusiness.Types.GetChatControlsConfigurationRequest, callback?: (err: AWSError, data: QBusiness.Types.GetChatControlsConfigurationResponse) => void): Request<QBusiness.Types.GetChatControlsConfigurationResponse, AWSError>;
  186. /**
  187. * Gets information about an chat controls configured for an existing Amazon Q Business application.
  188. */
  189. getChatControlsConfiguration(callback?: (err: AWSError, data: QBusiness.Types.GetChatControlsConfigurationResponse) => void): Request<QBusiness.Types.GetChatControlsConfigurationResponse, AWSError>;
  190. /**
  191. * Gets information about an existing Amazon Q Business data source connector.
  192. */
  193. getDataSource(params: QBusiness.Types.GetDataSourceRequest, callback?: (err: AWSError, data: QBusiness.Types.GetDataSourceResponse) => void): Request<QBusiness.Types.GetDataSourceResponse, AWSError>;
  194. /**
  195. * Gets information about an existing Amazon Q Business data source connector.
  196. */
  197. getDataSource(callback?: (err: AWSError, data: QBusiness.Types.GetDataSourceResponse) => void): Request<QBusiness.Types.GetDataSourceResponse, AWSError>;
  198. /**
  199. * Describes a group by group name.
  200. */
  201. getGroup(params: QBusiness.Types.GetGroupRequest, callback?: (err: AWSError, data: QBusiness.Types.GetGroupResponse) => void): Request<QBusiness.Types.GetGroupResponse, AWSError>;
  202. /**
  203. * Describes a group by group name.
  204. */
  205. getGroup(callback?: (err: AWSError, data: QBusiness.Types.GetGroupResponse) => void): Request<QBusiness.Types.GetGroupResponse, AWSError>;
  206. /**
  207. * Gets information about an existing Amazon Q Business index.
  208. */
  209. getIndex(params: QBusiness.Types.GetIndexRequest, callback?: (err: AWSError, data: QBusiness.Types.GetIndexResponse) => void): Request<QBusiness.Types.GetIndexResponse, AWSError>;
  210. /**
  211. * Gets information about an existing Amazon Q Business index.
  212. */
  213. getIndex(callback?: (err: AWSError, data: QBusiness.Types.GetIndexResponse) => void): Request<QBusiness.Types.GetIndexResponse, AWSError>;
  214. /**
  215. * Gets information about an existing Amazon Q Business plugin.
  216. */
  217. getPlugin(params: QBusiness.Types.GetPluginRequest, callback?: (err: AWSError, data: QBusiness.Types.GetPluginResponse) => void): Request<QBusiness.Types.GetPluginResponse, AWSError>;
  218. /**
  219. * Gets information about an existing Amazon Q Business plugin.
  220. */
  221. getPlugin(callback?: (err: AWSError, data: QBusiness.Types.GetPluginResponse) => void): Request<QBusiness.Types.GetPluginResponse, AWSError>;
  222. /**
  223. * Gets information about an existing retriever used by an Amazon Q Business application.
  224. */
  225. getRetriever(params: QBusiness.Types.GetRetrieverRequest, callback?: (err: AWSError, data: QBusiness.Types.GetRetrieverResponse) => void): Request<QBusiness.Types.GetRetrieverResponse, AWSError>;
  226. /**
  227. * Gets information about an existing retriever used by an Amazon Q Business application.
  228. */
  229. getRetriever(callback?: (err: AWSError, data: QBusiness.Types.GetRetrieverResponse) => void): Request<QBusiness.Types.GetRetrieverResponse, AWSError>;
  230. /**
  231. * Describes the universally unique identifier (UUID) associated with a local user in a data source.
  232. */
  233. getUser(params: QBusiness.Types.GetUserRequest, callback?: (err: AWSError, data: QBusiness.Types.GetUserResponse) => void): Request<QBusiness.Types.GetUserResponse, AWSError>;
  234. /**
  235. * Describes the universally unique identifier (UUID) associated with a local user in a data source.
  236. */
  237. getUser(callback?: (err: AWSError, data: QBusiness.Types.GetUserResponse) => void): Request<QBusiness.Types.GetUserResponse, AWSError>;
  238. /**
  239. * Gets information about an existing Amazon Q Business web experience.
  240. */
  241. getWebExperience(params: QBusiness.Types.GetWebExperienceRequest, callback?: (err: AWSError, data: QBusiness.Types.GetWebExperienceResponse) => void): Request<QBusiness.Types.GetWebExperienceResponse, AWSError>;
  242. /**
  243. * Gets information about an existing Amazon Q Business web experience.
  244. */
  245. getWebExperience(callback?: (err: AWSError, data: QBusiness.Types.GetWebExperienceResponse) => void): Request<QBusiness.Types.GetWebExperienceResponse, AWSError>;
  246. /**
  247. * Lists Amazon Q Business applications.
  248. */
  249. listApplications(params: QBusiness.Types.ListApplicationsRequest, callback?: (err: AWSError, data: QBusiness.Types.ListApplicationsResponse) => void): Request<QBusiness.Types.ListApplicationsResponse, AWSError>;
  250. /**
  251. * Lists Amazon Q Business applications.
  252. */
  253. listApplications(callback?: (err: AWSError, data: QBusiness.Types.ListApplicationsResponse) => void): Request<QBusiness.Types.ListApplicationsResponse, AWSError>;
  254. /**
  255. * Lists one or more Amazon Q Business conversations.
  256. */
  257. listConversations(params: QBusiness.Types.ListConversationsRequest, callback?: (err: AWSError, data: QBusiness.Types.ListConversationsResponse) => void): Request<QBusiness.Types.ListConversationsResponse, AWSError>;
  258. /**
  259. * Lists one or more Amazon Q Business conversations.
  260. */
  261. listConversations(callback?: (err: AWSError, data: QBusiness.Types.ListConversationsResponse) => void): Request<QBusiness.Types.ListConversationsResponse, AWSError>;
  262. /**
  263. * Get information about an Amazon Q Business data source connector synchronization.
  264. */
  265. listDataSourceSyncJobs(params: QBusiness.Types.ListDataSourceSyncJobsRequest, callback?: (err: AWSError, data: QBusiness.Types.ListDataSourceSyncJobsResponse) => void): Request<QBusiness.Types.ListDataSourceSyncJobsResponse, AWSError>;
  266. /**
  267. * Get information about an Amazon Q Business data source connector synchronization.
  268. */
  269. listDataSourceSyncJobs(callback?: (err: AWSError, data: QBusiness.Types.ListDataSourceSyncJobsResponse) => void): Request<QBusiness.Types.ListDataSourceSyncJobsResponse, AWSError>;
  270. /**
  271. * Lists the Amazon Q Business data source connectors that you have created.
  272. */
  273. listDataSources(params: QBusiness.Types.ListDataSourcesRequest, callback?: (err: AWSError, data: QBusiness.Types.ListDataSourcesResponse) => void): Request<QBusiness.Types.ListDataSourcesResponse, AWSError>;
  274. /**
  275. * Lists the Amazon Q Business data source connectors that you have created.
  276. */
  277. listDataSources(callback?: (err: AWSError, data: QBusiness.Types.ListDataSourcesResponse) => void): Request<QBusiness.Types.ListDataSourcesResponse, AWSError>;
  278. /**
  279. * A list of documents attached to an index.
  280. */
  281. listDocuments(params: QBusiness.Types.ListDocumentsRequest, callback?: (err: AWSError, data: QBusiness.Types.ListDocumentsResponse) => void): Request<QBusiness.Types.ListDocumentsResponse, AWSError>;
  282. /**
  283. * A list of documents attached to an index.
  284. */
  285. listDocuments(callback?: (err: AWSError, data: QBusiness.Types.ListDocumentsResponse) => void): Request<QBusiness.Types.ListDocumentsResponse, AWSError>;
  286. /**
  287. * Provides a list of groups that are mapped to users.
  288. */
  289. listGroups(params: QBusiness.Types.ListGroupsRequest, callback?: (err: AWSError, data: QBusiness.Types.ListGroupsResponse) => void): Request<QBusiness.Types.ListGroupsResponse, AWSError>;
  290. /**
  291. * Provides a list of groups that are mapped to users.
  292. */
  293. listGroups(callback?: (err: AWSError, data: QBusiness.Types.ListGroupsResponse) => void): Request<QBusiness.Types.ListGroupsResponse, AWSError>;
  294. /**
  295. * Lists the Amazon Q Business indices you have created.
  296. */
  297. listIndices(params: QBusiness.Types.ListIndicesRequest, callback?: (err: AWSError, data: QBusiness.Types.ListIndicesResponse) => void): Request<QBusiness.Types.ListIndicesResponse, AWSError>;
  298. /**
  299. * Lists the Amazon Q Business indices you have created.
  300. */
  301. listIndices(callback?: (err: AWSError, data: QBusiness.Types.ListIndicesResponse) => void): Request<QBusiness.Types.ListIndicesResponse, AWSError>;
  302. /**
  303. * Gets a list of messages associated with an Amazon Q Business web experience.
  304. */
  305. listMessages(params: QBusiness.Types.ListMessagesRequest, callback?: (err: AWSError, data: QBusiness.Types.ListMessagesResponse) => void): Request<QBusiness.Types.ListMessagesResponse, AWSError>;
  306. /**
  307. * Gets a list of messages associated with an Amazon Q Business web experience.
  308. */
  309. listMessages(callback?: (err: AWSError, data: QBusiness.Types.ListMessagesResponse) => void): Request<QBusiness.Types.ListMessagesResponse, AWSError>;
  310. /**
  311. * Lists configured Amazon Q Business plugins.
  312. */
  313. listPlugins(params: QBusiness.Types.ListPluginsRequest, callback?: (err: AWSError, data: QBusiness.Types.ListPluginsResponse) => void): Request<QBusiness.Types.ListPluginsResponse, AWSError>;
  314. /**
  315. * Lists configured Amazon Q Business plugins.
  316. */
  317. listPlugins(callback?: (err: AWSError, data: QBusiness.Types.ListPluginsResponse) => void): Request<QBusiness.Types.ListPluginsResponse, AWSError>;
  318. /**
  319. * Lists the retriever used by an Amazon Q Business application.
  320. */
  321. listRetrievers(params: QBusiness.Types.ListRetrieversRequest, callback?: (err: AWSError, data: QBusiness.Types.ListRetrieversResponse) => void): Request<QBusiness.Types.ListRetrieversResponse, AWSError>;
  322. /**
  323. * Lists the retriever used by an Amazon Q Business application.
  324. */
  325. listRetrievers(callback?: (err: AWSError, data: QBusiness.Types.ListRetrieversResponse) => void): Request<QBusiness.Types.ListRetrieversResponse, AWSError>;
  326. /**
  327. * Gets a list of tags associated with a specified resource. Amazon Q Business applications and data sources can have tags associated with them.
  328. */
  329. listTagsForResource(params: QBusiness.Types.ListTagsForResourceRequest, callback?: (err: AWSError, data: QBusiness.Types.ListTagsForResourceResponse) => void): Request<QBusiness.Types.ListTagsForResourceResponse, AWSError>;
  330. /**
  331. * Gets a list of tags associated with a specified resource. Amazon Q Business applications and data sources can have tags associated with them.
  332. */
  333. listTagsForResource(callback?: (err: AWSError, data: QBusiness.Types.ListTagsForResourceResponse) => void): Request<QBusiness.Types.ListTagsForResourceResponse, AWSError>;
  334. /**
  335. * Lists one or more Amazon Q Business Web Experiences.
  336. */
  337. listWebExperiences(params: QBusiness.Types.ListWebExperiencesRequest, callback?: (err: AWSError, data: QBusiness.Types.ListWebExperiencesResponse) => void): Request<QBusiness.Types.ListWebExperiencesResponse, AWSError>;
  338. /**
  339. * Lists one or more Amazon Q Business Web Experiences.
  340. */
  341. listWebExperiences(callback?: (err: AWSError, data: QBusiness.Types.ListWebExperiencesResponse) => void): Request<QBusiness.Types.ListWebExperiencesResponse, AWSError>;
  342. /**
  343. * Enables your end user to provide feedback on their Amazon Q Business generated chat responses.
  344. */
  345. putFeedback(params: QBusiness.Types.PutFeedbackRequest, callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
  346. /**
  347. * Enables your end user to provide feedback on their Amazon Q Business generated chat responses.
  348. */
  349. putFeedback(callback?: (err: AWSError, data: {}) => void): Request<{}, AWSError>;
  350. /**
  351. * Create, or updates, a mapping of users—who have access to a document—to groups. You can also map sub groups to groups. For example, the group "Company Intellectual Property Teams" includes sub groups "Research" and "Engineering". These sub groups include their own list of users or people who work in these teams. Only users who work in research and engineering, and therefore belong in the intellectual property group, can see top-secret company documents in their Amazon Q Business chat results.
  352. */
  353. putGroup(params: QBusiness.Types.PutGroupRequest, callback?: (err: AWSError, data: QBusiness.Types.PutGroupResponse) => void): Request<QBusiness.Types.PutGroupResponse, AWSError>;
  354. /**
  355. * Create, or updates, a mapping of users—who have access to a document—to groups. You can also map sub groups to groups. For example, the group "Company Intellectual Property Teams" includes sub groups "Research" and "Engineering". These sub groups include their own list of users or people who work in these teams. Only users who work in research and engineering, and therefore belong in the intellectual property group, can see top-secret company documents in their Amazon Q Business chat results.
  356. */
  357. putGroup(callback?: (err: AWSError, data: QBusiness.Types.PutGroupResponse) => void): Request<QBusiness.Types.PutGroupResponse, AWSError>;
  358. /**
  359. * Starts a data source connector synchronization job. If a synchronization job is already in progress, Amazon Q Business returns a ConflictException.
  360. */
  361. startDataSourceSyncJob(params: QBusiness.Types.StartDataSourceSyncJobRequest, callback?: (err: AWSError, data: QBusiness.Types.StartDataSourceSyncJobResponse) => void): Request<QBusiness.Types.StartDataSourceSyncJobResponse, AWSError>;
  362. /**
  363. * Starts a data source connector synchronization job. If a synchronization job is already in progress, Amazon Q Business returns a ConflictException.
  364. */
  365. startDataSourceSyncJob(callback?: (err: AWSError, data: QBusiness.Types.StartDataSourceSyncJobResponse) => void): Request<QBusiness.Types.StartDataSourceSyncJobResponse, AWSError>;
  366. /**
  367. * Stops an Amazon Q Business data source connector synchronization job already in progress.
  368. */
  369. stopDataSourceSyncJob(params: QBusiness.Types.StopDataSourceSyncJobRequest, callback?: (err: AWSError, data: QBusiness.Types.StopDataSourceSyncJobResponse) => void): Request<QBusiness.Types.StopDataSourceSyncJobResponse, AWSError>;
  370. /**
  371. * Stops an Amazon Q Business data source connector synchronization job already in progress.
  372. */
  373. stopDataSourceSyncJob(callback?: (err: AWSError, data: QBusiness.Types.StopDataSourceSyncJobResponse) => void): Request<QBusiness.Types.StopDataSourceSyncJobResponse, AWSError>;
  374. /**
  375. * Adds the specified tag to the specified Amazon Q Business application or data source resource. If the tag already exists, the existing value is replaced with the new value.
  376. */
  377. tagResource(params: QBusiness.Types.TagResourceRequest, callback?: (err: AWSError, data: QBusiness.Types.TagResourceResponse) => void): Request<QBusiness.Types.TagResourceResponse, AWSError>;
  378. /**
  379. * Adds the specified tag to the specified Amazon Q Business application or data source resource. If the tag already exists, the existing value is replaced with the new value.
  380. */
  381. tagResource(callback?: (err: AWSError, data: QBusiness.Types.TagResourceResponse) => void): Request<QBusiness.Types.TagResourceResponse, AWSError>;
  382. /**
  383. * Removes a tag from an Amazon Q Business application or a data source.
  384. */
  385. untagResource(params: QBusiness.Types.UntagResourceRequest, callback?: (err: AWSError, data: QBusiness.Types.UntagResourceResponse) => void): Request<QBusiness.Types.UntagResourceResponse, AWSError>;
  386. /**
  387. * Removes a tag from an Amazon Q Business application or a data source.
  388. */
  389. untagResource(callback?: (err: AWSError, data: QBusiness.Types.UntagResourceResponse) => void): Request<QBusiness.Types.UntagResourceResponse, AWSError>;
  390. /**
  391. * Updates an existing Amazon Q Business application.
  392. */
  393. updateApplication(params: QBusiness.Types.UpdateApplicationRequest, callback?: (err: AWSError, data: QBusiness.Types.UpdateApplicationResponse) => void): Request<QBusiness.Types.UpdateApplicationResponse, AWSError>;
  394. /**
  395. * Updates an existing Amazon Q Business application.
  396. */
  397. updateApplication(callback?: (err: AWSError, data: QBusiness.Types.UpdateApplicationResponse) => void): Request<QBusiness.Types.UpdateApplicationResponse, AWSError>;
  398. /**
  399. * Updates an set of chat controls configured for an existing Amazon Q Business application.
  400. */
  401. updateChatControlsConfiguration(params: QBusiness.Types.UpdateChatControlsConfigurationRequest, callback?: (err: AWSError, data: QBusiness.Types.UpdateChatControlsConfigurationResponse) => void): Request<QBusiness.Types.UpdateChatControlsConfigurationResponse, AWSError>;
  402. /**
  403. * Updates an set of chat controls configured for an existing Amazon Q Business application.
  404. */
  405. updateChatControlsConfiguration(callback?: (err: AWSError, data: QBusiness.Types.UpdateChatControlsConfigurationResponse) => void): Request<QBusiness.Types.UpdateChatControlsConfigurationResponse, AWSError>;
  406. /**
  407. * Updates an existing Amazon Q Business data source connector.
  408. */
  409. updateDataSource(params: QBusiness.Types.UpdateDataSourceRequest, callback?: (err: AWSError, data: QBusiness.Types.UpdateDataSourceResponse) => void): Request<QBusiness.Types.UpdateDataSourceResponse, AWSError>;
  410. /**
  411. * Updates an existing Amazon Q Business data source connector.
  412. */
  413. updateDataSource(callback?: (err: AWSError, data: QBusiness.Types.UpdateDataSourceResponse) => void): Request<QBusiness.Types.UpdateDataSourceResponse, AWSError>;
  414. /**
  415. * Updates an Amazon Q Business index.
  416. */
  417. updateIndex(params: QBusiness.Types.UpdateIndexRequest, callback?: (err: AWSError, data: QBusiness.Types.UpdateIndexResponse) => void): Request<QBusiness.Types.UpdateIndexResponse, AWSError>;
  418. /**
  419. * Updates an Amazon Q Business index.
  420. */
  421. updateIndex(callback?: (err: AWSError, data: QBusiness.Types.UpdateIndexResponse) => void): Request<QBusiness.Types.UpdateIndexResponse, AWSError>;
  422. /**
  423. * Updates an Amazon Q Business plugin.
  424. */
  425. updatePlugin(params: QBusiness.Types.UpdatePluginRequest, callback?: (err: AWSError, data: QBusiness.Types.UpdatePluginResponse) => void): Request<QBusiness.Types.UpdatePluginResponse, AWSError>;
  426. /**
  427. * Updates an Amazon Q Business plugin.
  428. */
  429. updatePlugin(callback?: (err: AWSError, data: QBusiness.Types.UpdatePluginResponse) => void): Request<QBusiness.Types.UpdatePluginResponse, AWSError>;
  430. /**
  431. * Updates the retriever used for your Amazon Q Business application.
  432. */
  433. updateRetriever(params: QBusiness.Types.UpdateRetrieverRequest, callback?: (err: AWSError, data: QBusiness.Types.UpdateRetrieverResponse) => void): Request<QBusiness.Types.UpdateRetrieverResponse, AWSError>;
  434. /**
  435. * Updates the retriever used for your Amazon Q Business application.
  436. */
  437. updateRetriever(callback?: (err: AWSError, data: QBusiness.Types.UpdateRetrieverResponse) => void): Request<QBusiness.Types.UpdateRetrieverResponse, AWSError>;
  438. /**
  439. * Updates a information associated with a user id.
  440. */
  441. updateUser(params: QBusiness.Types.UpdateUserRequest, callback?: (err: AWSError, data: QBusiness.Types.UpdateUserResponse) => void): Request<QBusiness.Types.UpdateUserResponse, AWSError>;
  442. /**
  443. * Updates a information associated with a user id.
  444. */
  445. updateUser(callback?: (err: AWSError, data: QBusiness.Types.UpdateUserResponse) => void): Request<QBusiness.Types.UpdateUserResponse, AWSError>;
  446. /**
  447. * Updates an Amazon Q Business web experience.
  448. */
  449. updateWebExperience(params: QBusiness.Types.UpdateWebExperienceRequest, callback?: (err: AWSError, data: QBusiness.Types.UpdateWebExperienceResponse) => void): Request<QBusiness.Types.UpdateWebExperienceResponse, AWSError>;
  450. /**
  451. * Updates an Amazon Q Business web experience.
  452. */
  453. updateWebExperience(callback?: (err: AWSError, data: QBusiness.Types.UpdateWebExperienceResponse) => void): Request<QBusiness.Types.UpdateWebExperienceResponse, AWSError>;
  454. }
  455. declare namespace QBusiness {
  456. export interface APISchema {
  457. /**
  458. * The JSON or YAML-formatted payload defining the OpenAPI schema for a custom plugin.
  459. */
  460. payload?: Payload;
  461. /**
  462. * Contains details about the S3 object containing the OpenAPI schema for a custom plugin. The schema could be in either JSON or YAML format.
  463. */
  464. s3?: S3;
  465. }
  466. export type APISchemaType = "OPEN_API_V3"|string;
  467. export interface AccessConfiguration {
  468. /**
  469. * A list of AccessControlList objects.
  470. */
  471. accessControls: AccessControls;
  472. /**
  473. * Describes the member relation within the AccessControlList object.
  474. */
  475. memberRelation?: MemberRelation;
  476. }
  477. export interface AccessControl {
  478. /**
  479. * Contains a list of principals, where a principal can be either a USER or a GROUP. Each principal can be have the following type of document access: ALLOW or DENY.
  480. */
  481. principals: Principals;
  482. /**
  483. * Describes the member relation within a principal list.
  484. */
  485. memberRelation?: MemberRelation;
  486. }
  487. export type AccessControls = AccessControl[];
  488. export interface ActionExecution {
  489. /**
  490. * The identifier of the plugin the action is attached to.
  491. */
  492. pluginId: PluginId;
  493. /**
  494. * A mapping of field names to the field values in input that an end user provides to Amazon Q Business requests to perform their plugin action.
  495. */
  496. payload: ActionExecutionPayload;
  497. /**
  498. * A string used to retain information about the hierarchical contexts within an action execution event payload.
  499. */
  500. payloadFieldNameSeparator: ActionPayloadFieldNameSeparator;
  501. }
  502. export type ActionExecutionPayload = {[key: string]: ActionExecutionPayloadField};
  503. export interface ActionExecutionPayloadField {
  504. /**
  505. * The content of a user input field in an plugin action execution payload.
  506. */
  507. value: ActionPayloadFieldValue;
  508. }
  509. export type ActionPayloadFieldKey = string;
  510. export type ActionPayloadFieldNameSeparator = string;
  511. export type ActionPayloadFieldType = "STRING"|"NUMBER"|"ARRAY"|"BOOLEAN"|string;
  512. export interface ActionPayloadFieldValue {
  513. }
  514. export interface ActionReview {
  515. /**
  516. * The identifier of the plugin associated with the action review.
  517. */
  518. pluginId?: PluginId;
  519. /**
  520. * The type of plugin.
  521. */
  522. pluginType?: PluginType;
  523. /**
  524. * Field values that an end user needs to provide to Amazon Q Business for Amazon Q Business to perform the requested plugin action.
  525. */
  526. payload?: ActionReviewPayload;
  527. /**
  528. * A string used to retain information about the hierarchical contexts within an action review payload.
  529. */
  530. payloadFieldNameSeparator?: ActionPayloadFieldNameSeparator;
  531. }
  532. export type ActionReviewPayload = {[key: string]: ActionReviewPayloadField};
  533. export interface ActionReviewPayloadField {
  534. /**
  535. * The name of the field.
  536. */
  537. displayName?: String;
  538. /**
  539. * The display order of fields in a payload.
  540. */
  541. displayOrder?: Integer;
  542. /**
  543. * The field level description of each action review input field. This could be an explanation of the field. In the Amazon Q Business web experience, these descriptions could be used to display as tool tips to help users understand the field.
  544. */
  545. displayDescription?: String;
  546. /**
  547. * The type of field.
  548. */
  549. type?: ActionPayloadFieldType;
  550. /**
  551. * The field value.
  552. */
  553. value?: ActionPayloadFieldValue;
  554. /**
  555. * Information about the field values that an end user can use to provide to Amazon Q Business for Amazon Q Business to perform the requested plugin action.
  556. */
  557. allowedValues?: ActionReviewPayloadFieldAllowedValues;
  558. /**
  559. * The expected data format for the action review input field value. For example, in PTO request, from and to would be of datetime allowed format.
  560. */
  561. allowedFormat?: String;
  562. /**
  563. * Information about whether the field is required.
  564. */
  565. required?: Boolean;
  566. }
  567. export interface ActionReviewPayloadFieldAllowedValue {
  568. /**
  569. * The field value.
  570. */
  571. value?: ActionPayloadFieldValue;
  572. /**
  573. * The name of the field.
  574. */
  575. displayValue?: ActionPayloadFieldValue;
  576. }
  577. export type ActionReviewPayloadFieldAllowedValues = ActionReviewPayloadFieldAllowedValue[];
  578. export type AmazonResourceName = string;
  579. export interface Application {
  580. /**
  581. * The name of the Amazon Q Business application.
  582. */
  583. displayName?: ApplicationName;
  584. /**
  585. * The identifier for the Amazon Q Business application.
  586. */
  587. applicationId?: ApplicationId;
  588. /**
  589. * The Unix timestamp when the Amazon Q Business application was created.
  590. */
  591. createdAt?: Timestamp;
  592. /**
  593. * The Unix timestamp when the Amazon Q Business application was last updated.
  594. */
  595. updatedAt?: Timestamp;
  596. /**
  597. * The status of the Amazon Q Business application. The application is ready to use when the status is ACTIVE.
  598. */
  599. status?: ApplicationStatus;
  600. }
  601. export type ApplicationArn = string;
  602. export type ApplicationId = string;
  603. export type ApplicationName = string;
  604. export type ApplicationStatus = "CREATING"|"ACTIVE"|"DELETING"|"FAILED"|"UPDATING"|string;
  605. export type Applications = Application[];
  606. export interface AppliedAttachmentsConfiguration {
  607. /**
  608. * Information about whether file upload during chat functionality is activated for your application.
  609. */
  610. attachmentsControlMode?: AttachmentsControlMode;
  611. }
  612. export interface AppliedCreatorModeConfiguration {
  613. /**
  614. * Information about whether creator mode is enabled or disabled for an Amazon Q Business application.
  615. */
  616. creatorModeControl: CreatorModeControl;
  617. }
  618. export interface AttachmentInput {
  619. /**
  620. * The name of the file.
  621. */
  622. name: AttachmentName;
  623. /**
  624. * The data contained within the uploaded file.
  625. */
  626. data: _Blob;
  627. }
  628. export type AttachmentName = string;
  629. export interface AttachmentOutput {
  630. /**
  631. * The name of a file uploaded during chat.
  632. */
  633. name?: AttachmentName;
  634. /**
  635. * The status of a file uploaded during chat.
  636. */
  637. status?: AttachmentStatus;
  638. /**
  639. * An error associated with a file uploaded during chat.
  640. */
  641. error?: ErrorDetail;
  642. }
  643. export type AttachmentStatus = "FAILED"|"SUCCEEDED"|string;
  644. export interface AttachmentsConfiguration {
  645. /**
  646. * Status information about whether file upload functionality is activated or deactivated for your end user.
  647. */
  648. attachmentsControlMode: AttachmentsControlMode;
  649. }
  650. export type AttachmentsControlMode = "ENABLED"|"DISABLED"|string;
  651. export type AttachmentsInput = AttachmentInput[];
  652. export type AttachmentsOutput = AttachmentOutput[];
  653. export interface AttributeFilter {
  654. /**
  655. * Performs a logical AND operation on all supplied filters.
  656. */
  657. andAllFilters?: AttributeFilters;
  658. /**
  659. * Performs a logical OR operation on all supplied filters.
  660. */
  661. orAllFilters?: AttributeFilters;
  662. /**
  663. * Performs a logical NOT operation on all supplied filters.
  664. */
  665. notFilter?: AttributeFilter;
  666. /**
  667. * Performs an equals operation on two document attributes or metadata fields. Supported for the following document attribute value types: dateValue, longValue, stringListValue and stringValue.
  668. */
  669. equalsTo?: DocumentAttribute;
  670. /**
  671. * Returns true when a document contains all the specified document attributes or metadata fields. Supported for the following document attribute value types: stringListValue.
  672. */
  673. containsAll?: DocumentAttribute;
  674. /**
  675. * Returns true when a document contains any of the specified document attributes or metadata fields. Supported for the following document attribute value types: dateValue, longValue, stringListValue and stringValue.
  676. */
  677. containsAny?: DocumentAttribute;
  678. /**
  679. * Performs a greater than operation on two document attributes or metadata fields. Supported for the following document attribute value types: dateValue and longValue.
  680. */
  681. greaterThan?: DocumentAttribute;
  682. /**
  683. * Performs a greater or equals than operation on two document attributes or metadata fields. Supported for the following document attribute value types: dateValue and longValue.
  684. */
  685. greaterThanOrEquals?: DocumentAttribute;
  686. /**
  687. * Performs a less than operation on two document attributes or metadata fields. Supported for the following document attribute value types: dateValue and longValue.
  688. */
  689. lessThan?: DocumentAttribute;
  690. /**
  691. * Performs a less than or equals operation on two document attributes or metadata fields.Supported for the following document attribute value type: dateValue and longValue.
  692. */
  693. lessThanOrEquals?: DocumentAttribute;
  694. }
  695. export type AttributeFilters = AttributeFilter[];
  696. export type AttributeType = "STRING"|"STRING_LIST"|"NUMBER"|"DATE"|string;
  697. export type AttributeValueOperator = "DELETE"|string;
  698. export interface AuthChallengeRequest {
  699. /**
  700. * The URL sent by Amazon Q Business to the third party authentication server to authenticate a custom plugin user through an OAuth protocol.
  701. */
  702. authorizationUrl: Url;
  703. }
  704. export interface AuthChallengeResponse {
  705. /**
  706. * The mapping of key-value pairs in an authentication challenge response.
  707. */
  708. responseMap: AuthorizationResponseMap;
  709. }
  710. export type AuthResponseKey = string;
  711. export type AuthResponseValue = string;
  712. export type AuthorizationResponseMap = {[key: string]: AuthResponseValue};
  713. export interface BasicAuthConfiguration {
  714. /**
  715. * The ARN of the Secrets Manager secret that stores the basic authentication credentials used for plugin configuration..
  716. */
  717. secretArn: SecretArn;
  718. /**
  719. * The ARN of an IAM role used by Amazon Q Business to access the basic authentication credentials stored in a Secrets Manager secret.
  720. */
  721. roleArn: RoleArn;
  722. }
  723. export interface BatchDeleteDocumentRequest {
  724. /**
  725. * The identifier of the Amazon Q Business application.
  726. */
  727. applicationId: ApplicationId;
  728. /**
  729. * The identifier of the Amazon Q Business index that contains the documents to delete.
  730. */
  731. indexId: IndexId;
  732. /**
  733. * Documents deleted from the Amazon Q Business index.
  734. */
  735. documents: DeleteDocuments;
  736. /**
  737. * The identifier of the data source sync during which the documents were deleted.
  738. */
  739. dataSourceSyncId?: ExecutionId;
  740. }
  741. export interface BatchDeleteDocumentResponse {
  742. /**
  743. * A list of documents that couldn't be removed from the Amazon Q Business index. Each entry contains an error message that indicates why the document couldn't be removed from the index.
  744. */
  745. failedDocuments?: FailedDocuments;
  746. }
  747. export interface BatchPutDocumentRequest {
  748. /**
  749. * The identifier of the Amazon Q Business application.
  750. */
  751. applicationId: ApplicationId;
  752. /**
  753. * The identifier of the Amazon Q Business index to add the documents to.
  754. */
  755. indexId: IndexId;
  756. /**
  757. * One or more documents to add to the index.
  758. */
  759. documents: Documents;
  760. /**
  761. * The Amazon Resource Name (ARN) of an IAM role with permission to access your S3 bucket.
  762. */
  763. roleArn?: RoleArn;
  764. /**
  765. * The identifier of the data source sync during which the documents were added.
  766. */
  767. dataSourceSyncId?: ExecutionId;
  768. }
  769. export interface BatchPutDocumentResponse {
  770. /**
  771. * A list of documents that were not added to the Amazon Q Business index because the document failed a validation check. Each document contains an error message that indicates why the document couldn't be added to the index.
  772. */
  773. failedDocuments?: FailedDocuments;
  774. }
  775. export type _Blob = Buffer|Uint8Array|Blob|string;
  776. export type BlockedPhrase = string;
  777. export type BlockedPhrases = BlockedPhrase[];
  778. export interface BlockedPhrasesConfiguration {
  779. /**
  780. * A list of phrases blocked from a Amazon Q Business web experience chat.
  781. */
  782. blockedPhrases?: BlockedPhrases;
  783. /**
  784. * The configured custom message displayed to an end user informing them that they've used a blocked phrase during chat.
  785. */
  786. systemMessageOverride?: SystemMessageOverride;
  787. }
  788. export interface BlockedPhrasesConfigurationUpdate {
  789. /**
  790. * Creates or updates a blocked phrases configuration in your Amazon Q Business application.
  791. */
  792. blockedPhrasesToCreateOrUpdate?: BlockedPhrases;
  793. /**
  794. * Deletes a blocked phrases configuration in your Amazon Q Business application.
  795. */
  796. blockedPhrasesToDelete?: BlockedPhrases;
  797. /**
  798. * The configured custom message displayed to your end user when they use blocked phrase during chat.
  799. */
  800. systemMessageOverride?: SystemMessageOverride;
  801. }
  802. export type Boolean = boolean;
  803. export type BoostingDurationInSeconds = number;
  804. export type ChatMode = "RETRIEVAL_MODE"|"CREATOR_MODE"|"PLUGIN_MODE"|string;
  805. export interface ChatModeConfiguration {
  806. /**
  807. * Configuration information required to invoke chat in PLUGIN_MODE.
  808. */
  809. pluginConfiguration?: PluginConfiguration;
  810. }
  811. export interface ChatSyncInput {
  812. /**
  813. * The identifier of the Amazon Q Business application linked to the Amazon Q Business conversation.
  814. */
  815. applicationId: ApplicationId;
  816. /**
  817. * The identifier of the user attached to the chat input.
  818. */
  819. userId?: UserId;
  820. /**
  821. * The groups that a user associated with the chat input belongs to.
  822. */
  823. userGroups?: UserGroups;
  824. /**
  825. * A end user message in a conversation.
  826. */
  827. userMessage?: UserMessage;
  828. /**
  829. * A list of files uploaded directly during chat. You can upload a maximum of 5 files of upto 10 MB each.
  830. */
  831. attachments?: AttachmentsInput;
  832. /**
  833. * A request from an end user to perform an Amazon Q Business plugin action.
  834. */
  835. actionExecution?: ActionExecution;
  836. /**
  837. * An authentication verification event response by a third party authentication server to Amazon Q Business.
  838. */
  839. authChallengeResponse?: AuthChallengeResponse;
  840. /**
  841. * The identifier of the Amazon Q Business conversation.
  842. */
  843. conversationId?: ConversationId;
  844. /**
  845. * The identifier of the previous end user text input message in a conversation.
  846. */
  847. parentMessageId?: MessageId;
  848. /**
  849. * Enables filtering of Amazon Q Business web experience responses based on document attributes or metadata fields.
  850. */
  851. attributeFilter?: AttributeFilter;
  852. /**
  853. * The chat modes available to an Amazon Q Business end user. RETRIEVAL_MODE - The default chat mode for an Amazon Q Business application. When this mode is enabled, Amazon Q Business generates responses only from data sources connected to an Amazon Q Business application. CREATOR_MODE - By selecting this mode, users can choose to generate responses only from the LLM knowledge, without consulting connected data sources, for a chat request. PLUGIN_MODE - By selecting this mode, users can choose to use plugins in chat. For more information, see Admin controls and guardrails, Plugins, and Conversation settings.
  854. */
  855. chatMode?: ChatMode;
  856. /**
  857. * The chat mode configuration for an Amazon Q Business application.
  858. */
  859. chatModeConfiguration?: ChatModeConfiguration;
  860. /**
  861. * A token that you provide to identify a chat request.
  862. */
  863. clientToken?: ClientToken;
  864. }
  865. export interface ChatSyncOutput {
  866. /**
  867. * The identifier of the Amazon Q Business conversation.
  868. */
  869. conversationId?: ConversationId;
  870. /**
  871. * An AI-generated message in a conversation.
  872. */
  873. systemMessage?: String;
  874. /**
  875. * The identifier of an Amazon Q Business AI generated message within the conversation.
  876. */
  877. systemMessageId?: MessageId;
  878. /**
  879. * The identifier of an Amazon Q Business end user text input message within the conversation.
  880. */
  881. userMessageId?: MessageId;
  882. /**
  883. * A request from Amazon Q Business to the end user for information Amazon Q Business needs to successfully complete a requested plugin action.
  884. */
  885. actionReview?: ActionReview;
  886. /**
  887. * An authentication verification event activated by an end user request to use a custom plugin.
  888. */
  889. authChallengeRequest?: AuthChallengeRequest;
  890. /**
  891. * The source documents used to generate the conversation response.
  892. */
  893. sourceAttributions?: SourceAttributions;
  894. /**
  895. * A list of files which failed to upload during chat.
  896. */
  897. failedAttachments?: AttachmentsOutput;
  898. }
  899. export type ClientToken = string;
  900. export interface ContentBlockerRule {
  901. /**
  902. * The configured custom message displayed to an end user informing them that they've used a blocked phrase during chat.
  903. */
  904. systemMessageOverride?: SystemMessageOverride;
  905. }
  906. export interface ContentRetrievalRule {
  907. /**
  908. * Specifies data sources in a Amazon Q Business application to use for content generation.
  909. */
  910. eligibleDataSources?: EligibleDataSources;
  911. }
  912. export type ContentType = "PDF"|"HTML"|"MS_WORD"|"PLAIN_TEXT"|"PPT"|"RTF"|"XML"|"XSLT"|"MS_EXCEL"|"CSV"|"JSON"|"MD"|string;
  913. export interface Conversation {
  914. /**
  915. * The identifier of the Amazon Q Business conversation.
  916. */
  917. conversationId?: ConversationId;
  918. /**
  919. * The title of the conversation.
  920. */
  921. title?: ConversationTitle;
  922. /**
  923. * The start time of the conversation.
  924. */
  925. startTime?: Timestamp;
  926. }
  927. export type ConversationId = string;
  928. export type ConversationTitle = string;
  929. export type Conversations = Conversation[];
  930. export interface CreateApplicationRequest {
  931. /**
  932. * A name for the Amazon Q Business application.
  933. */
  934. displayName: ApplicationName;
  935. /**
  936. * The Amazon Resource Name (ARN) of an IAM role with permissions to access your Amazon CloudWatch logs and metrics.
  937. */
  938. roleArn?: RoleArn;
  939. /**
  940. * The Amazon Resource Name (ARN) of the IAM Identity Center instance you are either creating for—or connecting to—your Amazon Q Business application.
  941. */
  942. identityCenterInstanceArn?: InstanceArn;
  943. /**
  944. * A description for the Amazon Q Business application.
  945. */
  946. description?: Description;
  947. /**
  948. * The identifier of the KMS key that is used to encrypt your data. Amazon Q Business doesn't support asymmetric keys.
  949. */
  950. encryptionConfiguration?: EncryptionConfiguration;
  951. /**
  952. * A list of key-value pairs that identify or categorize your Amazon Q Business application. You can also use tags to help control access to the application. Tag keys and values can consist of Unicode letters, digits, white space, and any of the following symbols: _ . : / = + - @.
  953. */
  954. tags?: Tags;
  955. /**
  956. * A token that you provide to identify the request to create your Amazon Q Business application.
  957. */
  958. clientToken?: ClientToken;
  959. /**
  960. * An option to allow end users to upload files directly during chat.
  961. */
  962. attachmentsConfiguration?: AttachmentsConfiguration;
  963. }
  964. export interface CreateApplicationResponse {
  965. /**
  966. * The identifier of the Amazon Q Business application.
  967. */
  968. applicationId?: ApplicationId;
  969. /**
  970. * The Amazon Resource Name (ARN) of the Amazon Q Business application.
  971. */
  972. applicationArn?: ApplicationArn;
  973. }
  974. export interface CreateDataSourceRequest {
  975. /**
  976. * The identifier of the Amazon Q Business application the data source will be attached to.
  977. */
  978. applicationId: ApplicationId;
  979. /**
  980. * The identifier of the index that you want to use with the data source connector.
  981. */
  982. indexId: IndexId;
  983. /**
  984. * A name for the data source connector.
  985. */
  986. displayName: DataSourceName;
  987. /**
  988. * Configuration information to connect to your data source repository. For configuration templates for your specific data source, see Supported connectors.
  989. */
  990. configuration: DataSourceConfiguration;
  991. /**
  992. * Configuration information for an Amazon VPC (Virtual Private Cloud) to connect to your data source. For more information, see Using Amazon VPC with Amazon Q Business connectors.
  993. */
  994. vpcConfiguration?: DataSourceVpcConfiguration;
  995. /**
  996. * A description for the data source connector.
  997. */
  998. description?: Description;
  999. /**
  1000. * A list of key-value pairs that identify or categorize the data source connector. You can also use tags to help control access to the data source connector. Tag keys and values can consist of Unicode letters, digits, white space, and any of the following symbols: _ . : / = + - @.
  1001. */
  1002. tags?: Tags;
  1003. /**
  1004. * Sets the frequency for Amazon Q Business to check the documents in your data source repository and update your index. If you don't set a schedule, Amazon Q Business won't periodically update the index. Specify a cron- format schedule string or an empty string to indicate that the index is updated on demand. You can't specify the Schedule parameter when the Type parameter is set to CUSTOM. If you do, you receive a ValidationException exception.
  1005. */
  1006. syncSchedule?: SyncSchedule;
  1007. /**
  1008. * The Amazon Resource Name (ARN) of an IAM role with permission to access the data source and required resources.
  1009. */
  1010. roleArn?: RoleArn;
  1011. /**
  1012. * A token you provide to identify a request to create a data source connector. Multiple calls to the CreateDataSource API with the same client token will create only one data source connector.
  1013. */
  1014. clientToken?: ClientToken;
  1015. documentEnrichmentConfiguration?: DocumentEnrichmentConfiguration;
  1016. }
  1017. export interface CreateDataSourceResponse {
  1018. /**
  1019. * The identifier of the data source connector.
  1020. */
  1021. dataSourceId?: DataSourceId;
  1022. /**
  1023. * The Amazon Resource Name (ARN) of a data source in an Amazon Q Business application.
  1024. */
  1025. dataSourceArn?: DataSourceArn;
  1026. }
  1027. export interface CreateIndexRequest {
  1028. /**
  1029. * The identifier of the Amazon Q Business application using the index.
  1030. */
  1031. applicationId: ApplicationId;
  1032. /**
  1033. * A name for the Amazon Q Business index.
  1034. */
  1035. displayName: IndexName;
  1036. /**
  1037. * The index type that's suitable for your needs. For more information on what's included in each type of index or index tier, see Amazon Q Business tiers.
  1038. */
  1039. type?: IndexType;
  1040. /**
  1041. * A description for the Amazon Q Business index.
  1042. */
  1043. description?: Description;
  1044. /**
  1045. * A list of key-value pairs that identify or categorize the index. You can also use tags to help control access to the index. Tag keys and values can consist of Unicode letters, digits, white space, and any of the following symbols: _ . : / = + - @.
  1046. */
  1047. tags?: Tags;
  1048. /**
  1049. * The capacity units you want to provision for your index. You can add and remove capacity to fit your usage needs.
  1050. */
  1051. capacityConfiguration?: IndexCapacityConfiguration;
  1052. /**
  1053. * A token that you provide to identify the request to create an index. Multiple calls to the CreateIndex API with the same client token will create only one index.
  1054. */
  1055. clientToken?: ClientToken;
  1056. }
  1057. export interface CreateIndexResponse {
  1058. /**
  1059. * The identifier for the Amazon Q Business index.
  1060. */
  1061. indexId?: IndexId;
  1062. /**
  1063. * The Amazon Resource Name (ARN) of an Amazon Q Business index.
  1064. */
  1065. indexArn?: IndexArn;
  1066. }
  1067. export interface CreatePluginRequest {
  1068. /**
  1069. * The identifier of the application that will contain the plugin.
  1070. */
  1071. applicationId: ApplicationId;
  1072. /**
  1073. * A the name for your plugin.
  1074. */
  1075. displayName: PluginName;
  1076. /**
  1077. * The type of plugin you want to create.
  1078. */
  1079. type: PluginType;
  1080. authConfiguration: PluginAuthConfiguration;
  1081. /**
  1082. * The source URL used for plugin configuration.
  1083. */
  1084. serverUrl?: Url;
  1085. /**
  1086. * Contains configuration for a custom plugin.
  1087. */
  1088. customPluginConfiguration?: CustomPluginConfiguration;
  1089. /**
  1090. * A list of key-value pairs that identify or categorize the data source connector. You can also use tags to help control access to the data source connector. Tag keys and values can consist of Unicode letters, digits, white space, and any of the following symbols: _ . : / = + - @.
  1091. */
  1092. tags?: Tags;
  1093. /**
  1094. * A token that you provide to identify the request to create your Amazon Q Business plugin.
  1095. */
  1096. clientToken?: ClientToken;
  1097. }
  1098. export interface CreatePluginResponse {
  1099. /**
  1100. * The identifier of the plugin created.
  1101. */
  1102. pluginId?: PluginId;
  1103. /**
  1104. * The Amazon Resource Name (ARN) of a plugin.
  1105. */
  1106. pluginArn?: PluginArn;
  1107. /**
  1108. * The current status of a plugin. A plugin is modified asynchronously.
  1109. */
  1110. buildStatus?: PluginBuildStatus;
  1111. }
  1112. export interface CreateRetrieverRequest {
  1113. /**
  1114. * The identifier of your Amazon Q Business application.
  1115. */
  1116. applicationId: ApplicationId;
  1117. /**
  1118. * The type of retriever you are using.
  1119. */
  1120. type: RetrieverType;
  1121. /**
  1122. * The name of your retriever.
  1123. */
  1124. displayName: RetrieverName;
  1125. configuration: RetrieverConfiguration;
  1126. /**
  1127. * The ARN of an IAM role used by Amazon Q Business to access the basic authentication credentials stored in a Secrets Manager secret.
  1128. */
  1129. roleArn?: RoleArn;
  1130. /**
  1131. * A token that you provide to identify the request to create your Amazon Q Business application retriever.
  1132. */
  1133. clientToken?: ClientToken;
  1134. /**
  1135. * A list of key-value pairs that identify or categorize the retriever. You can also use tags to help control access to the retriever. Tag keys and values can consist of Unicode letters, digits, white space, and any of the following symbols: _ . : / = + - @.
  1136. */
  1137. tags?: Tags;
  1138. }
  1139. export interface CreateRetrieverResponse {
  1140. /**
  1141. * The identifier of the retriever you are using.
  1142. */
  1143. retrieverId?: RetrieverId;
  1144. /**
  1145. * The Amazon Resource Name (ARN) of an IAM role associated with a retriever.
  1146. */
  1147. retrieverArn?: RetrieverArn;
  1148. }
  1149. export interface CreateUserRequest {
  1150. /**
  1151. * The identifier of the application for which the user mapping will be created.
  1152. */
  1153. applicationId: ApplicationId;
  1154. /**
  1155. * The user emails attached to a user mapping.
  1156. */
  1157. userId: String;
  1158. /**
  1159. * The list of user aliases in the mapping.
  1160. */
  1161. userAliases?: CreateUserRequestUserAliasesList;
  1162. /**
  1163. * A token that you provide to identify the request to create your Amazon Q Business user mapping.
  1164. */
  1165. clientToken?: ClientToken;
  1166. }
  1167. export type CreateUserRequestUserAliasesList = UserAlias[];
  1168. export interface CreateUserResponse {
  1169. }
  1170. export interface CreateWebExperienceRequest {
  1171. /**
  1172. * The identifier of the Amazon Q Business web experience.
  1173. */
  1174. applicationId: ApplicationId;
  1175. /**
  1176. * The title for your Amazon Q Business web experience.
  1177. */
  1178. title?: WebExperienceTitle;
  1179. /**
  1180. * A subtitle to personalize your Amazon Q Business web experience.
  1181. */
  1182. subtitle?: WebExperienceSubtitle;
  1183. /**
  1184. * The customized welcome message for end users of an Amazon Q Business web experience.
  1185. */
  1186. welcomeMessage?: WebExperienceWelcomeMessage;
  1187. /**
  1188. * Determines whether sample prompts are enabled in the web experience for an end user.
  1189. */
  1190. samplePromptsControlMode?: WebExperienceSamplePromptsControlMode;
  1191. /**
  1192. * The Amazon Resource Name (ARN) of the service role attached to your web experience.
  1193. */
  1194. roleArn?: RoleArn;
  1195. /**
  1196. * A list of key-value pairs that identify or categorize your Amazon Q Business web experience. You can also use tags to help control access to the web experience. Tag keys and values can consist of Unicode letters, digits, white space, and any of the following symbols: _ . : / = + - @.
  1197. */
  1198. tags?: Tags;
  1199. /**
  1200. * A token you provide to identify a request to create an Amazon Q Business web experience.
  1201. */
  1202. clientToken?: ClientToken;
  1203. }
  1204. export interface CreateWebExperienceResponse {
  1205. /**
  1206. * The identifier of the Amazon Q Business web experience.
  1207. */
  1208. webExperienceId?: WebExperienceId;
  1209. /**
  1210. * The Amazon Resource Name (ARN) of an Amazon Q Business web experience.
  1211. */
  1212. webExperienceArn?: WebExperienceArn;
  1213. }
  1214. export interface CreatorModeConfiguration {
  1215. /**
  1216. * Status information about whether CREATOR_MODE has been enabled or disabled. The default status is DISABLED.
  1217. */
  1218. creatorModeControl: CreatorModeControl;
  1219. }
  1220. export type CreatorModeControl = "ENABLED"|"DISABLED"|string;
  1221. export interface CustomPluginConfiguration {
  1222. /**
  1223. * A description for your custom plugin configuration.
  1224. */
  1225. description: PluginDescription;
  1226. /**
  1227. * The type of OpenAPI schema to use.
  1228. */
  1229. apiSchemaType: APISchemaType;
  1230. /**
  1231. * Contains either details about the S3 object containing the OpenAPI schema for the action group or the JSON or YAML-formatted payload defining the schema.
  1232. */
  1233. apiSchema: APISchema;
  1234. }
  1235. export interface DataSource {
  1236. /**
  1237. * The name of the Amazon Q Business data source.
  1238. */
  1239. displayName?: DataSourceName;
  1240. /**
  1241. * The identifier of the Amazon Q Business data source.
  1242. */
  1243. dataSourceId?: DataSourceId;
  1244. /**
  1245. * The type of the Amazon Q Business data source.
  1246. */
  1247. type?: String;
  1248. /**
  1249. * The Unix timestamp when the Amazon Q Business data source was created.
  1250. */
  1251. createdAt?: Timestamp;
  1252. /**
  1253. * The Unix timestamp when the Amazon Q Business data source was last updated.
  1254. */
  1255. updatedAt?: Timestamp;
  1256. /**
  1257. * The status of the Amazon Q Business data source.
  1258. */
  1259. status?: DataSourceStatus;
  1260. }
  1261. export type DataSourceArn = string;
  1262. export interface DataSourceConfiguration {
  1263. }
  1264. export type DataSourceId = string;
  1265. export type DataSourceIds = DataSourceId[];
  1266. export type DataSourceName = string;
  1267. export type DataSourceStatus = "PENDING_CREATION"|"CREATING"|"ACTIVE"|"DELETING"|"FAILED"|"UPDATING"|string;
  1268. export interface DataSourceSyncJob {
  1269. /**
  1270. * The identifier of a data source synchronization job.
  1271. */
  1272. executionId?: ExecutionId;
  1273. /**
  1274. * The Unix time stamp when the data source synchronization job started.
  1275. */
  1276. startTime?: Timestamp;
  1277. /**
  1278. * The Unix timestamp when the synchronization job completed.
  1279. */
  1280. endTime?: Timestamp;
  1281. /**
  1282. * The status of the synchronization job. When the Status field is set to SUCCEEDED, the synchronization job is done. If the status code is FAILED, the ErrorCode and ErrorMessage fields give you the reason for the failure.
  1283. */
  1284. status?: DataSourceSyncJobStatus;
  1285. /**
  1286. * If the Status field is set to FAILED, the ErrorCode field indicates the reason the synchronization failed.
  1287. */
  1288. error?: ErrorDetail;
  1289. /**
  1290. * If the reason that the synchronization failed is due to an error with the underlying data source, this field contains a code that identifies the error.
  1291. */
  1292. dataSourceErrorCode?: String;
  1293. /**
  1294. * Maps a batch delete document request to a specific data source sync job. This is optional and should only be supplied when documents are deleted by a data source connector.
  1295. */
  1296. metrics?: DataSourceSyncJobMetrics;
  1297. }
  1298. export interface DataSourceSyncJobMetrics {
  1299. /**
  1300. * The current count of documents added from the data source during the data source sync.
  1301. */
  1302. documentsAdded?: MetricValue;
  1303. /**
  1304. * The current count of documents modified in the data source during the data source sync.
  1305. */
  1306. documentsModified?: MetricValue;
  1307. /**
  1308. * The current count of documents deleted from the data source during the data source sync.
  1309. */
  1310. documentsDeleted?: MetricValue;
  1311. /**
  1312. * The current count of documents that failed to sync from the data source during the data source sync.
  1313. */
  1314. documentsFailed?: MetricValue;
  1315. /**
  1316. * The current count of documents crawled by the ongoing sync job in the data source.
  1317. */
  1318. documentsScanned?: MetricValue;
  1319. }
  1320. export type DataSourceSyncJobStatus = "FAILED"|"SUCCEEDED"|"SYNCING"|"INCOMPLETE"|"STOPPING"|"ABORTED"|"SYNCING_INDEXING"|string;
  1321. export type DataSourceSyncJobs = DataSourceSyncJob[];
  1322. export type DataSourceUserId = string;
  1323. export interface DataSourceVpcConfiguration {
  1324. /**
  1325. * A list of identifiers for subnets within your Amazon VPC. The subnets should be able to connect to each other in the VPC, and they should have outgoing access to the Internet through a NAT device.
  1326. */
  1327. subnetIds: SubnetIds;
  1328. /**
  1329. * A list of identifiers of security groups within your Amazon VPC. The security groups should enable Amazon Q Business to connect to the data source.
  1330. */
  1331. securityGroupIds: SecurityGroupIds;
  1332. }
  1333. export type DataSources = DataSource[];
  1334. export interface DateAttributeBoostingConfiguration {
  1335. /**
  1336. * Specifies how much a document attribute is boosted.
  1337. */
  1338. boostingLevel: DocumentAttributeBoostingLevel;
  1339. /**
  1340. * Specifies the duration, in seconds, of a boost applies to a DATE type document attribute.
  1341. */
  1342. boostingDurationInSeconds?: BoostingDurationInSeconds;
  1343. }
  1344. export interface DeleteApplicationRequest {
  1345. /**
  1346. * The identifier of the Amazon Q Business application.
  1347. */
  1348. applicationId: ApplicationId;
  1349. }
  1350. export interface DeleteApplicationResponse {
  1351. }
  1352. export interface DeleteChatControlsConfigurationRequest {
  1353. /**
  1354. * The identifier of the application the chat controls have been configured for.
  1355. */
  1356. applicationId: ApplicationId;
  1357. }
  1358. export interface DeleteChatControlsConfigurationResponse {
  1359. }
  1360. export interface DeleteConversationRequest {
  1361. /**
  1362. * The identifier of the Amazon Q Business web experience conversation being deleted.
  1363. */
  1364. conversationId: ConversationId;
  1365. /**
  1366. * The identifier of the Amazon Q Business application associated with the conversation.
  1367. */
  1368. applicationId: ApplicationId;
  1369. /**
  1370. * The identifier of the user who is deleting the conversation.
  1371. */
  1372. userId?: UserId;
  1373. }
  1374. export interface DeleteConversationResponse {
  1375. }
  1376. export interface DeleteDataSourceRequest {
  1377. /**
  1378. * The identifier of the Amazon Q Business application used with the data source connector.
  1379. */
  1380. applicationId: ApplicationId;
  1381. /**
  1382. * The identifier of the index used with the data source connector.
  1383. */
  1384. indexId: IndexId;
  1385. /**
  1386. * The identifier of the data source connector that you want to delete.
  1387. */
  1388. dataSourceId: DataSourceId;
  1389. }
  1390. export interface DeleteDataSourceResponse {
  1391. }
  1392. export interface DeleteDocument {
  1393. /**
  1394. * The identifier of the deleted document.
  1395. */
  1396. documentId: DocumentId;
  1397. }
  1398. export type DeleteDocuments = DeleteDocument[];
  1399. export interface DeleteGroupRequest {
  1400. /**
  1401. * The identifier of the application in which the group mapping belongs.
  1402. */
  1403. applicationId: ApplicationId;
  1404. /**
  1405. * The identifier of the index you want to delete the group from.
  1406. */
  1407. indexId: IndexId;
  1408. /**
  1409. * The name of the group you want to delete.
  1410. */
  1411. groupName: GroupName;
  1412. /**
  1413. * The identifier of the data source linked to the group A group can be tied to multiple data sources. You can delete a group from accessing documents in a certain data source. For example, the groups "Research", "Engineering", and "Sales and Marketing" are all tied to the company's documents stored in the data sources Confluence and Salesforce. You want to delete "Research" and "Engineering" groups from Salesforce, so that these groups cannot access customer-related documents stored in Salesforce. Only "Sales and Marketing" should access documents in the Salesforce data source.
  1414. */
  1415. dataSourceId?: DataSourceId;
  1416. }
  1417. export interface DeleteGroupResponse {
  1418. }
  1419. export interface DeleteIndexRequest {
  1420. /**
  1421. * The identifier of the Amazon Q Business application the Amazon Q Business index is linked to.
  1422. */
  1423. applicationId: ApplicationId;
  1424. /**
  1425. * The identifier of the Amazon Q Business index.
  1426. */
  1427. indexId: IndexId;
  1428. }
  1429. export interface DeleteIndexResponse {
  1430. }
  1431. export interface DeletePluginRequest {
  1432. /**
  1433. * The identifier the application attached to the Amazon Q Business plugin.
  1434. */
  1435. applicationId: ApplicationId;
  1436. /**
  1437. * The identifier of the plugin being deleted.
  1438. */
  1439. pluginId: PluginId;
  1440. }
  1441. export interface DeletePluginResponse {
  1442. }
  1443. export interface DeleteRetrieverRequest {
  1444. /**
  1445. * The identifier of the Amazon Q Business application using the retriever.
  1446. */
  1447. applicationId: ApplicationId;
  1448. /**
  1449. * The identifier of the retriever being deleted.
  1450. */
  1451. retrieverId: RetrieverId;
  1452. }
  1453. export interface DeleteRetrieverResponse {
  1454. }
  1455. export interface DeleteUserRequest {
  1456. /**
  1457. * The identifier of the application from which the user is being deleted.
  1458. */
  1459. applicationId: ApplicationId;
  1460. /**
  1461. * The user email being deleted.
  1462. */
  1463. userId: String;
  1464. }
  1465. export interface DeleteUserResponse {
  1466. }
  1467. export interface DeleteWebExperienceRequest {
  1468. /**
  1469. * The identifier of the Amazon Q Business application linked to the Amazon Q Business web experience.
  1470. */
  1471. applicationId: ApplicationId;
  1472. /**
  1473. * The identifier of the Amazon Q Business web experience being deleted.
  1474. */
  1475. webExperienceId: WebExperienceId;
  1476. }
  1477. export interface DeleteWebExperienceResponse {
  1478. }
  1479. export type Description = string;
  1480. export interface Document {
  1481. /**
  1482. * The identifier of the document.
  1483. */
  1484. id: DocumentId;
  1485. /**
  1486. * Custom attributes to apply to the document for refining Amazon Q Business web experience responses.
  1487. */
  1488. attributes?: DocumentAttributes;
  1489. /**
  1490. * The contents of the document.
  1491. */
  1492. content?: DocumentContent;
  1493. /**
  1494. * The file type of the document in the Blob field. If you want to index snippets or subsets of HTML documents instead of the entirety of the HTML documents, you add the HTML start and closing tags (&lt;HTML&gt;content&lt;/HTML&gt;) around the content.
  1495. */
  1496. contentType?: ContentType;
  1497. /**
  1498. * The title of the document.
  1499. */
  1500. title?: Title;
  1501. /**
  1502. * Configuration information for access permission to a document.
  1503. */
  1504. accessConfiguration?: AccessConfiguration;
  1505. /**
  1506. * The configuration information for altering document metadata and content during the document ingestion process.
  1507. */
  1508. documentEnrichmentConfiguration?: DocumentEnrichmentConfiguration;
  1509. }
  1510. export interface DocumentAttribute {
  1511. /**
  1512. * The identifier for the attribute.
  1513. */
  1514. name: DocumentAttributeKey;
  1515. /**
  1516. * The value of the attribute.
  1517. */
  1518. value: DocumentAttributeValue;
  1519. }
  1520. export interface DocumentAttributeBoostingConfiguration {
  1521. /**
  1522. * Provides information on boosting NUMBER type document attributes.
  1523. */
  1524. numberConfiguration?: NumberAttributeBoostingConfiguration;
  1525. /**
  1526. * Provides information on boosting STRING type document attributes.
  1527. */
  1528. stringConfiguration?: StringAttributeBoostingConfiguration;
  1529. /**
  1530. * Provides information on boosting DATE type document attributes.
  1531. */
  1532. dateConfiguration?: DateAttributeBoostingConfiguration;
  1533. /**
  1534. * Provides information on boosting STRING_LIST type document attributes.
  1535. */
  1536. stringListConfiguration?: StringListAttributeBoostingConfiguration;
  1537. }
  1538. export type DocumentAttributeBoostingLevel = "NONE"|"LOW"|"MEDIUM"|"HIGH"|"VERY_HIGH"|string;
  1539. export type DocumentAttributeBoostingOverrideMap = {[key: string]: DocumentAttributeBoostingConfiguration};
  1540. export interface DocumentAttributeCondition {
  1541. /**
  1542. * The identifier of the document attribute used for the condition. For example, 'Source_URI' could be an identifier for the attribute or metadata field that contains source URIs associated with the documents. Amazon Q Business currently doesn't support _document_body as an attribute key used for the condition.
  1543. */
  1544. key: DocumentAttributeKey;
  1545. /**
  1546. * The identifier of the document attribute used for the condition. For example, 'Source_URI' could be an identifier for the attribute or metadata field that contains source URIs associated with the documents. Amazon Q Business currently does not support _document_body as an attribute key used for the condition.
  1547. */
  1548. operator: DocumentEnrichmentConditionOperator;
  1549. value?: DocumentAttributeValue;
  1550. }
  1551. export interface DocumentAttributeConfiguration {
  1552. /**
  1553. * The name of the document attribute.
  1554. */
  1555. name?: DocumentMetadataConfigurationName;
  1556. /**
  1557. * The type of document attribute.
  1558. */
  1559. type?: AttributeType;
  1560. /**
  1561. * Information about whether the document attribute can be used by an end user to search for information on their web experience.
  1562. */
  1563. search?: Status;
  1564. }
  1565. export type DocumentAttributeConfigurations = DocumentAttributeConfiguration[];
  1566. export type DocumentAttributeKey = string;
  1567. export type DocumentAttributeStringListValue = String[];
  1568. export interface DocumentAttributeTarget {
  1569. /**
  1570. * The identifier of the target document attribute or metadata field. For example, 'Department' could be an identifier for the target attribute or metadata field that includes the department names associated with the documents.
  1571. */
  1572. key: DocumentAttributeKey;
  1573. value?: DocumentAttributeValue;
  1574. /**
  1575. * TRUE to delete the existing target value for your specified target attribute key. You cannot create a target value and set this to TRUE.
  1576. */
  1577. attributeValueOperator?: AttributeValueOperator;
  1578. }
  1579. export interface DocumentAttributeValue {
  1580. /**
  1581. * A string.
  1582. */
  1583. stringValue?: DocumentAttributeValueStringValueString;
  1584. /**
  1585. * A list of strings.
  1586. */
  1587. stringListValue?: DocumentAttributeStringListValue;
  1588. /**
  1589. * A long integer value.
  1590. */
  1591. longValue?: Long;
  1592. /**
  1593. * A date expressed as an ISO 8601 string. It's important for the time zone to be included in the ISO 8601 date-time format. For example, 2012-03-25T12:30:10+01:00 is the ISO 8601 date-time format for March 25th 2012 at 12:30PM (plus 10 seconds) in Central European Time.
  1594. */
  1595. dateValue?: Timestamp;
  1596. }
  1597. export type DocumentAttributeValueStringValueString = string;
  1598. export type DocumentAttributes = DocumentAttribute[];
  1599. export interface DocumentContent {
  1600. /**
  1601. * The contents of the document. Documents passed to the blob parameter must be base64 encoded. Your code might not need to encode the document file bytes if you're using an Amazon Web Services SDK to call Amazon Q Business APIs. If you are calling the Amazon Q Business endpoint directly using REST, you must base64 encode the contents before sending.
  1602. */
  1603. blob?: _Blob;
  1604. /**
  1605. * The path to the document in an Amazon S3 bucket.
  1606. */
  1607. s3?: S3;
  1608. }
  1609. export type DocumentContentOperator = "DELETE"|string;
  1610. export type DocumentDetailList = DocumentDetails[];
  1611. export interface DocumentDetails {
  1612. /**
  1613. * The identifier of the document.
  1614. */
  1615. documentId?: DocumentId;
  1616. /**
  1617. * The current status of the document.
  1618. */
  1619. status?: DocumentStatus;
  1620. /**
  1621. * An error message associated with the document.
  1622. */
  1623. error?: ErrorDetail;
  1624. /**
  1625. * The timestamp for when the document was created.
  1626. */
  1627. createdAt?: Timestamp;
  1628. /**
  1629. * The timestamp for when the document was last updated.
  1630. */
  1631. updatedAt?: Timestamp;
  1632. }
  1633. export type DocumentEnrichmentConditionOperator = "GREATER_THAN"|"GREATER_THAN_OR_EQUALS"|"LESS_THAN"|"LESS_THAN_OR_EQUALS"|"EQUALS"|"NOT_EQUALS"|"CONTAINS"|"NOT_CONTAINS"|"EXISTS"|"NOT_EXISTS"|"BEGINS_WITH"|string;
  1634. export interface DocumentEnrichmentConfiguration {
  1635. /**
  1636. * Configuration information to alter document attributes or metadata fields and content when ingesting documents into Amazon Q Business.
  1637. */
  1638. inlineConfigurations?: InlineDocumentEnrichmentConfigurations;
  1639. preExtractionHookConfiguration?: HookConfiguration;
  1640. postExtractionHookConfiguration?: HookConfiguration;
  1641. }
  1642. export type DocumentId = string;
  1643. export type DocumentMetadataConfigurationName = string;
  1644. export type DocumentStatus = "RECEIVED"|"PROCESSING"|"INDEXED"|"UPDATED"|"FAILED"|"DELETING"|"DELETED"|"DOCUMENT_FAILED_TO_INDEX"|string;
  1645. export type Documents = Document[];
  1646. export interface EligibleDataSource {
  1647. /**
  1648. * The identifier of the index the data source is attached to.
  1649. */
  1650. indexId?: IndexId;
  1651. /**
  1652. * The identifier of the data source.
  1653. */
  1654. dataSourceId?: DataSourceId;
  1655. }
  1656. export type EligibleDataSources = EligibleDataSource[];
  1657. export interface EncryptionConfiguration {
  1658. /**
  1659. * The identifier of the KMS key. Amazon Q Business doesn't support asymmetric keys.
  1660. */
  1661. kmsKeyId?: KmsKeyId;
  1662. }
  1663. export type ErrorCode = "InternalError"|"InvalidRequest"|"ResourceInactive"|"ResourceNotFound"|string;
  1664. export interface ErrorDetail {
  1665. /**
  1666. * The message explaining the data source sync error.
  1667. */
  1668. errorMessage?: ErrorMessage;
  1669. /**
  1670. * The code associated with the data source sync error.
  1671. */
  1672. errorCode?: ErrorCode;
  1673. }
  1674. export type ErrorMessage = string;
  1675. export type ExampleChatMessage = string;
  1676. export type ExampleChatMessages = ExampleChatMessage[];
  1677. export type ExecutionId = string;
  1678. export interface FailedDocument {
  1679. /**
  1680. * The identifier of the document that couldn't be removed from the Amazon Q Business index.
  1681. */
  1682. id?: DocumentId;
  1683. /**
  1684. * An explanation for why the document couldn't be removed from the index.
  1685. */
  1686. error?: ErrorDetail;
  1687. /**
  1688. * The identifier of the Amazon Q Business data source connector that contains the failed document.
  1689. */
  1690. dataSourceId?: DataSourceId;
  1691. }
  1692. export type FailedDocuments = FailedDocument[];
  1693. export interface GetApplicationRequest {
  1694. /**
  1695. * The identifier of the Amazon Q Business application.
  1696. */
  1697. applicationId: ApplicationId;
  1698. }
  1699. export interface GetApplicationResponse {
  1700. /**
  1701. * The name of the Amazon Q Business application.
  1702. */
  1703. displayName?: ApplicationName;
  1704. /**
  1705. * The identifier of the Amazon Q Business application.
  1706. */
  1707. applicationId?: ApplicationId;
  1708. /**
  1709. * The Amazon Resource Name (ARN) of the Amazon Q Business application.
  1710. */
  1711. applicationArn?: ApplicationArn;
  1712. /**
  1713. * The Amazon Resource Name (ARN) of the AWS IAM Identity Center instance attached to your Amazon Q Business application.
  1714. */
  1715. identityCenterApplicationArn?: IdcApplicationArn;
  1716. /**
  1717. * The Amazon Resource Name (ARN) of the IAM with permissions to access your CloudWatch logs and metrics.
  1718. */
  1719. roleArn?: RoleArn;
  1720. /**
  1721. * The status of the Amazon Q Business application.
  1722. */
  1723. status?: ApplicationStatus;
  1724. /**
  1725. * A description for the Amazon Q Business application.
  1726. */
  1727. description?: Description;
  1728. /**
  1729. * The identifier of the Amazon Web Services KMS key that is used to encrypt your data. Amazon Q Business doesn't support asymmetric keys.
  1730. */
  1731. encryptionConfiguration?: EncryptionConfiguration;
  1732. /**
  1733. * The Unix timestamp when the Amazon Q Business application was last updated.
  1734. */
  1735. createdAt?: Timestamp;
  1736. /**
  1737. * The Unix timestamp when the Amazon Q Business application was last updated.
  1738. */
  1739. updatedAt?: Timestamp;
  1740. /**
  1741. * If the Status field is set to ERROR, the ErrorMessage field contains a description of the error that caused the synchronization to fail.
  1742. */
  1743. error?: ErrorDetail;
  1744. /**
  1745. * Settings for whether end users can upload files directly during chat.
  1746. */
  1747. attachmentsConfiguration?: AppliedAttachmentsConfiguration;
  1748. }
  1749. export interface GetChatControlsConfigurationRequest {
  1750. /**
  1751. * The identifier of the application for which the chat controls are configured.
  1752. */
  1753. applicationId: ApplicationId;
  1754. /**
  1755. * The maximum number of configured chat controls to return.
  1756. */
  1757. maxResults?: MaxResultsIntegerForGetTopicConfigurations;
  1758. /**
  1759. * If the maxResults response was incomplete because there is more data to retrieve, Amazon Q Business returns a pagination token in the response. You can use this pagination token to retrieve the next set of Amazon Q Business chat controls configured.
  1760. */
  1761. nextToken?: NextToken;
  1762. }
  1763. export interface GetChatControlsConfigurationResponse {
  1764. /**
  1765. * The response scope configured for a Amazon Q Business application. This determines whether your application uses its retrieval augmented generation (RAG) system to generate answers only from your enterprise data, or also uses the large language models (LLM) knowledge to respons to end user questions in chat.
  1766. */
  1767. responseScope?: ResponseScope;
  1768. /**
  1769. * The phrases blocked from chat by your chat control configuration.
  1770. */
  1771. blockedPhrases?: BlockedPhrasesConfiguration;
  1772. /**
  1773. * The topic specific controls configured for a Amazon Q Business application.
  1774. */
  1775. topicConfigurations?: TopicConfigurations;
  1776. /**
  1777. * The configuration details for CREATOR_MODE.
  1778. */
  1779. creatorModeConfiguration?: AppliedCreatorModeConfiguration;
  1780. /**
  1781. * If the maxResults response was incomplete because there is more data to retrieve, Amazon Q Business returns a pagination token in the response. You can use this pagination token to retrieve the next set of Amazon Q Business chat controls configured.
  1782. */
  1783. nextToken?: NextToken;
  1784. }
  1785. export interface GetDataSourceRequest {
  1786. /**
  1787. * The identifier of the Amazon Q Business application.
  1788. */
  1789. applicationId: ApplicationId;
  1790. /**
  1791. * The identfier of the index used with the data source connector.
  1792. */
  1793. indexId: IndexId;
  1794. /**
  1795. * The identifier of the data source connector.
  1796. */
  1797. dataSourceId: DataSourceId;
  1798. }
  1799. export interface GetDataSourceResponse {
  1800. /**
  1801. * The identifier of the Amazon Q Business application.
  1802. */
  1803. applicationId?: ApplicationId;
  1804. /**
  1805. * The identifier of the index linked to the data source connector.
  1806. */
  1807. indexId?: IndexId;
  1808. /**
  1809. * The identifier of the data source connector.
  1810. */
  1811. dataSourceId?: DataSourceId;
  1812. /**
  1813. * The Amazon Resource Name (ARN) of the data source.
  1814. */
  1815. dataSourceArn?: DataSourceArn;
  1816. /**
  1817. * The name for the data source connector.
  1818. */
  1819. displayName?: DataSourceName;
  1820. /**
  1821. * The type of the data source connector. For example, S3.
  1822. */
  1823. type?: String;
  1824. /**
  1825. * The details of how the data source connector is configured.
  1826. */
  1827. configuration?: DataSourceConfiguration;
  1828. /**
  1829. * Configuration information for an Amazon VPC (Virtual Private Cloud) to connect to your data source.
  1830. */
  1831. vpcConfiguration?: DataSourceVpcConfiguration;
  1832. /**
  1833. * The Unix timestamp when the data source connector was created.
  1834. */
  1835. createdAt?: Timestamp;
  1836. /**
  1837. * The Unix timestamp when the data source connector was last updated.
  1838. */
  1839. updatedAt?: Timestamp;
  1840. /**
  1841. * The description for the data source connector.
  1842. */
  1843. description?: Description;
  1844. /**
  1845. * The current status of the data source connector. When the Status field value is FAILED, the ErrorMessage field contains a description of the error that caused the data source connector to fail.
  1846. */
  1847. status?: DataSourceStatus;
  1848. /**
  1849. * The schedule for Amazon Q Business to update the index.
  1850. */
  1851. syncSchedule?: SyncSchedule;
  1852. /**
  1853. * The Amazon Resource Name (ARN) of the role with permission to access the data source and required resources.
  1854. */
  1855. roleArn?: RoleArn;
  1856. /**
  1857. * When the Status field value is FAILED, the ErrorMessage field contains a description of the error that caused the data source connector to fail.
  1858. */
  1859. error?: ErrorDetail;
  1860. documentEnrichmentConfiguration?: DocumentEnrichmentConfiguration;
  1861. }
  1862. export interface GetGroupRequest {
  1863. /**
  1864. * The identifier of the application id the group is attached to.
  1865. */
  1866. applicationId: ApplicationId;
  1867. /**
  1868. * The identifier of the index the group is attached to.
  1869. */
  1870. indexId: IndexId;
  1871. /**
  1872. * The name of the group.
  1873. */
  1874. groupName: GroupName;
  1875. /**
  1876. * The identifier of the data source the group is attached to.
  1877. */
  1878. dataSourceId?: DataSourceId;
  1879. }
  1880. export interface GetGroupResponse {
  1881. /**
  1882. * The current status of the group.
  1883. */
  1884. status?: GroupStatusDetail;
  1885. /**
  1886. * The status history of the group.
  1887. */
  1888. statusHistory?: GroupStatusDetails;
  1889. }
  1890. export interface GetIndexRequest {
  1891. /**
  1892. * The identifier of the Amazon Q Business application connected to the index.
  1893. */
  1894. applicationId: ApplicationId;
  1895. /**
  1896. * The identifier of the Amazon Q Business index you want information on.
  1897. */
  1898. indexId: IndexId;
  1899. }
  1900. export interface GetIndexResponse {
  1901. /**
  1902. * The identifier of the Amazon Q Business application associated with the index.
  1903. */
  1904. applicationId?: ApplicationId;
  1905. /**
  1906. * The identifier of the Amazon Q Business index.
  1907. */
  1908. indexId?: IndexId;
  1909. /**
  1910. * The name of the Amazon Q Business index.
  1911. */
  1912. displayName?: IndexName;
  1913. /**
  1914. * The type of index attached to your Amazon Q Business application.
  1915. */
  1916. type?: IndexType;
  1917. /**
  1918. * The Amazon Resource Name (ARN) of the Amazon Q Business index.
  1919. */
  1920. indexArn?: IndexArn;
  1921. /**
  1922. * The current status of the index. When the value is ACTIVE, the index is ready for use. If the Status field value is FAILED, the ErrorMessage field contains a message that explains why.
  1923. */
  1924. status?: IndexStatus;
  1925. /**
  1926. * The description for the Amazon Q Business index.
  1927. */
  1928. description?: Description;
  1929. /**
  1930. * The Unix timestamp when the Amazon Q Business index was created.
  1931. */
  1932. createdAt?: Timestamp;
  1933. /**
  1934. * The Unix timestamp when the Amazon Q Business index was last updated.
  1935. */
  1936. updatedAt?: Timestamp;
  1937. /**
  1938. * The storage capacity units chosen for your Amazon Q Business index.
  1939. */
  1940. capacityConfiguration?: IndexCapacityConfiguration;
  1941. /**
  1942. * Configuration information for document attributes or metadata. Document metadata are fields associated with your documents. For example, the company department name associated with each document. For more information, see Understanding document attributes.
  1943. */
  1944. documentAttributeConfigurations?: DocumentAttributeConfigurations;
  1945. /**
  1946. * When the Status field value is FAILED, the ErrorMessage field contains a message that explains why.
  1947. */
  1948. error?: ErrorDetail;
  1949. /**
  1950. * Provides information about the number of documents indexed.
  1951. */
  1952. indexStatistics?: IndexStatistics;
  1953. }
  1954. export interface GetPluginRequest {
  1955. /**
  1956. * The identifier of the application which contains the plugin.
  1957. */
  1958. applicationId: ApplicationId;
  1959. /**
  1960. * The identifier of the plugin.
  1961. */
  1962. pluginId: PluginId;
  1963. }
  1964. export interface GetPluginResponse {
  1965. /**
  1966. * The identifier of the application which contains the plugin.
  1967. */
  1968. applicationId?: ApplicationId;
  1969. /**
  1970. * The identifier of the plugin.
  1971. */
  1972. pluginId?: PluginId;
  1973. /**
  1974. * The name of the plugin.
  1975. */
  1976. displayName?: PluginName;
  1977. /**
  1978. * The type of the plugin.
  1979. */
  1980. type?: PluginType;
  1981. /**
  1982. * The source URL used for plugin configuration.
  1983. */
  1984. serverUrl?: Url;
  1985. authConfiguration?: PluginAuthConfiguration;
  1986. /**
  1987. * Configuration information required to create a custom plugin.
  1988. */
  1989. customPluginConfiguration?: CustomPluginConfiguration;
  1990. /**
  1991. * The current status of a plugin. A plugin is modified asynchronously.
  1992. */
  1993. buildStatus?: PluginBuildStatus;
  1994. /**
  1995. * The Amazon Resource Name (ARN) of the role with permission to access resources needed to create the plugin.
  1996. */
  1997. pluginArn?: PluginArn;
  1998. /**
  1999. * The current state of the plugin.
  2000. */
  2001. state?: PluginState;
  2002. /**
  2003. * The timestamp for when the plugin was created.
  2004. */
  2005. createdAt?: Timestamp;
  2006. /**
  2007. * The timestamp for when the plugin was last updated.
  2008. */
  2009. updatedAt?: Timestamp;
  2010. }
  2011. export interface GetRetrieverRequest {
  2012. /**
  2013. * The identifier of the Amazon Q Business application using the retriever.
  2014. */
  2015. applicationId: ApplicationId;
  2016. /**
  2017. * The identifier of the retriever.
  2018. */
  2019. retrieverId: RetrieverId;
  2020. }
  2021. export interface GetRetrieverResponse {
  2022. /**
  2023. * The identifier of the Amazon Q Business application using the retriever.
  2024. */
  2025. applicationId?: ApplicationId;
  2026. /**
  2027. * The identifier of the retriever.
  2028. */
  2029. retrieverId?: RetrieverId;
  2030. /**
  2031. * The Amazon Resource Name (ARN) of the IAM role associated with the retriever.
  2032. */
  2033. retrieverArn?: RetrieverArn;
  2034. /**
  2035. * The type of the retriever.
  2036. */
  2037. type?: RetrieverType;
  2038. /**
  2039. * The status of the retriever.
  2040. */
  2041. status?: RetrieverStatus;
  2042. /**
  2043. * The name of the retriever.
  2044. */
  2045. displayName?: RetrieverName;
  2046. configuration?: RetrieverConfiguration;
  2047. /**
  2048. * The Amazon Resource Name (ARN) of the role with the permission to access the retriever and required resources.
  2049. */
  2050. roleArn?: RoleArn;
  2051. /**
  2052. * The Unix timestamp when the retriever was created.
  2053. */
  2054. createdAt?: Timestamp;
  2055. /**
  2056. * The Unix timestamp when the retriever was last updated.
  2057. */
  2058. updatedAt?: Timestamp;
  2059. }
  2060. export interface GetUserRequest {
  2061. /**
  2062. * The identifier of the application connected to the user.
  2063. */
  2064. applicationId: ApplicationId;
  2065. /**
  2066. * The user email address attached to the user.
  2067. */
  2068. userId: String;
  2069. }
  2070. export interface GetUserResponse {
  2071. /**
  2072. * A list of user aliases attached to a user.
  2073. */
  2074. userAliases?: UserAliases;
  2075. }
  2076. export interface GetWebExperienceRequest {
  2077. /**
  2078. * The identifier of the Amazon Q Business application linked to the web experience.
  2079. */
  2080. applicationId: ApplicationId;
  2081. /**
  2082. * The identifier of the Amazon Q Business web experience.
  2083. */
  2084. webExperienceId: WebExperienceId;
  2085. }
  2086. export interface GetWebExperienceResponse {
  2087. /**
  2088. * The identifier of the Amazon Q Business application linked to the web experience.
  2089. */
  2090. applicationId?: ApplicationId;
  2091. /**
  2092. * The identifier of the Amazon Q Business web experience.
  2093. */
  2094. webExperienceId?: WebExperienceId;
  2095. /**
  2096. * The Amazon Resource Name (ARN) of the role with the permission to access the Amazon Q Business web experience and required resources.
  2097. */
  2098. webExperienceArn?: WebExperienceArn;
  2099. /**
  2100. * The endpoint of your Amazon Q Business web experience.
  2101. */
  2102. defaultEndpoint?: Url;
  2103. /**
  2104. * The current status of the Amazon Q Business web experience. When the Status field value is FAILED, the ErrorMessage field contains a description of the error that caused the data source connector to fail.
  2105. */
  2106. status?: WebExperienceStatus;
  2107. /**
  2108. * The Unix timestamp when the Amazon Q Business web experience was last created.
  2109. */
  2110. createdAt?: Timestamp;
  2111. /**
  2112. * The Unix timestamp when the Amazon Q Business web experience was last updated.
  2113. */
  2114. updatedAt?: Timestamp;
  2115. /**
  2116. * The title for your Amazon Q Business web experience.
  2117. */
  2118. title?: WebExperienceTitle;
  2119. /**
  2120. * The subtitle for your Amazon Q Business web experience.
  2121. */
  2122. subtitle?: WebExperienceSubtitle;
  2123. /**
  2124. * The customized welcome message for end users of an Amazon Q Business web experience.
  2125. */
  2126. welcomeMessage?: WebExperienceWelcomeMessage;
  2127. /**
  2128. * Determines whether sample prompts are enabled in the web experience for an end user.
  2129. */
  2130. samplePromptsControlMode?: WebExperienceSamplePromptsControlMode;
  2131. /**
  2132. * The Amazon Resource Name (ARN) of the service role attached to your web experience.
  2133. */
  2134. roleArn?: RoleArn;
  2135. /**
  2136. * The authentication configuration information for your Amazon Q Business web experience.
  2137. */
  2138. authenticationConfiguration?: WebExperienceAuthConfiguration;
  2139. /**
  2140. * When the Status field value is FAILED, the ErrorMessage field contains a description of the error that caused the data source connector to fail.
  2141. */
  2142. error?: ErrorDetail;
  2143. }
  2144. export interface GroupMembers {
  2145. /**
  2146. * A list of sub groups that belong to a group. For example, the sub groups "Research", "Engineering", and "Sales and Marketing" all belong to the group "Company".
  2147. */
  2148. memberGroups?: MemberGroups;
  2149. /**
  2150. * A list of users that belong to a group. For example, a list of interns all belong to the "Interns" group.
  2151. */
  2152. memberUsers?: MemberUsers;
  2153. }
  2154. export type GroupName = string;
  2155. export type GroupStatus = "FAILED"|"SUCCEEDED"|"PROCESSING"|"DELETING"|"DELETED"|string;
  2156. export interface GroupStatusDetail {
  2157. /**
  2158. * The status of a group.
  2159. */
  2160. status?: GroupStatus;
  2161. /**
  2162. * The Unix timestamp when the Amazon Q Business application was last updated.
  2163. */
  2164. lastUpdatedAt?: Timestamp;
  2165. /**
  2166. * The details of an error associated a group status.
  2167. */
  2168. errorDetail?: ErrorDetail;
  2169. }
  2170. export type GroupStatusDetails = GroupStatusDetail[];
  2171. export interface GroupSummary {
  2172. /**
  2173. * The name of the group the summary information is for.
  2174. */
  2175. groupName?: GroupName;
  2176. }
  2177. export type GroupSummaryList = GroupSummary[];
  2178. export interface HookConfiguration {
  2179. /**
  2180. * The condition used for when a Lambda function should be invoked. For example, you can specify a condition that if there are empty date-time values, then Amazon Q Business should invoke a function that inserts the current date-time.
  2181. */
  2182. invocationCondition?: DocumentAttributeCondition;
  2183. /**
  2184. * The Amazon Resource Name (ARN) of a role with permission to run a Lambda function during ingestion. For more information, see IAM roles for Custom Document Enrichment (CDE).
  2185. */
  2186. lambdaArn?: LambdaArn;
  2187. /**
  2188. * Stores the original, raw documents or the structured, parsed documents before and after altering them. For more information, see Data contracts for Lambda functions.
  2189. */
  2190. s3BucketName?: S3BucketName;
  2191. /**
  2192. * The Amazon Resource Name (ARN) of a role with permission to run PreExtractionHookConfiguration and PostExtractionHookConfiguration for altering document metadata and content during the document ingestion process.
  2193. */
  2194. roleArn?: RoleArn;
  2195. }
  2196. export type IdcApplicationArn = string;
  2197. export interface Index {
  2198. /**
  2199. * The name of the index.
  2200. */
  2201. displayName?: IndexName;
  2202. /**
  2203. * The identifier for the index.
  2204. */
  2205. indexId?: IndexId;
  2206. /**
  2207. * The Unix timestamp when the index was created.
  2208. */
  2209. createdAt?: Timestamp;
  2210. /**
  2211. * The Unix timestamp when the index was last updated.
  2212. */
  2213. updatedAt?: Timestamp;
  2214. /**
  2215. * The current status of the index. When the status is ACTIVE, the index is ready.
  2216. */
  2217. status?: IndexStatus;
  2218. }
  2219. export type IndexArn = string;
  2220. export interface IndexCapacityConfiguration {
  2221. /**
  2222. * The number of storage units configured for an Amazon Q Business index.
  2223. */
  2224. units?: IndexCapacityInteger;
  2225. }
  2226. export type IndexCapacityInteger = number;
  2227. export type IndexId = string;
  2228. export type IndexName = string;
  2229. export interface IndexStatistics {
  2230. /**
  2231. * The number of documents indexed.
  2232. */
  2233. textDocumentStatistics?: TextDocumentStatistics;
  2234. }
  2235. export type IndexStatus = "CREATING"|"ACTIVE"|"DELETING"|"FAILED"|"UPDATING"|string;
  2236. export type IndexType = "ENTERPRISE"|"STARTER"|string;
  2237. export type IndexedTextBytes = number;
  2238. export type IndexedTextDocument = number;
  2239. export type Indices = Index[];
  2240. export interface InlineDocumentEnrichmentConfiguration {
  2241. condition?: DocumentAttributeCondition;
  2242. target?: DocumentAttributeTarget;
  2243. /**
  2244. * TRUE to delete content if the condition used for the target attribute is met.
  2245. */
  2246. documentContentOperator?: DocumentContentOperator;
  2247. }
  2248. export type InlineDocumentEnrichmentConfigurations = InlineDocumentEnrichmentConfiguration[];
  2249. export type InstanceArn = string;
  2250. export type Integer = number;
  2251. export interface KendraIndexConfiguration {
  2252. /**
  2253. * The identifier of the Amazon Kendra index.
  2254. */
  2255. indexId: KendraIndexId;
  2256. }
  2257. export type KendraIndexId = string;
  2258. export type KmsKeyId = string;
  2259. export type LambdaArn = string;
  2260. export interface ListApplicationsRequest {
  2261. /**
  2262. * If the maxResults response was incomplete because there is more data to retrieve, Amazon Q Business returns a pagination token in the response. You can use this pagination token to retrieve the next set of Amazon Q Business applications.
  2263. */
  2264. nextToken?: NextToken;
  2265. /**
  2266. * The maximum number of Amazon Q Business applications to return.
  2267. */
  2268. maxResults?: MaxResultsIntegerForListApplications;
  2269. }
  2270. export interface ListApplicationsResponse {
  2271. /**
  2272. * If the response is truncated, Amazon Q Business returns this token. You can use this token in a subsequent request to retrieve the next set of applications.
  2273. */
  2274. nextToken?: NextToken;
  2275. /**
  2276. * An array of summary information on the configuration of one or more Amazon Q Business applications.
  2277. */
  2278. applications?: Applications;
  2279. }
  2280. export interface ListConversationsRequest {
  2281. /**
  2282. * The identifier of the Amazon Q Business application.
  2283. */
  2284. applicationId: ApplicationId;
  2285. /**
  2286. * The identifier of the user involved in the Amazon Q Business web experience conversation.
  2287. */
  2288. userId?: UserId;
  2289. /**
  2290. * If the maxResults response was incomplete because there is more data to retrieve, Amazon Q Business returns a pagination token in the response. You can use this pagination token to retrieve the next set of Amazon Q Business conversations.
  2291. */
  2292. nextToken?: NextToken;
  2293. /**
  2294. * The maximum number of Amazon Q Business conversations to return.
  2295. */
  2296. maxResults?: MaxResultsIntegerForListConversations;
  2297. }
  2298. export interface ListConversationsResponse {
  2299. /**
  2300. * If the response is truncated, Amazon Q Business returns this token, which you can use in a later request to list the next set of messages.
  2301. */
  2302. nextToken?: NextToken;
  2303. /**
  2304. * An array of summary information on the configuration of one or more Amazon Q Business web experiences.
  2305. */
  2306. conversations?: Conversations;
  2307. }
  2308. export interface ListDataSourceSyncJobsRequest {
  2309. /**
  2310. * The identifier of the data source connector.
  2311. */
  2312. dataSourceId: DataSourceId;
  2313. /**
  2314. * The identifier of the Amazon Q Business application connected to the data source.
  2315. */
  2316. applicationId: ApplicationId;
  2317. /**
  2318. * The identifier of the index used with the Amazon Q Business data source connector.
  2319. */
  2320. indexId: IndexId;
  2321. /**
  2322. * If the maxResults response was incpmplete because there is more data to retriever, Amazon Q Business returns a pagination token in the response. You can use this pagination token to retrieve the next set of responses.
  2323. */
  2324. nextToken?: NextToken;
  2325. /**
  2326. * The maximum number of synchronization jobs to return in the response.
  2327. */
  2328. maxResults?: MaxResultsIntegerForListDataSourcesSyncJobs;
  2329. /**
  2330. * The start time of the data source connector sync.
  2331. */
  2332. startTime?: Timestamp;
  2333. /**
  2334. * The end time of the data source connector sync.
  2335. */
  2336. endTime?: Timestamp;
  2337. /**
  2338. * Only returns synchronization jobs with the Status field equal to the specified status.
  2339. */
  2340. statusFilter?: DataSourceSyncJobStatus;
  2341. }
  2342. export interface ListDataSourceSyncJobsResponse {
  2343. /**
  2344. * A history of synchronization jobs for the data source connector.
  2345. */
  2346. history?: DataSourceSyncJobs;
  2347. /**
  2348. * If the response is truncated, Amazon Q Business returns this token. You can use this token in any subsequent request to retrieve the next set of jobs.
  2349. */
  2350. nextToken?: NextToken;
  2351. }
  2352. export interface ListDataSourcesRequest {
  2353. /**
  2354. * The identifier of the Amazon Q Business application linked to the data source connectors.
  2355. */
  2356. applicationId: ApplicationId;
  2357. /**
  2358. * The identifier of the index used with one or more data source connectors.
  2359. */
  2360. indexId: IndexId;
  2361. /**
  2362. * If the maxResults response was incomplete because there is more data to retrieve, Amazon Q Business returns a pagination token in the response. You can use this pagination token to retrieve the next set of Amazon Q Business data source connectors.
  2363. */
  2364. nextToken?: NextToken;
  2365. /**
  2366. * The maximum number of data source connectors to return.
  2367. */
  2368. maxResults?: MaxResultsIntegerForListDataSources;
  2369. }
  2370. export interface ListDataSourcesResponse {
  2371. /**
  2372. * An array of summary information for one or more data source connector.
  2373. */
  2374. dataSources?: DataSources;
  2375. /**
  2376. * If the response is truncated, Amazon Q Business returns this token. You can use this token in a subsequent request to retrieve the next set of data source connectors.
  2377. */
  2378. nextToken?: NextToken;
  2379. }
  2380. export interface ListDocumentsRequest {
  2381. /**
  2382. * The identifier of the application id the documents are attached to.
  2383. */
  2384. applicationId: ApplicationId;
  2385. /**
  2386. * The identifier of the index the documents are attached to.
  2387. */
  2388. indexId: IndexId;
  2389. /**
  2390. * The identifier of the data sources the documents are attached to.
  2391. */
  2392. dataSourceIds?: DataSourceIds;
  2393. /**
  2394. * If the maxResults response was incomplete because there is more data to retrieve, Amazon Q Business returns a pagination token in the response. You can use this pagination token to retrieve the next set of documents.
  2395. */
  2396. nextToken?: NextToken;
  2397. /**
  2398. * The maximum number of documents to return.
  2399. */
  2400. maxResults?: MaxResultsIntegerForListDocuments;
  2401. }
  2402. export interface ListDocumentsResponse {
  2403. /**
  2404. * A list of document details.
  2405. */
  2406. documentDetailList?: DocumentDetailList;
  2407. /**
  2408. * If the maxResults response was incomplete because there is more data to retrieve, Amazon Q Business returns a pagination token in the response. You can use this pagination token to retrieve the next set of documents.
  2409. */
  2410. nextToken?: NextToken;
  2411. }
  2412. export interface ListGroupsRequest {
  2413. /**
  2414. * The identifier of the application for getting a list of groups mapped to users.
  2415. */
  2416. applicationId: ApplicationId;
  2417. /**
  2418. * The identifier of the index for getting a list of groups mapped to users.
  2419. */
  2420. indexId: IndexId;
  2421. /**
  2422. * The timestamp identifier used for the latest PUT or DELETE action for mapping users to their groups.
  2423. */
  2424. updatedEarlierThan: Timestamp;
  2425. /**
  2426. * The identifier of the data source for getting a list of groups mapped to users.
  2427. */
  2428. dataSourceId?: DataSourceId;
  2429. /**
  2430. * If the previous response was incomplete (because there is more data to retrieve), Amazon Q Business returns a pagination token in the response. You can use this pagination token to retrieve the next set of groups that are mapped to users.
  2431. */
  2432. nextToken?: NextToken;
  2433. /**
  2434. * The maximum number of returned groups that are mapped to users.
  2435. */
  2436. maxResults?: MaxResultsIntegerForListGroupsRequest;
  2437. }
  2438. export interface ListGroupsResponse {
  2439. /**
  2440. * If the response is truncated, Amazon Q Business returns this token that you can use in the subsequent request to retrieve the next set of groups that are mapped to users.
  2441. */
  2442. nextToken?: NextToken;
  2443. /**
  2444. * Summary information for list of groups that are mapped to users.
  2445. */
  2446. items?: GroupSummaryList;
  2447. }
  2448. export interface ListIndicesRequest {
  2449. /**
  2450. * The identifier of the Amazon Q Business application connected to the index.
  2451. */
  2452. applicationId: ApplicationId;
  2453. /**
  2454. * If the maxResults response was incomplete because there is more data to retrieve, Amazon Q Business returns a pagination token in the response. You can use this pagination token to retrieve the next set of Amazon Q Business indices.
  2455. */
  2456. nextToken?: NextToken;
  2457. /**
  2458. * The maximum number of indices to return.
  2459. */
  2460. maxResults?: MaxResultsIntegerForListIndices;
  2461. }
  2462. export interface ListIndicesResponse {
  2463. /**
  2464. * If the response is truncated, Amazon Q Business returns this token that you can use in the subsequent request to retrieve the next set of indexes.
  2465. */
  2466. nextToken?: NextToken;
  2467. /**
  2468. * An array of information on the items in one or more indexes.
  2469. */
  2470. indices?: Indices;
  2471. }
  2472. export interface ListMessagesRequest {
  2473. /**
  2474. * The identifier of the Amazon Q Business web experience conversation.
  2475. */
  2476. conversationId: ConversationId;
  2477. /**
  2478. * The identifier for the Amazon Q Business application.
  2479. */
  2480. applicationId: ApplicationId;
  2481. /**
  2482. * The identifier of the user involved in the Amazon Q Business web experience conversation.
  2483. */
  2484. userId?: UserId;
  2485. /**
  2486. * If the number of retrievers returned exceeds maxResults, Amazon Q Business returns a next token as a pagination token to retrieve the next set of messages.
  2487. */
  2488. nextToken?: NextToken;
  2489. /**
  2490. * The maximum number of messages to return.
  2491. */
  2492. maxResults?: MaxResultsIntegerForListMessages;
  2493. }
  2494. export interface ListMessagesResponse {
  2495. /**
  2496. * An array of information on one or more messages.
  2497. */
  2498. messages?: Messages;
  2499. /**
  2500. * If the response is truncated, Amazon Q Business returns this token, which you can use in a later request to list the next set of messages.
  2501. */
  2502. nextToken?: NextToken;
  2503. }
  2504. export interface ListPluginsRequest {
  2505. /**
  2506. * The identifier of the application the plugin is attached to.
  2507. */
  2508. applicationId: ApplicationId;
  2509. /**
  2510. * If the maxResults response was incomplete because there is more data to retrieve, Amazon Q Business returns a pagination token in the response. You can use this pagination token to retrieve the next set of plugins.
  2511. */
  2512. nextToken?: NextToken;
  2513. /**
  2514. * The maximum number of documents to return.
  2515. */
  2516. maxResults?: MaxResultsIntegerForListPlugins;
  2517. }
  2518. export interface ListPluginsResponse {
  2519. /**
  2520. * If the maxResults response was incomplete because there is more data to retrieve, Amazon Q Business returns a pagination token in the response. You can use this pagination token to retrieve the next set of plugins.
  2521. */
  2522. nextToken?: NextToken;
  2523. /**
  2524. * Information about a configured plugin.
  2525. */
  2526. plugins?: Plugins;
  2527. }
  2528. export interface ListRetrieversRequest {
  2529. /**
  2530. * The identifier of the Amazon Q Business application using the retriever.
  2531. */
  2532. applicationId: ApplicationId;
  2533. /**
  2534. * If the number of retrievers returned exceeds maxResults, Amazon Q Business returns a next token as a pagination token to retrieve the next set of retrievers.
  2535. */
  2536. nextToken?: NextToken;
  2537. /**
  2538. * The maximum number of retrievers returned.
  2539. */
  2540. maxResults?: MaxResultsIntegerForListRetrieversRequest;
  2541. }
  2542. export interface ListRetrieversResponse {
  2543. /**
  2544. * An array of summary information for one or more retrievers.
  2545. */
  2546. retrievers?: Retrievers;
  2547. /**
  2548. * If the response is truncated, Amazon Q Business returns this token, which you can use in a later request to list the next set of retrievers.
  2549. */
  2550. nextToken?: NextToken;
  2551. }
  2552. export interface ListTagsForResourceRequest {
  2553. /**
  2554. * The Amazon Resource Name (ARN) of the Amazon Q Business application or data source to get a list of tags for.
  2555. */
  2556. resourceARN: AmazonResourceName;
  2557. }
  2558. export interface ListTagsForResourceResponse {
  2559. /**
  2560. * A list of tags associated with the Amazon Q Business application or data source.
  2561. */
  2562. tags?: Tags;
  2563. }
  2564. export interface ListWebExperiencesRequest {
  2565. /**
  2566. * The identifier of the Amazon Q Business application linked to the listed web experiences.
  2567. */
  2568. applicationId: ApplicationId;
  2569. /**
  2570. * If the maxResults response was incomplete because there is more data to retrieve, Amazon Q Business returns a pagination token in the response. You can use this pagination token to retrieve the next set of Amazon Q Business conversations.
  2571. */
  2572. nextToken?: NextToken;
  2573. /**
  2574. * The maximum number of Amazon Q Business Web Experiences to return.
  2575. */
  2576. maxResults?: MaxResultsIntegerForListWebExperiencesRequest;
  2577. }
  2578. export interface ListWebExperiencesResponse {
  2579. /**
  2580. * An array of summary information for one or more Amazon Q Business experiences.
  2581. */
  2582. webExperiences?: WebExperiences;
  2583. /**
  2584. * If the response is truncated, Amazon Q Business returns this token, which you can use in a later request to list the next set of messages.
  2585. */
  2586. nextToken?: NextToken;
  2587. }
  2588. export type Long = number;
  2589. export type MaxResultsIntegerForGetTopicConfigurations = number;
  2590. export type MaxResultsIntegerForListApplications = number;
  2591. export type MaxResultsIntegerForListConversations = number;
  2592. export type MaxResultsIntegerForListDataSources = number;
  2593. export type MaxResultsIntegerForListDataSourcesSyncJobs = number;
  2594. export type MaxResultsIntegerForListDocuments = number;
  2595. export type MaxResultsIntegerForListGroupsRequest = number;
  2596. export type MaxResultsIntegerForListIndices = number;
  2597. export type MaxResultsIntegerForListMessages = number;
  2598. export type MaxResultsIntegerForListPlugins = number;
  2599. export type MaxResultsIntegerForListRetrieversRequest = number;
  2600. export type MaxResultsIntegerForListWebExperiencesRequest = number;
  2601. export interface MemberGroup {
  2602. /**
  2603. * The name of the sub group.
  2604. */
  2605. groupName: GroupName;
  2606. /**
  2607. * The type of the sub group.
  2608. */
  2609. type?: MembershipType;
  2610. }
  2611. export type MemberGroups = MemberGroup[];
  2612. export type MemberRelation = "AND"|"OR"|string;
  2613. export interface MemberUser {
  2614. /**
  2615. * The identifier of the user you want to map to a group.
  2616. */
  2617. userId: DataSourceUserId;
  2618. /**
  2619. * The type of the user.
  2620. */
  2621. type?: MembershipType;
  2622. }
  2623. export type MemberUsers = MemberUser[];
  2624. export type MembershipType = "INDEX"|"DATASOURCE"|string;
  2625. export interface Message {
  2626. /**
  2627. * The identifier of the Amazon Q Business web experience message.
  2628. */
  2629. messageId?: String;
  2630. /**
  2631. * The content of the Amazon Q Business web experience message.
  2632. */
  2633. body?: MessageBody;
  2634. /**
  2635. * The timestamp of the first Amazon Q Business web experience message.
  2636. */
  2637. time?: Timestamp;
  2638. /**
  2639. * The type of Amazon Q Business message, whether HUMAN or AI generated.
  2640. */
  2641. type?: MessageType;
  2642. /**
  2643. * A file directly uploaded into an Amazon Q Business web experience chat.
  2644. */
  2645. attachments?: AttachmentsOutput;
  2646. /**
  2647. * The source documents used to generate Amazon Q Business web experience message.
  2648. */
  2649. sourceAttribution?: SourceAttributions;
  2650. actionReview?: ActionReview;
  2651. actionExecution?: ActionExecution;
  2652. }
  2653. export type MessageBody = string;
  2654. export type MessageId = string;
  2655. export type MessageType = "USER"|"SYSTEM"|string;
  2656. export type MessageUsefulness = "USEFUL"|"NOT_USEFUL"|string;
  2657. export type MessageUsefulnessComment = string;
  2658. export interface MessageUsefulnessFeedback {
  2659. /**
  2660. * The usefulness value assigned by an end user to a message.
  2661. */
  2662. usefulness: MessageUsefulness;
  2663. /**
  2664. * The reason for a usefulness rating.
  2665. */
  2666. reason?: MessageUsefulnessReason;
  2667. /**
  2668. * A comment given by an end user on the usefulness of an AI-generated chat message.
  2669. */
  2670. comment?: MessageUsefulnessComment;
  2671. /**
  2672. * The timestamp for when the feedback was submitted.
  2673. */
  2674. submittedAt: Timestamp;
  2675. }
  2676. export type MessageUsefulnessReason = "NOT_FACTUALLY_CORRECT"|"HARMFUL_OR_UNSAFE"|"INCORRECT_OR_MISSING_SOURCES"|"NOT_HELPFUL"|"FACTUALLY_CORRECT"|"COMPLETE"|"RELEVANT_SOURCES"|"HELPFUL"|"NOT_BASED_ON_DOCUMENTS"|"NOT_COMPLETE"|"NOT_CONCISE"|"OTHER"|string;
  2677. export type Messages = Message[];
  2678. export type MetricValue = string;
  2679. export interface NativeIndexConfiguration {
  2680. /**
  2681. * The identifier for the Amazon Q Business index.
  2682. */
  2683. indexId: IndexId;
  2684. /**
  2685. * Overrides the default boosts applied by Amazon Q Business to supported document attribute data types.
  2686. */
  2687. boostingOverride?: DocumentAttributeBoostingOverrideMap;
  2688. }
  2689. export type NextToken = string;
  2690. export interface NoAuthConfiguration {
  2691. }
  2692. export interface NumberAttributeBoostingConfiguration {
  2693. /**
  2694. * Specifies the duration, in seconds, of a boost applies to a NUMBER type document attribute.
  2695. */
  2696. boostingLevel: DocumentAttributeBoostingLevel;
  2697. /**
  2698. * Specifies how much a document attribute is boosted.
  2699. */
  2700. boostingType?: NumberAttributeBoostingType;
  2701. }
  2702. export type NumberAttributeBoostingType = "PRIORITIZE_LARGER_VALUES"|"PRIORITIZE_SMALLER_VALUES"|string;
  2703. export interface OAuth2ClientCredentialConfiguration {
  2704. /**
  2705. * The ARN of the Secrets Manager secret that stores the OAuth 2.0 credentials/token used for plugin configuration.
  2706. */
  2707. secretArn: SecretArn;
  2708. /**
  2709. * The ARN of an IAM role used by Amazon Q Business to access the OAuth 2.0 authentication credentials stored in a Secrets Manager secret.
  2710. */
  2711. roleArn: RoleArn;
  2712. }
  2713. export type Payload = string;
  2714. export interface Plugin {
  2715. /**
  2716. * The identifier of the plugin.
  2717. */
  2718. pluginId?: PluginId;
  2719. /**
  2720. * The name of the plugin.
  2721. */
  2722. displayName?: PluginName;
  2723. /**
  2724. * The type of the plugin.
  2725. */
  2726. type?: PluginType;
  2727. /**
  2728. * The plugin server URL used for configuration.
  2729. */
  2730. serverUrl?: Url;
  2731. /**
  2732. * The current status of the plugin.
  2733. */
  2734. state?: PluginState;
  2735. /**
  2736. * The status of the plugin.
  2737. */
  2738. buildStatus?: PluginBuildStatus;
  2739. /**
  2740. * The timestamp for when the plugin was created.
  2741. */
  2742. createdAt?: Timestamp;
  2743. /**
  2744. * The timestamp for when the plugin was last updated.
  2745. */
  2746. updatedAt?: Timestamp;
  2747. }
  2748. export type PluginArn = string;
  2749. export interface PluginAuthConfiguration {
  2750. /**
  2751. * Information about the basic authentication credentials used to configure a plugin.
  2752. */
  2753. basicAuthConfiguration?: BasicAuthConfiguration;
  2754. /**
  2755. * Information about the OAuth 2.0 authentication credential/token used to configure a plugin.
  2756. */
  2757. oAuth2ClientCredentialConfiguration?: OAuth2ClientCredentialConfiguration;
  2758. /**
  2759. * Information about invoking a custom plugin without any authentication.
  2760. */
  2761. noAuthConfiguration?: NoAuthConfiguration;
  2762. }
  2763. export type PluginBuildStatus = "READY"|"CREATE_IN_PROGRESS"|"CREATE_FAILED"|"UPDATE_IN_PROGRESS"|"UPDATE_FAILED"|"DELETE_IN_PROGRESS"|"DELETE_FAILED"|string;
  2764. export interface PluginConfiguration {
  2765. /**
  2766. * The identifier of the plugin you want to use.
  2767. */
  2768. pluginId: PluginId;
  2769. }
  2770. export type PluginDescription = string;
  2771. export type PluginId = string;
  2772. export type PluginName = string;
  2773. export type PluginState = "ENABLED"|"DISABLED"|string;
  2774. export type PluginType = "SERVICE_NOW"|"SALESFORCE"|"JIRA"|"ZENDESK"|"CUSTOM"|string;
  2775. export type Plugins = Plugin[];
  2776. export interface Principal {
  2777. /**
  2778. * The user associated with the principal.
  2779. */
  2780. user?: PrincipalUser;
  2781. /**
  2782. * The group associated with the principal.
  2783. */
  2784. group?: PrincipalGroup;
  2785. }
  2786. export interface PrincipalGroup {
  2787. /**
  2788. * The name of the group.
  2789. */
  2790. name?: GroupName;
  2791. /**
  2792. * Provides information about whether to allow or deny access to the principal.
  2793. */
  2794. access: ReadAccessType;
  2795. /**
  2796. * The type of group.
  2797. */
  2798. membershipType?: MembershipType;
  2799. }
  2800. export interface PrincipalUser {
  2801. /**
  2802. * The identifier of the user.
  2803. */
  2804. id?: UserId;
  2805. /**
  2806. * Provides information about whether to allow or deny access to the principal.
  2807. */
  2808. access: ReadAccessType;
  2809. /**
  2810. * The type of group.
  2811. */
  2812. membershipType?: MembershipType;
  2813. }
  2814. export type Principals = Principal[];
  2815. export interface PutFeedbackRequest {
  2816. /**
  2817. * The identifier of the application associated with the feedback.
  2818. */
  2819. applicationId: ApplicationId;
  2820. /**
  2821. * The identifier of the user giving the feedback.
  2822. */
  2823. userId?: UserId;
  2824. /**
  2825. * The identifier of the conversation the feedback is attached to.
  2826. */
  2827. conversationId: ConversationId;
  2828. /**
  2829. * The identifier of the chat message that the feedback was given for.
  2830. */
  2831. messageId: SystemMessageId;
  2832. /**
  2833. * The timestamp for when the feedback was recorded.
  2834. */
  2835. messageCopiedAt?: Timestamp;
  2836. /**
  2837. * The feedback usefulness value given by the user to the chat message.
  2838. */
  2839. messageUsefulness?: MessageUsefulnessFeedback;
  2840. }
  2841. export interface PutGroupRequest {
  2842. /**
  2843. * The identifier of the application in which the user and group mapping belongs.
  2844. */
  2845. applicationId: ApplicationId;
  2846. /**
  2847. * The identifier of the index in which you want to map users to their groups.
  2848. */
  2849. indexId: IndexId;
  2850. /**
  2851. * The list that contains your users or sub groups that belong the same group. For example, the group "Company" includes the user "CEO" and the sub groups "Research", "Engineering", and "Sales and Marketing". If you have more than 1000 users and/or sub groups for a single group, you need to provide the path to the S3 file that lists your users and sub groups for a group. Your sub groups can contain more than 1000 users, but the list of sub groups that belong to a group (and/or users) must be no more than 1000.
  2852. */
  2853. groupName: GroupName;
  2854. /**
  2855. * The identifier of the data source for which you want to map users to their groups. This is useful if a group is tied to multiple data sources, but you only want the group to access documents of a certain data source. For example, the groups "Research", "Engineering", and "Sales and Marketing" are all tied to the company's documents stored in the data sources Confluence and Salesforce. However, "Sales and Marketing" team only needs access to customer-related documents stored in Salesforce.
  2856. */
  2857. dataSourceId?: DataSourceId;
  2858. /**
  2859. * The type of the group.
  2860. */
  2861. type: MembershipType;
  2862. groupMembers: GroupMembers;
  2863. }
  2864. export interface PutGroupResponse {
  2865. }
  2866. export type ReadAccessType = "ALLOW"|"DENY"|string;
  2867. export type ResponseScope = "ENTERPRISE_CONTENT_ONLY"|"EXTENDED_KNOWLEDGE_ENABLED"|string;
  2868. export interface Retriever {
  2869. /**
  2870. * The identifier of the Amazon Q Business application using the retriever.
  2871. */
  2872. applicationId?: ApplicationId;
  2873. /**
  2874. * The identifier of the retriever used by your Amazon Q Business application.
  2875. */
  2876. retrieverId?: RetrieverId;
  2877. /**
  2878. * The type of your retriever.
  2879. */
  2880. type?: RetrieverType;
  2881. /**
  2882. * The status of your retriever.
  2883. */
  2884. status?: RetrieverStatus;
  2885. /**
  2886. * The name of your retriever.
  2887. */
  2888. displayName?: RetrieverName;
  2889. }
  2890. export type RetrieverArn = string;
  2891. export interface RetrieverConfiguration {
  2892. /**
  2893. * Provides information on how a Amazon Q Business index used as a retriever for your Amazon Q Business application is configured.
  2894. */
  2895. nativeIndexConfiguration?: NativeIndexConfiguration;
  2896. /**
  2897. * Provides information on how the Amazon Kendra index used as a retriever for your Amazon Q Business application is configured.
  2898. */
  2899. kendraIndexConfiguration?: KendraIndexConfiguration;
  2900. }
  2901. export type RetrieverId = string;
  2902. export type RetrieverName = string;
  2903. export type RetrieverStatus = "CREATING"|"ACTIVE"|"FAILED"|string;
  2904. export type RetrieverType = "NATIVE_INDEX"|"KENDRA_INDEX"|string;
  2905. export type Retrievers = Retriever[];
  2906. export type RoleArn = string;
  2907. export interface Rule {
  2908. /**
  2909. * Users and groups to be included in a rule.
  2910. */
  2911. includedUsersAndGroups?: UsersAndGroups;
  2912. /**
  2913. * Users and groups to be excluded from a rule.
  2914. */
  2915. excludedUsersAndGroups?: UsersAndGroups;
  2916. /**
  2917. * The type of rule.
  2918. */
  2919. ruleType: RuleType;
  2920. /**
  2921. * The configuration information for a rule.
  2922. */
  2923. ruleConfiguration?: RuleConfiguration;
  2924. }
  2925. export interface RuleConfiguration {
  2926. /**
  2927. * A rule for configuring how Amazon Q Business responds when it encounters a a blocked topic.
  2928. */
  2929. contentBlockerRule?: ContentBlockerRule;
  2930. contentRetrievalRule?: ContentRetrievalRule;
  2931. }
  2932. export type RuleType = "CONTENT_BLOCKER_RULE"|"CONTENT_RETRIEVAL_RULE"|string;
  2933. export type Rules = Rule[];
  2934. export interface S3 {
  2935. /**
  2936. * The name of the S3 bucket that contains the file.
  2937. */
  2938. bucket: S3BucketName;
  2939. /**
  2940. * The name of the file.
  2941. */
  2942. key: S3ObjectKey;
  2943. }
  2944. export type S3BucketName = string;
  2945. export type S3ObjectKey = string;
  2946. export type SamlAttribute = string;
  2947. export interface SamlConfiguration {
  2948. /**
  2949. * The metadata XML that your IdP generated.
  2950. */
  2951. metadataXML: SamlMetadataXML;
  2952. /**
  2953. * The Amazon Resource Name (ARN) of an IAM role assumed by users when they authenticate into their Amazon Q Business web experience, containing the relevant Amazon Q Business permissions for conversing with Amazon Q Business.
  2954. */
  2955. roleArn: RoleArn;
  2956. /**
  2957. * The user attribute name in your IdP that maps to the user email.
  2958. */
  2959. userIdAttribute: SamlAttribute;
  2960. /**
  2961. * The group attribute name in your IdP that maps to user groups.
  2962. */
  2963. userGroupAttribute?: SamlAttribute;
  2964. }
  2965. export type SamlMetadataXML = string;
  2966. export type SecretArn = string;
  2967. export type SecurityGroupId = string;
  2968. export type SecurityGroupIds = SecurityGroupId[];
  2969. export interface SnippetExcerpt {
  2970. /**
  2971. * The relevant text excerpt from a source that was used to generate a citation text segment in an Amazon Q chat response.
  2972. */
  2973. text?: SnippetExcerptText;
  2974. }
  2975. export type SnippetExcerptText = string;
  2976. export interface SourceAttribution {
  2977. /**
  2978. * The title of the document which is the source for the Amazon Q Business generated response.
  2979. */
  2980. title?: String;
  2981. /**
  2982. * The content extract from the document on which the generated response is based.
  2983. */
  2984. snippet?: String;
  2985. /**
  2986. * The URL of the document which is the source for the Amazon Q Business generated response.
  2987. */
  2988. url?: String;
  2989. /**
  2990. * The number attached to a citation in an Amazon Q Business generated response.
  2991. */
  2992. citationNumber?: Integer;
  2993. /**
  2994. * The Unix timestamp when the Amazon Q Business application was last updated.
  2995. */
  2996. updatedAt?: Timestamp;
  2997. /**
  2998. * A text extract from a source document that is used for source attribution.
  2999. */
  3000. textMessageSegments?: TextSegmentList;
  3001. }
  3002. export type SourceAttributions = SourceAttribution[];
  3003. export interface StartDataSourceSyncJobRequest {
  3004. /**
  3005. * The identifier of the data source connector.
  3006. */
  3007. dataSourceId: DataSourceId;
  3008. /**
  3009. * The identifier of Amazon Q Business application the data source is connected to.
  3010. */
  3011. applicationId: ApplicationId;
  3012. /**
  3013. * The identifier of the index used with the data source connector.
  3014. */
  3015. indexId: IndexId;
  3016. }
  3017. export interface StartDataSourceSyncJobResponse {
  3018. /**
  3019. * The identifier for a particular synchronization job.
  3020. */
  3021. executionId?: ExecutionId;
  3022. }
  3023. export type Status = "ENABLED"|"DISABLED"|string;
  3024. export interface StopDataSourceSyncJobRequest {
  3025. /**
  3026. * The identifier of the data source connector.
  3027. */
  3028. dataSourceId: DataSourceId;
  3029. /**
  3030. * The identifier of the Amazon Q Business application that the data source is connected to.
  3031. */
  3032. applicationId: ApplicationId;
  3033. /**
  3034. * The identifier of the index used with the Amazon Q Business data source connector.
  3035. */
  3036. indexId: IndexId;
  3037. }
  3038. export interface StopDataSourceSyncJobResponse {
  3039. }
  3040. export type String = string;
  3041. export interface StringAttributeBoostingConfiguration {
  3042. /**
  3043. * Specifies how much a document attribute is boosted.
  3044. */
  3045. boostingLevel: DocumentAttributeBoostingLevel;
  3046. /**
  3047. * Specifies specific values of a STRING type document attribute being boosted.
  3048. */
  3049. attributeValueBoosting?: StringAttributeValueBoosting;
  3050. }
  3051. export type StringAttributeValueBoosting = {[key: string]: StringAttributeValueBoostingLevel};
  3052. export type StringAttributeValueBoostingLevel = "LOW"|"MEDIUM"|"HIGH"|"VERY_HIGH"|string;
  3053. export interface StringListAttributeBoostingConfiguration {
  3054. /**
  3055. * Specifies how much a document attribute is boosted.
  3056. */
  3057. boostingLevel: DocumentAttributeBoostingLevel;
  3058. }
  3059. export type SubnetId = string;
  3060. export type SubnetIds = SubnetId[];
  3061. export type SyncSchedule = string;
  3062. export type SystemMessageId = string;
  3063. export type SystemMessageOverride = string;
  3064. export interface Tag {
  3065. /**
  3066. * The key for the tag. Keys are not case sensitive and must be unique for the Amazon Q Business application or data source.
  3067. */
  3068. key: TagKey;
  3069. /**
  3070. * The value associated with the tag. The value may be an empty string but it can't be null.
  3071. */
  3072. value: TagValue;
  3073. }
  3074. export type TagKey = string;
  3075. export type TagKeys = TagKey[];
  3076. export interface TagResourceRequest {
  3077. /**
  3078. * The Amazon Resource Name (ARN) of the Amazon Q Business application or data source to tag.
  3079. */
  3080. resourceARN: AmazonResourceName;
  3081. /**
  3082. * A list of tag keys to add to the Amazon Q Business application or data source. If a tag already exists, the existing value is replaced with the new value.
  3083. */
  3084. tags: Tags;
  3085. }
  3086. export interface TagResourceResponse {
  3087. }
  3088. export type TagValue = string;
  3089. export type Tags = Tag[];
  3090. export interface TextDocumentStatistics {
  3091. /**
  3092. * The total size, in bytes, of the indexed documents.
  3093. */
  3094. indexedTextBytes?: IndexedTextBytes;
  3095. /**
  3096. * The number of text documents indexed.
  3097. */
  3098. indexedTextDocumentCount?: IndexedTextDocument;
  3099. }
  3100. export interface TextSegment {
  3101. /**
  3102. * The zero-based location in the response string where the source attribution starts.
  3103. */
  3104. beginOffset?: Integer;
  3105. /**
  3106. * The zero-based location in the response string where the source attribution ends.
  3107. */
  3108. endOffset?: Integer;
  3109. /**
  3110. * The relevant text excerpt from a source that was used to generate a citation text segment in an Amazon Q Business chat response.
  3111. */
  3112. snippetExcerpt?: SnippetExcerpt;
  3113. }
  3114. export type TextSegmentList = TextSegment[];
  3115. export type Timestamp = Date;
  3116. export type Title = string;
  3117. export interface TopicConfiguration {
  3118. /**
  3119. * A name for your topic control configuration.
  3120. */
  3121. name: TopicConfigurationName;
  3122. /**
  3123. * A description for your topic control configuration. Use this to outline how the large language model (LLM) should use this topic control configuration.
  3124. */
  3125. description?: TopicDescription;
  3126. /**
  3127. * A list of example phrases that you expect the end user to use in relation to the topic.
  3128. */
  3129. exampleChatMessages?: ExampleChatMessages;
  3130. /**
  3131. * Rules defined for a topic configuration.
  3132. */
  3133. rules: Rules;
  3134. }
  3135. export type TopicConfigurationName = string;
  3136. export type TopicConfigurations = TopicConfiguration[];
  3137. export type TopicDescription = string;
  3138. export interface UntagResourceRequest {
  3139. /**
  3140. * The Amazon Resource Name (ARN) of the Amazon Q Business application, or data source to remove the tag from.
  3141. */
  3142. resourceARN: AmazonResourceName;
  3143. /**
  3144. * A list of tag keys to remove from the Amazon Q Business application or data source. If a tag key does not exist on the resource, it is ignored.
  3145. */
  3146. tagKeys: TagKeys;
  3147. }
  3148. export interface UntagResourceResponse {
  3149. }
  3150. export interface UpdateApplicationRequest {
  3151. /**
  3152. * The identifier of the Amazon Q Business application.
  3153. */
  3154. applicationId: ApplicationId;
  3155. /**
  3156. * The Amazon Resource Name (ARN) of the IAM Identity Center instance you are either creating for—or connecting to—your Amazon Q Business application.
  3157. */
  3158. identityCenterInstanceArn?: InstanceArn;
  3159. /**
  3160. * A name for the Amazon Q Business application.
  3161. */
  3162. displayName?: ApplicationName;
  3163. /**
  3164. * A description for the Amazon Q Business application.
  3165. */
  3166. description?: Description;
  3167. /**
  3168. * An Amazon Web Services Identity and Access Management (IAM) role that gives Amazon Q Business permission to access Amazon CloudWatch logs and metrics.
  3169. */
  3170. roleArn?: RoleArn;
  3171. /**
  3172. * An option to allow end users to upload files directly during chat.
  3173. */
  3174. attachmentsConfiguration?: AttachmentsConfiguration;
  3175. }
  3176. export interface UpdateApplicationResponse {
  3177. }
  3178. export interface UpdateChatControlsConfigurationRequest {
  3179. /**
  3180. * The identifier of the application for which the chat controls are configured.
  3181. */
  3182. applicationId: ApplicationId;
  3183. /**
  3184. * A token that you provide to identify the request to update a Amazon Q Business application chat configuration.
  3185. */
  3186. clientToken?: ClientToken;
  3187. /**
  3188. * The response scope configured for your application. This determines whether your application uses its retrieval augmented generation (RAG) system to generate answers only from your enterprise data, or also uses the large language models (LLM) knowledge to respons to end user questions in chat.
  3189. */
  3190. responseScope?: ResponseScope;
  3191. /**
  3192. * The phrases blocked from chat by your chat control configuration.
  3193. */
  3194. blockedPhrasesConfigurationUpdate?: BlockedPhrasesConfigurationUpdate;
  3195. /**
  3196. * The configured topic specific chat controls you want to update.
  3197. */
  3198. topicConfigurationsToCreateOrUpdate?: TopicConfigurations;
  3199. /**
  3200. * The configured topic specific chat controls you want to delete.
  3201. */
  3202. topicConfigurationsToDelete?: TopicConfigurations;
  3203. /**
  3204. * The configuration details for CREATOR_MODE.
  3205. */
  3206. creatorModeConfiguration?: CreatorModeConfiguration;
  3207. }
  3208. export interface UpdateChatControlsConfigurationResponse {
  3209. }
  3210. export interface UpdateDataSourceRequest {
  3211. /**
  3212. * The identifier of the Amazon Q Business application the data source is attached to.
  3213. */
  3214. applicationId: ApplicationId;
  3215. /**
  3216. * The identifier of the index attached to the data source connector.
  3217. */
  3218. indexId: IndexId;
  3219. /**
  3220. * The identifier of the data source connector.
  3221. */
  3222. dataSourceId: DataSourceId;
  3223. /**
  3224. * A name of the data source connector.
  3225. */
  3226. displayName?: DataSourceName;
  3227. configuration?: DataSourceConfiguration;
  3228. vpcConfiguration?: DataSourceVpcConfiguration;
  3229. /**
  3230. * The description of the data source connector.
  3231. */
  3232. description?: Description;
  3233. /**
  3234. * The chosen update frequency for your data source.
  3235. */
  3236. syncSchedule?: SyncSchedule;
  3237. /**
  3238. * The Amazon Resource Name (ARN) of an IAM role with permission to access the data source and required resources.
  3239. */
  3240. roleArn?: RoleArn;
  3241. documentEnrichmentConfiguration?: DocumentEnrichmentConfiguration;
  3242. }
  3243. export interface UpdateDataSourceResponse {
  3244. }
  3245. export interface UpdateIndexRequest {
  3246. /**
  3247. * The identifier of the Amazon Q Business application connected to the index.
  3248. */
  3249. applicationId: ApplicationId;
  3250. /**
  3251. * The identifier of the Amazon Q Business index.
  3252. */
  3253. indexId: IndexId;
  3254. /**
  3255. * The name of the Amazon Q Business index.
  3256. */
  3257. displayName?: ApplicationName;
  3258. /**
  3259. * The description of the Amazon Q Business index.
  3260. */
  3261. description?: Description;
  3262. /**
  3263. * The storage capacity units you want to provision for your Amazon Q Business index. You can add and remove capacity to fit your usage needs.
  3264. */
  3265. capacityConfiguration?: IndexCapacityConfiguration;
  3266. /**
  3267. * Configuration information for document metadata or fields. Document metadata are fields or attributes associated with your documents. For example, the company department name associated with each document. For more information, see Understanding document attributes.
  3268. */
  3269. documentAttributeConfigurations?: DocumentAttributeConfigurations;
  3270. }
  3271. export interface UpdateIndexResponse {
  3272. }
  3273. export interface UpdatePluginRequest {
  3274. /**
  3275. * The identifier of the application the plugin is attached to.
  3276. */
  3277. applicationId: ApplicationId;
  3278. /**
  3279. * The identifier of the plugin.
  3280. */
  3281. pluginId: PluginId;
  3282. /**
  3283. * The name of the plugin.
  3284. */
  3285. displayName?: PluginName;
  3286. /**
  3287. * The status of the plugin.
  3288. */
  3289. state?: PluginState;
  3290. /**
  3291. * The source URL used for plugin configuration.
  3292. */
  3293. serverUrl?: Url;
  3294. /**
  3295. * The configuration for a custom plugin.
  3296. */
  3297. customPluginConfiguration?: CustomPluginConfiguration;
  3298. /**
  3299. * The authentication configuration the plugin is using.
  3300. */
  3301. authConfiguration?: PluginAuthConfiguration;
  3302. }
  3303. export interface UpdatePluginResponse {
  3304. }
  3305. export interface UpdateRetrieverRequest {
  3306. /**
  3307. * The identifier of your Amazon Q Business application.
  3308. */
  3309. applicationId: ApplicationId;
  3310. /**
  3311. * The identifier of your retriever.
  3312. */
  3313. retrieverId: RetrieverId;
  3314. configuration?: RetrieverConfiguration;
  3315. /**
  3316. * The name of your retriever.
  3317. */
  3318. displayName?: RetrieverName;
  3319. /**
  3320. * The Amazon Resource Name (ARN) of an IAM role with permission to access the retriever and required resources.
  3321. */
  3322. roleArn?: RoleArn;
  3323. }
  3324. export interface UpdateRetrieverResponse {
  3325. }
  3326. export interface UpdateUserRequest {
  3327. /**
  3328. * The identifier of the application the user is attached to.
  3329. */
  3330. applicationId: ApplicationId;
  3331. /**
  3332. * The email id attached to the user.
  3333. */
  3334. userId: String;
  3335. /**
  3336. * The user aliases attached to the user id that are to be updated.
  3337. */
  3338. userAliasesToUpdate?: UserAliases;
  3339. /**
  3340. * The user aliases attached to the user id that are to be deleted.
  3341. */
  3342. userAliasesToDelete?: UserAliases;
  3343. }
  3344. export interface UpdateUserResponse {
  3345. /**
  3346. * The user aliases that have been to be added to a user id.
  3347. */
  3348. userAliasesAdded?: UserAliases;
  3349. /**
  3350. * The user aliases attached to a user id that have been updated.
  3351. */
  3352. userAliasesUpdated?: UserAliases;
  3353. /**
  3354. * The user aliases that have been deleted from a user id.
  3355. */
  3356. userAliasesDeleted?: UserAliases;
  3357. }
  3358. export interface UpdateWebExperienceRequest {
  3359. /**
  3360. * The identifier of the Amazon Q Business application attached to the web experience.
  3361. */
  3362. applicationId: ApplicationId;
  3363. /**
  3364. * The identifier of the Amazon Q Business web experience.
  3365. */
  3366. webExperienceId: WebExperienceId;
  3367. /**
  3368. * The Amazon Resource Name (ARN) of the role with permission to access the Amazon Q Business web experience and required resources.
  3369. */
  3370. roleArn?: RoleArn;
  3371. /**
  3372. * The authentication configuration of the Amazon Q Business web experience.
  3373. */
  3374. authenticationConfiguration?: WebExperienceAuthConfiguration;
  3375. /**
  3376. * The title of the Amazon Q Business web experience.
  3377. */
  3378. title?: WebExperienceTitle;
  3379. /**
  3380. * The subtitle of the Amazon Q Business web experience.
  3381. */
  3382. subtitle?: WebExperienceSubtitle;
  3383. /**
  3384. * A customized welcome message for an end user in an Amazon Q Business web experience.
  3385. */
  3386. welcomeMessage?: WebExperienceWelcomeMessage;
  3387. /**
  3388. * Determines whether sample prompts are enabled in the web experience for an end user.
  3389. */
  3390. samplePromptsControlMode?: WebExperienceSamplePromptsControlMode;
  3391. }
  3392. export interface UpdateWebExperienceResponse {
  3393. }
  3394. export type Url = string;
  3395. export interface UserAlias {
  3396. /**
  3397. * The identifier of the index that the user aliases are associated with.
  3398. */
  3399. indexId?: IndexId;
  3400. /**
  3401. * The identifier of the data source that the user aliases are associated with.
  3402. */
  3403. dataSourceId?: DataSourceId;
  3404. /**
  3405. * The identifier of the user id associated with the user aliases.
  3406. */
  3407. userId: String;
  3408. }
  3409. export type UserAliases = UserAlias[];
  3410. export type UserGroups = String[];
  3411. export type UserId = string;
  3412. export type UserIds = String[];
  3413. export type UserMessage = string;
  3414. export interface UsersAndGroups {
  3415. /**
  3416. * The user ids associated with a topic control rule.
  3417. */
  3418. userIds?: UserIds;
  3419. /**
  3420. * The user groups associated with a topic control rule.
  3421. */
  3422. userGroups?: UserGroups;
  3423. }
  3424. export interface WebExperience {
  3425. /**
  3426. * The identifier of your Amazon Q Business web experience.
  3427. */
  3428. webExperienceId?: WebExperienceId;
  3429. /**
  3430. * The Unix timestamp when the Amazon Q Business application was last updated.
  3431. */
  3432. createdAt?: Timestamp;
  3433. /**
  3434. * The Unix timestamp when your Amazon Q Business web experience was updated.
  3435. */
  3436. updatedAt?: Timestamp;
  3437. /**
  3438. * The endpoint URLs for your Amazon Q Business web experience. The URLs are unique and fully hosted by Amazon Web Services.
  3439. */
  3440. defaultEndpoint?: Url;
  3441. /**
  3442. * The status of your Amazon Q Business web experience.
  3443. */
  3444. status?: WebExperienceStatus;
  3445. }
  3446. export type WebExperienceArn = string;
  3447. export interface WebExperienceAuthConfiguration {
  3448. samlConfiguration?: SamlConfiguration;
  3449. }
  3450. export type WebExperienceId = string;
  3451. export type WebExperienceSamplePromptsControlMode = "ENABLED"|"DISABLED"|string;
  3452. export type WebExperienceStatus = "CREATING"|"ACTIVE"|"DELETING"|"FAILED"|"PENDING_AUTH_CONFIG"|string;
  3453. export type WebExperienceSubtitle = string;
  3454. export type WebExperienceTitle = string;
  3455. export type WebExperienceWelcomeMessage = string;
  3456. export type WebExperiences = WebExperience[];
  3457. /**
  3458. * A string in YYYY-MM-DD format that represents the latest possible API version that can be used in this service. Specify 'latest' to use the latest possible version.
  3459. */
  3460. export type apiVersion = "2023-11-27"|"latest"|string;
  3461. export interface ClientApiVersions {
  3462. /**
  3463. * A string in YYYY-MM-DD format that represents the latest possible API version that can be used in this service. Specify 'latest' to use the latest possible version.
  3464. */
  3465. apiVersion?: apiVersion;
  3466. }
  3467. export type ClientConfiguration = ServiceConfigurationOptions & ClientApiVersions;
  3468. /**
  3469. * Contains interfaces for use with the QBusiness client.
  3470. */
  3471. export import Types = QBusiness;
  3472. }
  3473. export = QBusiness;