Skip to content

Commit 506637e

Browse files
committed
sdk docs
1 parent 4ec5a43 commit 506637e

File tree

4 files changed

+254
-1
lines changed

4 files changed

+254
-1
lines changed

md-docs/api/python/client.md

Lines changed: 135 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1471,6 +1471,101 @@ Export a RAG evaluation report to a file.
14711471

14721472
None
14731473

1474+
### .compute_topic_modeling_report
1475+
```python
1476+
.compute_topic_modeling_report(
1477+
task_id: str, report_name: str, from_timestamp: float, to_timestamp: float
1478+
)
1479+
```
1480+
1481+
---
1482+
Compute the topic modeling report for a given task. This
1483+
functionality is available only for tasks based on text data.
1484+
The data on which the report is computed is determined
1485+
by the timestamps.
1486+
1487+
This request starts an operation pipeline that is
1488+
executed by ML cube Platform.
1489+
Thus, the method returns the identifier of the job that you can
1490+
monitor to know its status and proceed with the other work
1491+
using the method `wait_job_completion(job_id)`
1492+
1493+
**Allowed Roles:**
1494+
- At least `PROJECT_EDIT` for that project
1495+
- `COMPANY_OWNER`
1496+
- `COMPANY_ADMIN`
1497+
1498+
1499+
**Args**
1500+
1501+
* **task_id** : the identifier of the task
1502+
* **report_name** : the name of the report
1503+
* **from_timestamp** : start timestamp of the samples to evaluate
1504+
* **to_timestamp** : end timestamp of the samples to evaluate
1505+
1506+
1507+
**Returns**
1508+
1509+
* **job_id** : `str` identifier of the submitted job
1510+
1511+
1512+
**Raises**
1513+
1514+
ComputeTopicModelingReportException
1515+
1516+
### .get_topic_modeling_reports
1517+
```python
1518+
.get_topic_modeling_reports(
1519+
task_id: str
1520+
)
1521+
```
1522+
1523+
---
1524+
For a given task id, get the computed topic modeling reports.
1525+
1526+
**Allowed Roles:**
1527+
- At least `PROJECT_VIEW` for that project
1528+
- `COMPANY_OWNER`
1529+
- `COMPANY_ADMIN`
1530+
1531+
1532+
**Args**
1533+
1534+
* **task_id** : the identifier of the task
1535+
1536+
1537+
**Returns**
1538+
1539+
* **topic_modeling_reports** : list[TaskTopicModelingReportItem]
1540+
1541+
1542+
### .get_topic_modeling_report
1543+
```python
1544+
.get_topic_modeling_report(
1545+
report_id: str
1546+
)
1547+
```
1548+
1549+
---
1550+
For a given task id, get the computed topic modeling report
1551+
for a specific report id.
1552+
1553+
**Allowed Roles:**
1554+
- At least `PROJECT_VIEW` for that project
1555+
- `COMPANY_OWNER`
1556+
- `COMPANY_ADMIN`
1557+
1558+
1559+
**Args**
1560+
1561+
* **report_id** : the identifier of the report
1562+
1563+
1564+
**Returns**
1565+
1566+
* **topic_modeling_report_detail** : TaskTopicModelingReportDetails
1567+
1568+
14741569
### .get_monitoring_status
14751570
```python
14761571
.get_monitoring_status(
@@ -2505,6 +2600,46 @@ your trust policy.
25052600
* **credentials** : `SecretAWSCredentials`
25062601

25072602

2603+
**Raises**
2604+
2605+
`SDKClientException`
2606+
2607+
### .create_aws_compatible_integration_credentials
2608+
```python
2609+
.create_aws_compatible_integration_credentials(
2610+
name: str, default: bool, project_id: str, access_key_id: str,
2611+
secret_access_key: str, endpoint_url: (str|None) = None
2612+
)
2613+
```
2614+
2615+
---
2616+
Create credentials to integrate with AWS-compatible services.
2617+
2618+
**Allowed Roles:**
2619+
2620+
- At least `UPDATE_PROJECT_INFORMATION` for the project
2621+
- `COMPANY_OWNER`
2622+
- `COMPANY_ADMIN`
2623+
2624+
2625+
**Args**
2626+
2627+
* **name** : a simple name to identify this set of credentials
2628+
* **default** : whether to use these credentials by default when
2629+
using an AWS integration
2630+
* **project_id** : the project in which these credentials will
2631+
be configured
2632+
* **access_key_id** : the access key id
2633+
* **secret_access_key** : the secret access key
2634+
* **endpoint_url** : the endpoint url of the service. If None,
2635+
AWS itself is used
2636+
2637+
2638+
**Returns**
2639+
2640+
* **credentials** : `AWSCompatibleCredentials`
2641+
2642+
25082643
**Raises**
25092644

25102645
`SDKClientException`

md-docs/api/python/enums.md

Lines changed: 32 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,18 @@ ApiKeyExpirationTime()
1919
----
2020

2121

22+
## BaseML3Enum
23+
```python
24+
BaseML3Enum()
25+
```
26+
27+
28+
---
29+
Base class for all enums in the ML3 Platform SDK
30+
31+
----
32+
33+
2234
## ColumnRole
2335
```python
2436
ColumnRole()
@@ -84,7 +96,7 @@ DataType()
8496

8597
---
8698
Data type enum
87-
Describe data type of an input
99+
Describe data type of input
88100

89101
----
90102

@@ -151,6 +163,7 @@ An integration with a 3rd party service provider
151163
- AWS
152164
- GCP
153165
- AZURE
166+
- AWS_COMPATIBLE
154167

155168
----
156169

@@ -188,6 +201,24 @@ Type of folder
188201
----
189202

190203

204+
## ImageMode
205+
```python
206+
ImageMode()
207+
```
208+
209+
210+
---
211+
Image mode enumeration
212+
213+
Fields
214+
------
215+
RGB: Red, Green, Blue
216+
RGBA: Red, Green, Blue, Alpha
217+
GRAYSCALE: Grayscale
218+
219+
----
220+
221+
191222
## JobStatus
192223
```python
193224
JobStatus()

md-docs/api/python/exceptions.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -85,6 +85,18 @@ ComputeRetrainingReportException
8585
----
8686

8787

88+
## ComputeTopicModelingReportException
89+
```python
90+
ComputeTopicModelingReportException()
91+
```
92+
93+
94+
---
95+
ComputeTopicModelingReportException
96+
97+
----
98+
99+
88100
## CreateCompanyException
89101
```python
90102
CreateCompanyException()
@@ -181,6 +193,18 @@ GetRetrainingReportException
181193
----
182194

183195

196+
## GetTopicModelingReportException
197+
```python
198+
GetTopicModelingReportException()
199+
```
200+
201+
202+
---
203+
GetTopicModelingReportException
204+
205+
----
206+
207+
184208
## InvalidActionList
185209
```python
186210
InvalidActionList()

md-docs/api/python/models.md

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,29 @@
11
#
22

33

4+
## AWSCompatibleCredentials
5+
```python
6+
AWSCompatibleCredentials()
7+
```
8+
9+
10+
---
11+
AWS-compatible integration credentials.
12+
13+
14+
**Attributes**
15+
16+
* **credentials_id** : str
17+
* **name** : str
18+
* **default** : bool
19+
* **type** : ExternalIntegration
20+
* **access_key_id** : The access key id
21+
* **endpoint_url** : The endpoint url (if any)
22+
23+
24+
----
25+
26+
427
## AWSCredentials
528
```python
629
AWSCredentials()
@@ -170,6 +193,9 @@ Column base model
170193
Indicates the subrole of the column. It's used in
171194
RAG tasks to define the role of the input columns
172195
(e.g. user input or retrieved context)
196+
* **image_mode** : Optional[ImageMode] = None
197+
Indicates the mode of the image. It must be provided
198+
when the data type is an image
173199

174200

175201
----
@@ -1052,6 +1078,43 @@ TaskRagEvalReportItem()
10521078
```
10531079

10541080

1081+
---
1082+
base model for Rag Evaluation Report
1083+
1084+
1085+
**Attributes**
1086+
1087+
* **id** : str
1088+
* **creation_datetime** : datetime
1089+
* **name** : str
1090+
* **status** : JobStatus
1091+
* **from_datetime** : datetime
1092+
* **to_datetime** : datetime
1093+
1094+
1095+
----
1096+
1097+
1098+
## TaskTopicModelingReportDetails
1099+
```python
1100+
TaskTopicModelingReportDetails()
1101+
```
1102+
1103+
1104+
---
1105+
Task Topic Modeling Report Details base model
1106+
1107+
----
1108+
1109+
1110+
## TaskTopicModelingReportItem
1111+
```python
1112+
TaskTopicModelingReportItem()
1113+
```
1114+
1115+
1116+
---
1117+
Task Topic Modeling Report Item base model
10551118

10561119
----
10571120

0 commit comments

Comments
 (0)