egain-api-python 0.1.2__py3-none-any.whl → 0.1.4__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- egain_api_python/_version.py +3 -3
- egain_api_python/answers.py +26 -38
- egain_api_python/articlelists.py +10 -10
- egain_api_python/connectorssearchevents.py +4 -4
- egain_api_python/errors/gethealthop.py +33 -19
- egain_api_python/escalation.py +8 -8
- egain_api_python/export.py +6 -6
- egain_api_python/federatedsearchevent.py +2 -2
- egain_api_python/general.py +8 -8
- egain_api_python/guidedhelp.py +26 -26
- egain_api_python/health.py +2 -8
- egain_api_python/import_.py +56 -74
- egain_api_python/models/__init__.py +106 -95
- egain_api_python/models/aisearchop.py +6 -34
- egain_api_python/models/aisearchresponse.py +0 -4
- egain_api_python/models/answersrequest.py +0 -31
- egain_api_python/models/answersresponse.py +9 -11
- egain_api_python/models/articleaisearchresult.py +16 -45
- egain_api_python/models/articletype.py +3 -5
- egain_api_python/models/{getimportcontentop.py → cancelimportop.py} +3 -3
- egain_api_python/models/{createimportop.py → createimportjobop.py} +3 -3
- egain_api_python/models/{createimportvalidationop.py → createimportvalidationjobop.py} +3 -3
- egain_api_python/models/exportstatus.py +15 -8
- egain_api_python/models/getannouncementarticlesop.py +2 -2
- egain_api_python/models/getarticlelistdetailsop.py +2 -2
- egain_api_python/models/getarticlesintopicop.py +4 -4
- egain_api_python/models/getbestanswerop.py +6 -6
- egain_api_python/models/gethealthop.py +134 -7
- egain_api_python/models/{patchimportcontentvalidationop.py → getimportstatusop.py} +3 -3
- egain_api_python/models/getpopulararticlesop.py +4 -4
- egain_api_python/models/getrelatedarticlesop.py +2 -2
- egain_api_python/models/importstatus.py +116 -0
- egain_api_python/models/knowledgeexport.py +3 -5
- egain_api_python/models/referenceresponse.py +7 -23
- egain_api_python/models/retrievechunksop.py +6 -6
- egain_api_python/models/retrieveresponse.py +10 -12
- egain_api_python/models/searchresult.py +7 -23
- egain_api_python/populararticles.py +14 -14
- egain_api_python/portal_article.py +64 -64
- egain_api_python/portal_attachment.py +4 -4
- egain_api_python/portal_bookmark.py +6 -6
- egain_api_python/portal_suggestion.py +18 -18
- egain_api_python/portal_topic.py +8 -8
- egain_api_python/portal_userdetails.py +2 -2
- egain_api_python/portal_userprofile.py +4 -4
- egain_api_python/retrieve.py +22 -28
- egain_api_python/sdk.py +25 -24
- egain_api_python/sdkconfiguration.py +3 -4
- egain_api_python/search.py +24 -40
- egain_api_python/usermilestones.py +2 -2
- {egain_api_python-0.1.2.dist-info → egain_api_python-0.1.4.dist-info}/METADATA +44 -78
- {egain_api_python-0.1.2.dist-info → egain_api_python-0.1.4.dist-info}/RECORD +55 -57
- egain_api_python/models/resourcetype_parameter.py +0 -10
- egain_api_python/models/topicaisearchresult.py +0 -67
- {egain_api_python-0.1.2.dist-info → egain_api_python-0.1.4.dist-info}/WHEEL +0 -0
- {egain_api_python-0.1.2.dist-info → egain_api_python-0.1.4.dist-info}/licenses/LICENSE +0 -0
- {egain_api_python-0.1.2.dist-info → egain_api_python-0.1.4.dist-info}/top_level.txt +0 -0
@@ -86,7 +86,7 @@ class PortalAttachment(BaseSDK):
|
|
86
86
|
config=self.sdk_configuration,
|
87
87
|
base_url=base_url or "",
|
88
88
|
operation_id="createSignedURL",
|
89
|
-
oauth2_scopes=
|
89
|
+
oauth2_scopes=None,
|
90
90
|
security_source=get_security_from_env(
|
91
91
|
self.sdk_configuration.security, models.Security
|
92
92
|
),
|
@@ -205,7 +205,7 @@ class PortalAttachment(BaseSDK):
|
|
205
205
|
config=self.sdk_configuration,
|
206
206
|
base_url=base_url or "",
|
207
207
|
operation_id="createSignedURL",
|
208
|
-
oauth2_scopes=
|
208
|
+
oauth2_scopes=None,
|
209
209
|
security_source=get_security_from_env(
|
210
210
|
self.sdk_configuration.security, models.Security
|
211
211
|
),
|
@@ -327,7 +327,7 @@ class PortalAttachment(BaseSDK):
|
|
327
327
|
config=self.sdk_configuration,
|
328
328
|
base_url=base_url or "",
|
329
329
|
operation_id="uploadAttachment",
|
330
|
-
oauth2_scopes=
|
330
|
+
oauth2_scopes=None,
|
331
331
|
security_source=get_security_from_env(
|
332
332
|
self.sdk_configuration.security, models.Security
|
333
333
|
),
|
@@ -449,7 +449,7 @@ class PortalAttachment(BaseSDK):
|
|
449
449
|
config=self.sdk_configuration,
|
450
450
|
base_url=base_url or "",
|
451
451
|
operation_id="uploadAttachment",
|
452
|
-
oauth2_scopes=
|
452
|
+
oauth2_scopes=None,
|
453
453
|
security_source=get_security_from_env(
|
454
454
|
self.sdk_configuration.security, models.Security
|
455
455
|
),
|
@@ -103,7 +103,7 @@ class PortalBookmark(BaseSDK):
|
|
103
103
|
config=self.sdk_configuration,
|
104
104
|
base_url=base_url or "",
|
105
105
|
operation_id="addbookmark",
|
106
|
-
oauth2_scopes=
|
106
|
+
oauth2_scopes=None,
|
107
107
|
security_source=get_security_from_env(
|
108
108
|
self.sdk_configuration.security, models.Security
|
109
109
|
),
|
@@ -240,7 +240,7 @@ class PortalBookmark(BaseSDK):
|
|
240
240
|
config=self.sdk_configuration,
|
241
241
|
base_url=base_url or "",
|
242
242
|
operation_id="addbookmark",
|
243
|
-
oauth2_scopes=
|
243
|
+
oauth2_scopes=None,
|
244
244
|
security_source=get_security_from_env(
|
245
245
|
self.sdk_configuration.security, models.Security
|
246
246
|
),
|
@@ -355,7 +355,7 @@ class PortalBookmark(BaseSDK):
|
|
355
355
|
config=self.sdk_configuration,
|
356
356
|
base_url=base_url or "",
|
357
357
|
operation_id="getbookmark",
|
358
|
-
oauth2_scopes=
|
358
|
+
oauth2_scopes=None,
|
359
359
|
security_source=get_security_from_env(
|
360
360
|
self.sdk_configuration.security, models.Security
|
361
361
|
),
|
@@ -462,7 +462,7 @@ class PortalBookmark(BaseSDK):
|
|
462
462
|
config=self.sdk_configuration,
|
463
463
|
base_url=base_url or "",
|
464
464
|
operation_id="getbookmark",
|
465
|
-
oauth2_scopes=
|
465
|
+
oauth2_scopes=None,
|
466
466
|
security_source=get_security_from_env(
|
467
467
|
self.sdk_configuration.security, models.Security
|
468
468
|
),
|
@@ -568,7 +568,7 @@ class PortalBookmark(BaseSDK):
|
|
568
568
|
config=self.sdk_configuration,
|
569
569
|
base_url=base_url or "",
|
570
570
|
operation_id="deletebookmark",
|
571
|
-
oauth2_scopes=
|
571
|
+
oauth2_scopes=None,
|
572
572
|
security_source=get_security_from_env(
|
573
573
|
self.sdk_configuration.security, models.Security
|
574
574
|
),
|
@@ -672,7 +672,7 @@ class PortalBookmark(BaseSDK):
|
|
672
672
|
config=self.sdk_configuration,
|
673
673
|
base_url=base_url or "",
|
674
674
|
operation_id="deletebookmark",
|
675
|
-
oauth2_scopes=
|
675
|
+
oauth2_scopes=None,
|
676
676
|
security_source=get_security_from_env(
|
677
677
|
self.sdk_configuration.security, models.Security
|
678
678
|
),
|
@@ -135,7 +135,7 @@ class PortalSuggestion(BaseSDK):
|
|
135
135
|
config=self.sdk_configuration,
|
136
136
|
base_url=base_url or "",
|
137
137
|
operation_id="makeSuggestion",
|
138
|
-
oauth2_scopes=
|
138
|
+
oauth2_scopes=None,
|
139
139
|
security_source=get_security_from_env(
|
140
140
|
self.sdk_configuration.security, models.Security
|
141
141
|
),
|
@@ -304,7 +304,7 @@ class PortalSuggestion(BaseSDK):
|
|
304
304
|
config=self.sdk_configuration,
|
305
305
|
base_url=base_url or "",
|
306
306
|
operation_id="makeSuggestion",
|
307
|
-
oauth2_scopes=
|
307
|
+
oauth2_scopes=None,
|
308
308
|
security_source=get_security_from_env(
|
309
309
|
self.sdk_configuration.security, models.Security
|
310
310
|
),
|
@@ -463,7 +463,7 @@ class PortalSuggestion(BaseSDK):
|
|
463
463
|
config=self.sdk_configuration,
|
464
464
|
base_url=base_url or "",
|
465
465
|
operation_id="modifySuggestions",
|
466
|
-
oauth2_scopes=
|
466
|
+
oauth2_scopes=None,
|
467
467
|
security_source=get_security_from_env(
|
468
468
|
self.sdk_configuration.security, models.Security
|
469
469
|
),
|
@@ -622,7 +622,7 @@ class PortalSuggestion(BaseSDK):
|
|
622
622
|
config=self.sdk_configuration,
|
623
623
|
base_url=base_url or "",
|
624
624
|
operation_id="modifySuggestions",
|
625
|
-
oauth2_scopes=
|
625
|
+
oauth2_scopes=None,
|
626
626
|
security_source=get_security_from_env(
|
627
627
|
self.sdk_configuration.security, models.Security
|
628
628
|
),
|
@@ -752,7 +752,7 @@ class PortalSuggestion(BaseSDK):
|
|
752
752
|
config=self.sdk_configuration,
|
753
753
|
base_url=base_url or "",
|
754
754
|
operation_id="searchSuggestion",
|
755
|
-
oauth2_scopes=
|
755
|
+
oauth2_scopes=None,
|
756
756
|
security_source=get_security_from_env(
|
757
757
|
self.sdk_configuration.security, models.Security
|
758
758
|
),
|
@@ -874,7 +874,7 @@ class PortalSuggestion(BaseSDK):
|
|
874
874
|
config=self.sdk_configuration,
|
875
875
|
base_url=base_url or "",
|
876
876
|
operation_id="searchSuggestion",
|
877
|
-
oauth2_scopes=
|
877
|
+
oauth2_scopes=None,
|
878
878
|
security_source=get_security_from_env(
|
879
879
|
self.sdk_configuration.security, models.Security
|
880
880
|
),
|
@@ -994,7 +994,7 @@ class PortalSuggestion(BaseSDK):
|
|
994
994
|
config=self.sdk_configuration,
|
995
995
|
base_url=base_url or "",
|
996
996
|
operation_id="getSuggestion",
|
997
|
-
oauth2_scopes=
|
997
|
+
oauth2_scopes=None,
|
998
998
|
security_source=get_security_from_env(
|
999
999
|
self.sdk_configuration.security, models.Security
|
1000
1000
|
),
|
@@ -1114,7 +1114,7 @@ class PortalSuggestion(BaseSDK):
|
|
1114
1114
|
config=self.sdk_configuration,
|
1115
1115
|
base_url=base_url or "",
|
1116
1116
|
operation_id="getSuggestion",
|
1117
|
-
oauth2_scopes=
|
1117
|
+
oauth2_scopes=None,
|
1118
1118
|
security_source=get_security_from_env(
|
1119
1119
|
self.sdk_configuration.security, models.Security
|
1120
1120
|
),
|
@@ -1226,7 +1226,7 @@ class PortalSuggestion(BaseSDK):
|
|
1226
1226
|
config=self.sdk_configuration,
|
1227
1227
|
base_url=base_url or "",
|
1228
1228
|
operation_id="deleteSuggestion",
|
1229
|
-
oauth2_scopes=
|
1229
|
+
oauth2_scopes=None,
|
1230
1230
|
security_source=get_security_from_env(
|
1231
1231
|
self.sdk_configuration.security, models.Security
|
1232
1232
|
),
|
@@ -1336,7 +1336,7 @@ class PortalSuggestion(BaseSDK):
|
|
1336
1336
|
config=self.sdk_configuration,
|
1337
1337
|
base_url=base_url or "",
|
1338
1338
|
operation_id="deleteSuggestion",
|
1339
|
-
oauth2_scopes=
|
1339
|
+
oauth2_scopes=None,
|
1340
1340
|
security_source=get_security_from_env(
|
1341
1341
|
self.sdk_configuration.security, models.Security
|
1342
1342
|
),
|
@@ -1450,7 +1450,7 @@ class PortalSuggestion(BaseSDK):
|
|
1450
1450
|
config=self.sdk_configuration,
|
1451
1451
|
base_url=base_url or "",
|
1452
1452
|
operation_id="getRelatedArticlesForSuggestion",
|
1453
|
-
oauth2_scopes=
|
1453
|
+
oauth2_scopes=None,
|
1454
1454
|
security_source=get_security_from_env(
|
1455
1455
|
self.sdk_configuration.security, models.Security
|
1456
1456
|
),
|
@@ -1568,7 +1568,7 @@ class PortalSuggestion(BaseSDK):
|
|
1568
1568
|
config=self.sdk_configuration,
|
1569
1569
|
base_url=base_url or "",
|
1570
1570
|
operation_id="getRelatedArticlesForSuggestion",
|
1571
|
-
oauth2_scopes=
|
1571
|
+
oauth2_scopes=None,
|
1572
1572
|
security_source=get_security_from_env(
|
1573
1573
|
self.sdk_configuration.security, models.Security
|
1574
1574
|
),
|
@@ -1681,7 +1681,7 @@ class PortalSuggestion(BaseSDK):
|
|
1681
1681
|
config=self.sdk_configuration,
|
1682
1682
|
base_url=base_url or "",
|
1683
1683
|
operation_id="getSuggestionComments",
|
1684
|
-
oauth2_scopes=
|
1684
|
+
oauth2_scopes=None,
|
1685
1685
|
security_source=get_security_from_env(
|
1686
1686
|
self.sdk_configuration.security, models.Security
|
1687
1687
|
),
|
@@ -1792,7 +1792,7 @@ class PortalSuggestion(BaseSDK):
|
|
1792
1792
|
config=self.sdk_configuration,
|
1793
1793
|
base_url=base_url or "",
|
1794
1794
|
operation_id="getSuggestionComments",
|
1795
|
-
oauth2_scopes=
|
1795
|
+
oauth2_scopes=None,
|
1796
1796
|
security_source=get_security_from_env(
|
1797
1797
|
self.sdk_configuration.security, models.Security
|
1798
1798
|
),
|
@@ -1903,7 +1903,7 @@ class PortalSuggestion(BaseSDK):
|
|
1903
1903
|
config=self.sdk_configuration,
|
1904
1904
|
base_url=base_url or "",
|
1905
1905
|
operation_id="getSuggestionAttachments",
|
1906
|
-
oauth2_scopes=
|
1906
|
+
oauth2_scopes=None,
|
1907
1907
|
security_source=get_security_from_env(
|
1908
1908
|
self.sdk_configuration.security, models.Security
|
1909
1909
|
),
|
@@ -2014,7 +2014,7 @@ class PortalSuggestion(BaseSDK):
|
|
2014
2014
|
config=self.sdk_configuration,
|
2015
2015
|
base_url=base_url or "",
|
2016
2016
|
operation_id="getSuggestionAttachments",
|
2017
|
-
oauth2_scopes=
|
2017
|
+
oauth2_scopes=None,
|
2018
2018
|
security_source=get_security_from_env(
|
2019
2019
|
self.sdk_configuration.security, models.Security
|
2020
2020
|
),
|
@@ -2130,7 +2130,7 @@ class PortalSuggestion(BaseSDK):
|
|
2130
2130
|
config=self.sdk_configuration,
|
2131
2131
|
base_url=base_url or "",
|
2132
2132
|
operation_id="getSuggestionAttachmentById",
|
2133
|
-
oauth2_scopes=
|
2133
|
+
oauth2_scopes=None,
|
2134
2134
|
security_source=get_security_from_env(
|
2135
2135
|
self.sdk_configuration.security, models.Security
|
2136
2136
|
),
|
@@ -2246,7 +2246,7 @@ class PortalSuggestion(BaseSDK):
|
|
2246
2246
|
config=self.sdk_configuration,
|
2247
2247
|
base_url=base_url or "",
|
2248
2248
|
operation_id="getSuggestionAttachmentById",
|
2249
|
-
oauth2_scopes=
|
2249
|
+
oauth2_scopes=None,
|
2250
2250
|
security_source=get_security_from_env(
|
2251
2251
|
self.sdk_configuration.security, models.Security
|
2252
2252
|
),
|
egain_api_python/portal_topic.py
CHANGED
@@ -83,7 +83,7 @@ class PortalTopic(BaseSDK):
|
|
83
83
|
config=self.sdk_configuration,
|
84
84
|
base_url=base_url or "",
|
85
85
|
operation_id="getTopicBreadcrumbForArticle",
|
86
|
-
oauth2_scopes=
|
86
|
+
oauth2_scopes=None,
|
87
87
|
security_source=get_security_from_env(
|
88
88
|
self.sdk_configuration.security, models.Security
|
89
89
|
),
|
@@ -190,7 +190,7 @@ class PortalTopic(BaseSDK):
|
|
190
190
|
config=self.sdk_configuration,
|
191
191
|
base_url=base_url or "",
|
192
192
|
operation_id="getTopicBreadcrumbForArticle",
|
193
|
-
oauth2_scopes=
|
193
|
+
oauth2_scopes=None,
|
194
194
|
security_source=get_security_from_env(
|
195
195
|
self.sdk_configuration.security, models.Security
|
196
196
|
),
|
@@ -317,7 +317,7 @@ class PortalTopic(BaseSDK):
|
|
317
317
|
config=self.sdk_configuration,
|
318
318
|
base_url=base_url or "",
|
319
319
|
operation_id="getchildtopics",
|
320
|
-
oauth2_scopes=
|
320
|
+
oauth2_scopes=None,
|
321
321
|
security_source=get_security_from_env(
|
322
322
|
self.sdk_configuration.security, models.Security
|
323
323
|
),
|
@@ -446,7 +446,7 @@ class PortalTopic(BaseSDK):
|
|
446
446
|
config=self.sdk_configuration,
|
447
447
|
base_url=base_url or "",
|
448
448
|
operation_id="getchildtopics",
|
449
|
-
oauth2_scopes=
|
449
|
+
oauth2_scopes=None,
|
450
450
|
security_source=get_security_from_env(
|
451
451
|
self.sdk_configuration.security, models.Security
|
452
452
|
),
|
@@ -569,7 +569,7 @@ class PortalTopic(BaseSDK):
|
|
569
569
|
config=self.sdk_configuration,
|
570
570
|
base_url=base_url or "",
|
571
571
|
operation_id="getancestortopics",
|
572
|
-
oauth2_scopes=
|
572
|
+
oauth2_scopes=None,
|
573
573
|
security_source=get_security_from_env(
|
574
574
|
self.sdk_configuration.security, models.Security
|
575
575
|
),
|
@@ -692,7 +692,7 @@ class PortalTopic(BaseSDK):
|
|
692
692
|
config=self.sdk_configuration,
|
693
693
|
base_url=base_url or "",
|
694
694
|
operation_id="getancestortopics",
|
695
|
-
oauth2_scopes=
|
695
|
+
oauth2_scopes=None,
|
696
696
|
security_source=get_security_from_env(
|
697
697
|
self.sdk_configuration.security, models.Security
|
698
698
|
),
|
@@ -815,7 +815,7 @@ class PortalTopic(BaseSDK):
|
|
815
815
|
config=self.sdk_configuration,
|
816
816
|
base_url=base_url or "",
|
817
817
|
operation_id="getalltopics",
|
818
|
-
oauth2_scopes=
|
818
|
+
oauth2_scopes=None,
|
819
819
|
security_source=get_security_from_env(
|
820
820
|
self.sdk_configuration.security, models.Security
|
821
821
|
),
|
@@ -938,7 +938,7 @@ class PortalTopic(BaseSDK):
|
|
938
938
|
config=self.sdk_configuration,
|
939
939
|
base_url=base_url or "",
|
940
940
|
operation_id="getalltopics",
|
941
|
-
oauth2_scopes=
|
941
|
+
oauth2_scopes=None,
|
942
942
|
security_source=get_security_from_env(
|
943
943
|
self.sdk_configuration.security, models.Security
|
944
944
|
),
|
@@ -74,7 +74,7 @@ class PortalUserdetails(BaseSDK):
|
|
74
74
|
config=self.sdk_configuration,
|
75
75
|
base_url=base_url or "",
|
76
76
|
operation_id="getUserDetails",
|
77
|
-
oauth2_scopes=
|
77
|
+
oauth2_scopes=None,
|
78
78
|
security_source=get_security_from_env(
|
79
79
|
self.sdk_configuration.security, models.Security
|
80
80
|
),
|
@@ -174,7 +174,7 @@ class PortalUserdetails(BaseSDK):
|
|
174
174
|
config=self.sdk_configuration,
|
175
175
|
base_url=base_url or "",
|
176
176
|
operation_id="getUserDetails",
|
177
|
-
oauth2_scopes=
|
177
|
+
oauth2_scopes=None,
|
178
178
|
security_source=get_security_from_env(
|
179
179
|
self.sdk_configuration.security, models.Security
|
180
180
|
),
|
@@ -80,7 +80,7 @@ class PortalUserprofile(BaseSDK):
|
|
80
80
|
config=self.sdk_configuration,
|
81
81
|
base_url=base_url or "",
|
82
82
|
operation_id="getAllUserProfiles",
|
83
|
-
oauth2_scopes=
|
83
|
+
oauth2_scopes=None,
|
84
84
|
security_source=get_security_from_env(
|
85
85
|
self.sdk_configuration.security, models.Security
|
86
86
|
),
|
@@ -186,7 +186,7 @@ class PortalUserprofile(BaseSDK):
|
|
186
186
|
config=self.sdk_configuration,
|
187
187
|
base_url=base_url or "",
|
188
188
|
operation_id="getAllUserProfiles",
|
189
|
-
oauth2_scopes=
|
189
|
+
oauth2_scopes=None,
|
190
190
|
security_source=get_security_from_env(
|
191
191
|
self.sdk_configuration.security, models.Security
|
192
192
|
),
|
@@ -292,7 +292,7 @@ class PortalUserprofile(BaseSDK):
|
|
292
292
|
config=self.sdk_configuration,
|
293
293
|
base_url=base_url or "",
|
294
294
|
operation_id="selectUserProfile",
|
295
|
-
oauth2_scopes=
|
295
|
+
oauth2_scopes=None,
|
296
296
|
security_source=get_security_from_env(
|
297
297
|
self.sdk_configuration.security, models.Security
|
298
298
|
),
|
@@ -396,7 +396,7 @@ class PortalUserprofile(BaseSDK):
|
|
396
396
|
config=self.sdk_configuration,
|
397
397
|
base_url=base_url or "",
|
398
398
|
operation_id="selectUserProfile",
|
399
|
-
oauth2_scopes=
|
399
|
+
oauth2_scopes=None,
|
400
400
|
security_source=get_security_from_env(
|
401
401
|
self.sdk_configuration.security, models.Security
|
402
402
|
),
|
egain_api_python/retrieve.py
CHANGED
@@ -15,10 +15,10 @@ class Retrieve(BaseSDK):
|
|
15
15
|
*,
|
16
16
|
q: str,
|
17
17
|
portal_id: str,
|
18
|
-
|
18
|
+
filter_user_profile_id: Optional[str] = None,
|
19
19
|
language: Optional[models.LanguageCodeParameter] = None,
|
20
|
-
|
21
|
-
|
20
|
+
filter_tags: Optional[Dict[str, List[str]]] = None,
|
21
|
+
filter_topic_ids: Optional[List[str]] = None,
|
22
22
|
channel: Optional[
|
23
23
|
Union[models.RetrieveRequestChannel, models.RetrieveRequestChannelTypedDict]
|
24
24
|
] = None,
|
@@ -31,14 +31,14 @@ class Retrieve(BaseSDK):
|
|
31
31
|
) -> models.RetrieveResponse:
|
32
32
|
r"""Retrieve Chunks
|
33
33
|
|
34
|
-
The Retrieve API enables enterprises to directly access relevant content chunks from their organizational knowledge sources. It is designed for scenarios where developers want granular control over retrieved information, such as powering custom search, analytics, or retrieval-augmented generation (RAG) pipelines. <br><br> In addition to raw chunk retrieval, the API can return **Certified Answers** if it meets the 'Certified Answer' threshold score. Responses include relevance scores, metadata, and references to maintain transparency and flexibility. By leveraging the Retrieve API, organizations can build tailored experiences while retaining confidence in the source material.
|
34
|
+
The Retrieve API enables enterprises to directly access relevant content chunks from their organizational knowledge sources. It is designed for scenarios where developers want granular control over retrieved information, such as powering custom search, analytics, or retrieval-augmented generation (RAG) pipelines. <br><br> In addition to raw chunk retrieval, the API can return **Certified Answers** if it meets the 'Certified Answer' threshold score. Responses include relevance scores, metadata, and references to maintain transparency and flexibility. By leveraging the Retrieve API, organizations can build tailored experiences while retaining confidence in the source material. <br>**This endpoint is only available for Self Service environments.**
|
35
35
|
|
36
36
|
:param q: The search query string. The string must be escaped as required by the URL syntax rules.
|
37
37
|
:param portal_id: The ID of the portal being accessed.<br><br>A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits.
|
38
|
-
:param
|
38
|
+
:param filter_user_profile_id:
|
39
39
|
:param language: The language that describes the details of a resource. Resources available in different languages may differ from each other. <br><br> If lang is not passed, then the portal's default language is used.
|
40
|
-
:param
|
41
|
-
:param
|
40
|
+
:param filter_tags: An object where each key is a **Category Tag ID** (numeric string), and each value is an array of **Tag IDs** for that category.
|
41
|
+
:param filter_topic_ids: An array of topic IDs. It is used to restrict search results to specific topics.
|
42
42
|
:param channel:
|
43
43
|
:param event_id: Unique ID for this specific API call or event.
|
44
44
|
:param session_id: ID that ties multiple API calls to the same user session. Will be used as part of to tie events back to a session.
|
@@ -56,17 +56,14 @@ class Retrieve(BaseSDK):
|
|
56
56
|
base_url = server_url
|
57
57
|
else:
|
58
58
|
base_url = models.RETRIEVE_CHUNKS_OP_SERVERS[0]
|
59
|
-
url_variables = {
|
60
|
-
"API_DOMAIN": "api.egain.cloud",
|
61
|
-
}
|
62
59
|
|
63
60
|
request = models.RetrieveChunksRequest(
|
64
61
|
q=q,
|
65
62
|
portal_id=portal_id,
|
66
|
-
|
63
|
+
filter_user_profile_id=filter_user_profile_id,
|
67
64
|
language=language,
|
68
|
-
|
69
|
-
|
65
|
+
filter_tags=filter_tags,
|
66
|
+
filter_topic_ids=filter_topic_ids,
|
70
67
|
retrieve_request=models.RetrieveRequest(
|
71
68
|
channel=utils.get_pydantic_model(
|
72
69
|
channel, Optional[models.RetrieveRequestChannel]
|
@@ -112,7 +109,7 @@ class Retrieve(BaseSDK):
|
|
112
109
|
config=self.sdk_configuration,
|
113
110
|
base_url=base_url or "",
|
114
111
|
operation_id="retrieveChunks",
|
115
|
-
oauth2_scopes=
|
112
|
+
oauth2_scopes=None,
|
116
113
|
security_source=get_security_from_env(
|
117
114
|
self.sdk_configuration.security, models.Security
|
118
115
|
),
|
@@ -142,10 +139,10 @@ class Retrieve(BaseSDK):
|
|
142
139
|
*,
|
143
140
|
q: str,
|
144
141
|
portal_id: str,
|
145
|
-
|
142
|
+
filter_user_profile_id: Optional[str] = None,
|
146
143
|
language: Optional[models.LanguageCodeParameter] = None,
|
147
|
-
|
148
|
-
|
144
|
+
filter_tags: Optional[Dict[str, List[str]]] = None,
|
145
|
+
filter_topic_ids: Optional[List[str]] = None,
|
149
146
|
channel: Optional[
|
150
147
|
Union[models.RetrieveRequestChannel, models.RetrieveRequestChannelTypedDict]
|
151
148
|
] = None,
|
@@ -158,14 +155,14 @@ class Retrieve(BaseSDK):
|
|
158
155
|
) -> models.RetrieveResponse:
|
159
156
|
r"""Retrieve Chunks
|
160
157
|
|
161
|
-
The Retrieve API enables enterprises to directly access relevant content chunks from their organizational knowledge sources. It is designed for scenarios where developers want granular control over retrieved information, such as powering custom search, analytics, or retrieval-augmented generation (RAG) pipelines. <br><br> In addition to raw chunk retrieval, the API can return **Certified Answers** if it meets the 'Certified Answer' threshold score. Responses include relevance scores, metadata, and references to maintain transparency and flexibility. By leveraging the Retrieve API, organizations can build tailored experiences while retaining confidence in the source material.
|
158
|
+
The Retrieve API enables enterprises to directly access relevant content chunks from their organizational knowledge sources. It is designed for scenarios where developers want granular control over retrieved information, such as powering custom search, analytics, or retrieval-augmented generation (RAG) pipelines. <br><br> In addition to raw chunk retrieval, the API can return **Certified Answers** if it meets the 'Certified Answer' threshold score. Responses include relevance scores, metadata, and references to maintain transparency and flexibility. By leveraging the Retrieve API, organizations can build tailored experiences while retaining confidence in the source material. <br>**This endpoint is only available for Self Service environments.**
|
162
159
|
|
163
160
|
:param q: The search query string. The string must be escaped as required by the URL syntax rules.
|
164
161
|
:param portal_id: The ID of the portal being accessed.<br><br>A portal ID is composed of a 2-4 letter prefix, followed by a dash and 4-15 digits.
|
165
|
-
:param
|
162
|
+
:param filter_user_profile_id:
|
166
163
|
:param language: The language that describes the details of a resource. Resources available in different languages may differ from each other. <br><br> If lang is not passed, then the portal's default language is used.
|
167
|
-
:param
|
168
|
-
:param
|
164
|
+
:param filter_tags: An object where each key is a **Category Tag ID** (numeric string), and each value is an array of **Tag IDs** for that category.
|
165
|
+
:param filter_topic_ids: An array of topic IDs. It is used to restrict search results to specific topics.
|
169
166
|
:param channel:
|
170
167
|
:param event_id: Unique ID for this specific API call or event.
|
171
168
|
:param session_id: ID that ties multiple API calls to the same user session. Will be used as part of to tie events back to a session.
|
@@ -183,17 +180,14 @@ class Retrieve(BaseSDK):
|
|
183
180
|
base_url = server_url
|
184
181
|
else:
|
185
182
|
base_url = models.RETRIEVE_CHUNKS_OP_SERVERS[0]
|
186
|
-
url_variables = {
|
187
|
-
"API_DOMAIN": "api.egain.cloud",
|
188
|
-
}
|
189
183
|
|
190
184
|
request = models.RetrieveChunksRequest(
|
191
185
|
q=q,
|
192
186
|
portal_id=portal_id,
|
193
|
-
|
187
|
+
filter_user_profile_id=filter_user_profile_id,
|
194
188
|
language=language,
|
195
|
-
|
196
|
-
|
189
|
+
filter_tags=filter_tags,
|
190
|
+
filter_topic_ids=filter_topic_ids,
|
197
191
|
retrieve_request=models.RetrieveRequest(
|
198
192
|
channel=utils.get_pydantic_model(
|
199
193
|
channel, Optional[models.RetrieveRequestChannel]
|
@@ -239,7 +233,7 @@ class Retrieve(BaseSDK):
|
|
239
233
|
config=self.sdk_configuration,
|
240
234
|
base_url=base_url or "",
|
241
235
|
operation_id="retrieveChunks",
|
242
|
-
oauth2_scopes=
|
236
|
+
oauth2_scopes=None,
|
243
237
|
security_source=get_security_from_env(
|
244
238
|
self.sdk_configuration.security, models.Security
|
245
239
|
),
|
egain_api_python/sdk.py
CHANGED
@@ -11,7 +11,7 @@ from egain_api_python.types import OptionalNullable, UNSET
|
|
11
11
|
import httpx
|
12
12
|
import importlib
|
13
13
|
import sys
|
14
|
-
from typing import Any, Callable, Dict,
|
14
|
+
from typing import Any, Callable, Dict, Optional, TYPE_CHECKING, Union, cast
|
15
15
|
import weakref
|
16
16
|
|
17
17
|
if TYPE_CHECKING:
|
@@ -25,26 +25,35 @@ class Egain(BaseSDK):
|
|
25
25
|
The following licenses are required to use the Knowledge Access APIs:
|
26
26
|
* If the user is an agent, then the *Knowledge + AI* license is required.
|
27
27
|
* If the user is a customer, the *Self-Service* and *Advanced Self-Service* licenses must be available.
|
28
|
+
|
29
|
+
### Tiers
|
30
|
+
|
31
|
+
| Tier |Tier Name| Named Users | Description
|
32
|
+
| ---------- | ---------- | ---------- | ----------------------------
|
33
|
+
| Tier 1 | Starter | Up to 10| Designed for small-scale implementations or pilot environments
|
34
|
+
| Tier 2 | Growth | Up to 1000| Suitable for mid-scale deployments requiring moderate scalability
|
35
|
+
| Tier 3 | Enterprise | Greater than 1000| Supports large-scale environments with extended configuration options
|
36
|
+
|
28
37
|
### API Resource Limits
|
29
|
-
The following Resources have predefined limits for specific access attributes for Enterprise use.
|
38
|
+
The following Resources have predefined limits for specific access attributes for Starter, Growth and Enterprise use.
|
30
39
|
|
31
|
-
| Resource |
|
32
|
-
| ---------------- | ---------------------------- | ----------
|
33
|
-
| Article Reference
|
34
|
-
| |Number of custom attributes in an article |
|
35
|
-
| |Number of publish views used in an article version | 20
|
36
|
-
| Topic Reference
|
37
|
-
| |Depth of topics | 20
|
38
|
-
| |Topics at any level | 2500
|
39
|
-
| |Number of custom attributes in a topic |
|
40
|
-
| Portal Reference
|
41
|
-
| |Topics to be included in a portal |
|
42
|
-
| |Number of articles to display in announcements | 25
|
43
|
-
| |
|
44
|
-
| |Usage links and link groups setup for a portal | 25
|
40
|
+
| Resource | Limits | Starter | Growth | Enterprise
|
41
|
+
| ---------------- | ---------------------------- | ---------- | ---------- | ----------
|
42
|
+
| Article Reference |Number of attachments used in any article | 25 | 50 |50
|
43
|
+
| |Number of custom attributes in an article | 10 | 25| 50
|
44
|
+
| |Number of publish views used in an article version | 20 | 20 | 20
|
45
|
+
| Topic Reference |User-defined topics in a department| 1000| 5000 | 50000
|
46
|
+
| |Depth of topics | 5 | 20 | 20
|
47
|
+
| |Topics at any level | 500 | 2500 | 2500
|
48
|
+
| |Number of custom attributes in a topic | 10 | 10 | 10
|
49
|
+
| Portal Reference | Tag categories in a portal | 15 | 15 | 15
|
50
|
+
| |Topics to be included in a portal | 100 | 500 | 5000
|
51
|
+
| |Number of articles to display in announcements | 10 | 25 | 25
|
52
|
+
| |Usage links and link groups setup for a portal | 5 | 10 | 25
|
45
53
|
|
46
54
|
|
47
55
|
|
56
|
+
https://github.com/eGain/egain-api-python - Full SDK Documentation
|
48
57
|
"""
|
49
58
|
|
50
59
|
aiservices: "Aiservices"
|
@@ -61,7 +70,6 @@ class Egain(BaseSDK):
|
|
61
70
|
access_token: Optional[
|
62
71
|
Union[Optional[str], Callable[[], Optional[str]]]
|
63
72
|
] = None,
|
64
|
-
api_domain: Optional[str] = None,
|
65
73
|
server_idx: Optional[int] = None,
|
66
74
|
server_url: Optional[str] = None,
|
67
75
|
url_params: Optional[Dict[str, str]] = None,
|
@@ -74,7 +82,6 @@ class Egain(BaseSDK):
|
|
74
82
|
r"""Instantiates the SDK configuring it with the provided parameters.
|
75
83
|
|
76
84
|
:param access_token: The access_token required for authentication
|
77
|
-
:param api_domain: Allows setting the API_DOMAIN variable for url substitution
|
78
85
|
:param server_idx: The index of the server to use for all methods
|
79
86
|
:param server_url: The server URL to use for all methods
|
80
87
|
:param url_params: Parameters to optionally template the server URL with
|
@@ -114,11 +121,6 @@ class Egain(BaseSDK):
|
|
114
121
|
if server_url is not None:
|
115
122
|
if url_params is not None:
|
116
123
|
server_url = utils.template_url(server_url, url_params)
|
117
|
-
server_defaults: List[Dict[str, str]] = [
|
118
|
-
{
|
119
|
-
"API_DOMAIN": api_domain or "api.egain.cloud",
|
120
|
-
},
|
121
|
-
]
|
122
124
|
|
123
125
|
BaseSDK.__init__(
|
124
126
|
self,
|
@@ -130,7 +132,6 @@ class Egain(BaseSDK):
|
|
130
132
|
security=security,
|
131
133
|
server_url=server_url,
|
132
134
|
server_idx=server_idx,
|
133
|
-
server_defaults=server_defaults,
|
134
135
|
retry_config=retry_config,
|
135
136
|
timeout_ms=timeout_ms,
|
136
137
|
debug_logger=debug_logger,
|
@@ -8,11 +8,11 @@ from ._version import (
|
|
8
8
|
)
|
9
9
|
from .httpclient import AsyncHttpClient, HttpClient
|
10
10
|
from .utils import Logger, RetryConfig, remove_suffix
|
11
|
-
from dataclasses import dataclass
|
11
|
+
from dataclasses import dataclass
|
12
12
|
from egain_api_python import models
|
13
13
|
from egain_api_python.types import OptionalNullable, UNSET
|
14
14
|
from pydantic import Field
|
15
|
-
from typing import Callable, Dict,
|
15
|
+
from typing import Callable, Dict, Optional, Tuple, Union
|
16
16
|
|
17
17
|
|
18
18
|
SERVERS = [
|
@@ -32,7 +32,6 @@ class SDKConfiguration:
|
|
32
32
|
security: Optional[Union[models.Security, Callable[[], models.Security]]] = None
|
33
33
|
server_url: Optional[str] = ""
|
34
34
|
server_idx: Optional[int] = 0
|
35
|
-
server_defaults: List[Dict[str, str]] = field(default_factory=List)
|
36
35
|
language: str = "python"
|
37
36
|
openapi_doc_version: str = __openapi_doc_version__
|
38
37
|
sdk_version: str = __version__
|
@@ -47,4 +46,4 @@ class SDKConfiguration:
|
|
47
46
|
if self.server_idx is None:
|
48
47
|
self.server_idx = 0
|
49
48
|
|
50
|
-
return SERVERS[self.server_idx],
|
49
|
+
return SERVERS[self.server_idx], {}
|