@thinkingai/ae-cli 1.0.1 → 1.0.3
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.
- package/README.md +16 -13
- package/dist/auth-BQC5DBE7.js +19 -0
- package/dist/auth-DXKYLMO7.js +81 -0
- package/dist/chunk-3CDLNXTD.js +218 -0
- package/dist/chunk-53FNNCZW.js +174 -0
- package/dist/chunk-EBFUVWIZ.js +127 -0
- package/dist/chunk-ZYXIGPG7.js +148 -0
- package/dist/client-T4VODLA6.js +16 -0
- package/dist/community-FVDAWGS4.js +684 -0
- package/dist/config-V7AXKDMB.js +242 -0
- package/dist/index.js +16 -15
- package/dist/raw-G3GKHAPZ.js +61 -0
- package/dist/te-analysis-CHFTDN55.js +871 -0
- package/dist/te-audience-M6LQY6M7.js +350 -0
- package/dist/te-common-BLQ7DVGC.js +144 -0
- package/dist/te-dataops-V4OTKY35.js +1853 -0
- package/dist/te-engage-DXE4R5EW.js +1470 -0
- package/dist/te-meta-FMM7KCVI.js +479 -0
- package/package.json +7 -5
- package/skills/te-analysis/SKILL.md +10 -10
- package/skills/te-analysis/references/build-entity-details-sql.md +10 -10
- package/skills/te-analysis/references/build-event-details-sql.md +10 -10
- package/skills/te-analysis/references/create-alert.md +4 -4
- package/skills/te-analysis/references/create-dashboard.md +4 -4
- package/skills/te-analysis/references/create-or-update-dashboard-note.md +4 -4
- package/skills/te-analysis/references/create-public-access-link.md +4 -4
- package/skills/te-analysis/references/create-report.md +10 -10
- package/skills/te-analysis/references/create-result-cluster.md +4 -4
- package/skills/te-analysis/references/drilldown-user-events.md +6 -6
- package/skills/te-analysis/references/drilldown-users.md +4 -4
- package/skills/te-analysis/references/get-alert-definition-schema.md +3 -3
- package/skills/te-analysis/references/get-alert.md +3 -3
- package/skills/te-analysis/references/get-analysis-query-schema.md +4 -4
- package/skills/te-analysis/references/get-filter-schema.md +3 -3
- package/skills/te-analysis/references/get-groupby-schema.md +3 -3
- package/skills/te-analysis/references/get-report-definition.md +3 -3
- package/skills/te-analysis/references/get-table-columns.md +3 -3
- package/skills/te-analysis/references/list-alerts.md +4 -4
- package/skills/te-analysis/references/list-dashboards.md +4 -4
- package/skills/te-analysis/references/list-public-access-links.md +3 -3
- package/skills/te-analysis/references/list-reports.md +4 -4
- package/skills/te-analysis/references/load-filters.md +4 -4
- package/skills/te-analysis/references/query-adhoc.md +10 -10
- package/skills/te-analysis/references/query-dashboard-detail.md +3 -3
- package/skills/te-analysis/references/query-dashboard-report-data.md +9 -9
- package/skills/te-analysis/references/query-entity-details.md +10 -10
- package/skills/te-analysis/references/query-event-details.md +10 -10
- package/skills/te-analysis/references/query-report-data.md +11 -11
- package/skills/te-analysis/references/update-alert.md +4 -4
- package/skills/te-analysis/references/update-dashboard.md +4 -4
- package/skills/te-analysis/references/update-public-access-link.md +4 -4
- package/skills/te-audience/SKILL.md +5 -5
- package/skills/te-audience/references/create-cluster.md +10 -10
- package/skills/te-audience/references/create-tag.md +10 -10
- package/skills/te-audience/references/get-cluster-definition-schema.md +9 -9
- package/skills/te-audience/references/get-clusters-by-name.md +3 -3
- package/skills/te-audience/references/get-tag-definition-schema.md +3 -3
- package/skills/te-audience/references/get-tags-by-name.md +3 -3
- package/skills/te-audience/references/list-cluster-members.md +4 -4
- package/skills/te-audience/references/list-clusters.md +4 -4
- package/skills/te-audience/references/list-tag-members.md +4 -4
- package/skills/te-audience/references/list-tags.md +4 -4
- package/skills/te-audience/references/refresh-cluster.md +3 -3
- package/skills/te-audience/references/refresh-tag.md +3 -3
- package/skills/te-audience/references/update-cluster.md +9 -9
- package/skills/te-audience/references/update-tag.md +10 -10
- package/skills/te-common/SKILL.md +2 -2
- package/skills/te-common/references/get-resource-url.md +5 -5
- package/skills/te-common/references/list-projects.md +3 -3
- package/skills/te-community/SKILL.md +61 -69
- package/skills/te-community/references/community-activity-analysis.md +43 -43
- package/skills/te-community/references/community-analyzing-official-content.md +47 -47
- package/skills/te-community/references/community-analyzing-theme-comment.md +87 -87
- package/skills/te-community/references/community-character-analysis.md +44 -44
- package/skills/te-community/references/community-daily-report.md +56 -53
- package/skills/te-community/references/community-hottopic-insight.md +81 -87
- package/skills/te-community/references/community-weekly-report.md +54 -53
- package/skills/te-community/references/get_channel_info.md +9 -9
- package/skills/te-community/references/get_comment_tag_analysis.md +15 -15
- package/skills/te-community/references/get_comments_summary.md +15 -15
- package/skills/te-community/references/get_corpus_tags.md +9 -9
- package/skills/te-community/references/get_daily_summary.md +10 -10
- package/skills/te-community/references/get_hot_topics.md +12 -12
- package/skills/te-community/references/get_livestream_analysis.md +9 -9
- package/skills/te-community/references/get_livestream_detail.md +19 -19
- package/skills/te-community/references/get_livestream_list.md +13 -13
- package/skills/te-community/references/get_livestream_overview.md +11 -11
- package/skills/te-community/references/get_livestream_room_metrics.md +12 -12
- package/skills/te-community/references/get_livestream_rooms.md +12 -12
- package/skills/te-community/references/get_overview_metrics.md +12 -12
- package/skills/te-community/references/get_post_detail.md +21 -21
- package/skills/te-community/references/get_risk_content.md +23 -23
- package/skills/te-community/references/get_sentiment_overview.md +16 -16
- package/skills/te-community/references/get_tag_trends.md +13 -13
- package/skills/te-community/references/get_topic_detail.md +12 -12
- package/skills/te-community/references/search_posts.md +26 -26
- package/skills/te-dataops/SKILL.md +390 -392
- package/skills/te-dataops/references/dataops-flow-create.md +87 -87
- package/skills/te-dataops/references/dataops-flow-monitor.md +65 -65
- package/skills/te-dataops/references/dataops-integration.md +90 -85
- package/skills/te-dataops/references/dataops-query.md +58 -58
- package/skills/te-dataops/references/dataops-table.md +63 -63
- package/skills/te-engage/SKILL.md +103 -103
- package/skills/te-engage/references/add-approver.md +11 -11
- package/skills/te-engage/references/add-channel.md +34 -34
- package/skills/te-engage/references/approver-list.md +8 -8
- package/skills/te-engage/references/cancel-query-by-request-id.md +10 -10
- package/skills/te-engage/references/channel-detail.md +13 -13
- package/skills/te-engage/references/channel-list.md +15 -15
- package/skills/te-engage/references/config-channel-detail.md +10 -10
- package/skills/te-engage/references/config-channel-list.md +11 -11
- package/skills/te-engage/references/config-item-analysis-report.md +21 -21
- package/skills/te-engage/references/config-item-detail.md +10 -10
- package/skills/te-engage/references/config-item-list.md +8 -8
- package/skills/te-engage/references/config-item-strategy-comparison.md +14 -14
- package/skills/te-engage/references/config-item-trigger-report.md +26 -26
- package/skills/te-engage/references/copy-config-template.md +16 -16
- package/skills/te-engage/references/delete-channel.md +11 -11
- package/skills/te-engage/references/delete-config-channel.md +11 -11
- package/skills/te-engage/references/delete-config-item.md +12 -12
- package/skills/te-engage/references/delete-flow.md +11 -11
- package/skills/te-engage/references/flow-ab-split-node-report.md +29 -29
- package/skills/te-engage/references/flow-detail.md +19 -19
- package/skills/te-engage/references/flow-list.md +8 -8
- package/skills/te-engage/references/flow-node-config-schema.md +11 -11
- package/skills/te-engage/references/flow-node-detail-report.md +30 -30
- package/skills/te-engage/references/flow-node-overview-report.md +27 -27
- package/skills/te-engage/references/flow-process-report.md +32 -32
- package/skills/te-engage/references/manage-flow.md +44 -44
- package/skills/te-engage/references/manage-strategy.md +37 -37
- package/skills/te-engage/references/manage-task.md +20 -20
- package/skills/te-engage/references/modify-flow-base-info.md +14 -14
- package/skills/te-engage/references/save-flow.md +264 -263
- package/skills/te-engage/references/strategy-detail.md +16 -16
- package/skills/te-engage/references/strategy-list.md +10 -10
- package/skills/te-engage/references/task-data-detail.md +47 -47
- package/skills/te-engage/references/task-data-overview.md +23 -23
- package/skills/te-engage/references/task-detail.md +18 -18
- package/skills/te-engage/references/task-experiment-report.md +26 -26
- package/skills/te-engage/references/task-list.md +35 -35
- package/skills/te-engage/references/task-metric-detail.md +31 -31
- package/skills/te-engage/references/task-stats.md +31 -31
- package/skills/te-engage/references/update-channel-status.md +13 -13
- package/skills/te-engage/references/update-config-channel-status.md +14 -14
- package/skills/te-engage/references/validate-flow-node-config.md +15 -15
- package/skills/te-engage/references/whitelist-list.md +8 -8
- package/skills/te-meta/SKILL.md +5 -5
- package/skills/te-meta/references/batch-create-metadata.md +4 -4
- package/skills/te-meta/references/batch-edit-metadata.md +3 -3
- package/skills/te-meta/references/create-metric.md +12 -12
- package/skills/te-meta/references/create-project-mark-time.md +4 -4
- package/skills/te-meta/references/create-virtual-event.md +10 -10
- package/skills/te-meta/references/create-virtual-property.md +8 -8
- package/skills/te-meta/references/delete-project-mark-times.md +3 -3
- package/skills/te-meta/references/delete-track-items.md +3 -3
- package/skills/te-meta/references/get-metric.md +3 -3
- package/skills/te-meta/references/get-project-config.md +3 -3
- package/skills/te-meta/references/get-track-program.md +3 -3
- package/skills/te-meta/references/list-entities.md +4 -4
- package/skills/te-meta/references/list-events.md +4 -4
- package/skills/te-meta/references/list-metrics.md +4 -4
- package/skills/te-meta/references/list-project-mark-times.md +4 -4
- package/skills/te-meta/references/list-project-users.md +3 -3
- package/skills/te-meta/references/list-properties.md +4 -4
- package/skills/te-meta/references/save-track-items.md +3 -3
- package/skills/te-meta/references/update-metric.md +10 -10
- package/skills/te-meta/references/update-project-mark-time.md +4 -4
- package/skills/te-shared/SKILL.md +8 -8
- package/skills/te-community/references/community-release-analysis.md +0 -79
- package/skills/te-dataops/references/dataops-operations.md +0 -107
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# analysis +query_entity_details (query entity details)
|
|
2
2
|
|
|
3
3
|
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
@@ -18,16 +18,16 @@ Domain: **Entity Detail Queries**
|
|
|
18
18
|
|
|
19
19
|
## Prerequisite Call Chain (required for building definition/properties)
|
|
20
20
|
1. First confirm the cluster type (condition / sql).
|
|
21
|
-
2. Read `get-cluster-definition-schema.md`, then call `ae-cli
|
|
22
|
-
3. Read `list-events.md`, then call `ae-cli
|
|
23
|
-
4. Read `list-properties.md`, then call `ae-cli
|
|
21
|
+
2. Read `get-cluster-definition-schema.md`, then call `ae-cli analysis_audience +get_cluster_definition_schema --cluster_type <condition|sql>` to get the structure.
|
|
22
|
+
3. Read `list-events.md`, then call `ae-cli analysis_meta +list_events --project_id 1`.
|
|
23
|
+
4. Read `list-properties.md`, then call `ae-cli analysis_meta +list_properties --project_id 1`.
|
|
24
24
|
5. Build `definition` (and optional `properties`) based on the schema and metadata, then call `+query_entity_details`.
|
|
25
25
|
|
|
26
26
|
## Commands
|
|
27
27
|
```bash
|
|
28
|
-
ae-cli
|
|
29
|
-
ae-cli
|
|
30
|
-
ae-cli
|
|
28
|
+
ae-cli analysis +query_entity_details --project_id 1 --definition '{}'
|
|
29
|
+
ae-cli analysis +query_entity_details --project_id 1 --entity_id 1001 --definition '{}' --properties '{}' --sort_by time --sort_order desc --limit 100 --zone_offset 8 --use_cache true
|
|
30
|
+
ae-cli analysis +query_entity_details --dry-run
|
|
31
31
|
```
|
|
32
32
|
|
|
33
33
|
## Parameters
|
|
@@ -35,8 +35,8 @@ ae-cli te_analysis +query_entity_details --dry-run
|
|
|
35
35
|
|---|---|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
|
36
36
|
| `--project_id` / `-p` | Yes | Project ID |
|
|
37
37
|
| `--entity_id` | No | Optional entity ID used in multi-entity scenarios. If omitted, the default user entity is used. |
|
|
38
|
-
| `--definition` | Yes | Cluster definition JSON. MUST call `+get_cluster_definition_schema` first, then fill valid event/property names from `
|
|
39
|
-
| `--properties` | No | Optional display properties JSON, for example `[{"columnName":"#user_id","tableType":"0"},{"columnName":"device_id","tableType":"0"}]`. If provided, property names should come from `
|
|
38
|
+
| `--definition` | Yes | Cluster definition JSON. MUST call `+get_cluster_definition_schema` first, then fill valid event/property names from `analysis_meta +list_events` / `analysis_meta +list_properties` in the same `project_id`. |
|
|
39
|
+
| `--properties` | No | Optional display properties JSON, for example `[{"columnName":"#user_id","tableType":"0"},{"columnName":"device_id","tableType":"0"}]`. If provided, property names should come from `analysis_meta +list_properties` in the same `project_id`. |
|
|
40
40
|
| `--sort_by` | No | Optional sort field |
|
|
41
41
|
| `--sort_order` | No | Optional sort order. Supported values: asc and desc |
|
|
42
42
|
| `--limit` | No | Optional result limit. Default: 1000, maximum: 10000 |
|
|
@@ -56,5 +56,5 @@ ae-cli te_analysis +query_entity_details --dry-run
|
|
|
56
56
|
- If the query times out or the result is abnormal, first reduce the time range/grouping dimensions, then split the query to locate the issue.
|
|
57
57
|
|
|
58
58
|
## Recommended Chaining
|
|
59
|
-
- +get_cluster_definition_schema ->
|
|
59
|
+
- +get_cluster_definition_schema -> analysis_meta +list_events -> analysis_meta +list_properties -> +query_entity_details
|
|
60
60
|
- +query_entity_details -> +query_event_details -> +build_event_details_sql
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# analysis +query_event_details (Query Event Details)
|
|
2
2
|
|
|
3
3
|
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
@@ -17,16 +17,16 @@ Domain: **Event detail queries**
|
|
|
17
17
|
- Do not generate the final `filters` / `properties` until the documentation review and prerequisite command calls are complete.
|
|
18
18
|
|
|
19
19
|
## Prerequisite call chain (required for constructing filters/properties)
|
|
20
|
-
1. Read `get-filter-schema.md`, then call `
|
|
21
|
-
2. Read `list-events.md`, then call `
|
|
22
|
-
3. Read `list-properties.md`, then call `
|
|
20
|
+
1. Read `get-filter-schema.md`, then call `ae-cli analysis +get_filter_schema` to get the filter structure.
|
|
21
|
+
2. Read `list-events.md`, then call `ae-cli analysis_meta +list_events --project_id 1` to confirm the available event names.
|
|
22
|
+
3. Read `list-properties.md`, then call `ae-cli analysis_meta +list_properties --project_id 1` to get the available properties.
|
|
23
23
|
4. Build `filters` / `properties` from the schema + metadata, then call `+query_event_details`.
|
|
24
24
|
|
|
25
25
|
## Command
|
|
26
26
|
```bash
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
27
|
+
ae-cli analysis +query_event_details --project_id 1 --event_name login --start_time '2026-04-08 00:00:00' --end_time '2026-04-08 23:59:59'
|
|
28
|
+
ae-cli analysis +query_event_details --project_id 1 --event_name login --relative_date_range 0-7 --filters '{}' --properties '{}' --sort_by time --sort_order desc --limit 100 --zone_offset 8 --use_cache true
|
|
29
|
+
ae-cli analysis +query_event_details --dry-run
|
|
30
30
|
```
|
|
31
31
|
|
|
32
32
|
## Parameters
|
|
@@ -37,8 +37,8 @@ te-cli te_analysis +query_event_details --dry-run
|
|
|
37
37
|
| `--start_time` | No | Start time. Format: yyyy-MM-dd HH:mm:ss |
|
|
38
38
|
| `--end_time` | No | End time. Format: yyyy-MM-dd HH:mm:ss |
|
|
39
39
|
| `--relative_date_range` | No | Optional relative date range in m-n format. For example, 0-7 means the most recent 7 days including today. Use either this field or start_time/end_time. |
|
|
40
|
-
| `--filters` | No | Optional filter JSON. If provided, MUST follow `+get_filter_schema`, and referenced fields must come from `
|
|
41
|
-
| `--properties` | No | Optional display properties JSON, for example `[{"columnName":"#user_id","tableType":"0"},{"columnName":"device_id","tableType":"0"}]`. If provided, property names should come from `
|
|
40
|
+
| `--filters` | No | Optional filter JSON. If provided, MUST follow `+get_filter_schema`, and referenced fields must come from `analysis_meta +list_properties` in the same `project_id`. |
|
|
41
|
+
| `--properties` | No | Optional display properties JSON, for example `[{"columnName":"#user_id","tableType":"0"},{"columnName":"device_id","tableType":"0"}]`. If provided, property names should come from `analysis_meta +list_properties` in the same `project_id`. |
|
|
42
42
|
| `--sort_by` | No | Optional sort field |
|
|
43
43
|
| `--sort_order` | No | Optional sort order. Supported values: asc and desc |
|
|
44
44
|
| `--limit` | No | Optional result limit. Default: 1000 |
|
|
@@ -59,5 +59,5 @@ te-cli te_analysis +query_event_details --dry-run
|
|
|
59
59
|
- If the query times out or results are abnormal, first narrow the time range / grouping dimensions, then split the subqueries to locate the issue.
|
|
60
60
|
|
|
61
61
|
## Recommended chaining
|
|
62
|
-
- +get_filter_schema ->
|
|
62
|
+
- +get_filter_schema -> analysis_meta +list_events -> analysis_meta +list_properties -> +query_event_details
|
|
63
63
|
- +query_entity_details -> +query_event_details -> +build_event_details_sql
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# analysis +query_report_data (query data by report)
|
|
2
2
|
|
|
3
3
|
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
@@ -20,17 +20,17 @@ Domain: **Report Management**
|
|
|
20
20
|
- Do not generate final `filters` / `group_by` until the above docs have been read and the prerequisite commands have been called.
|
|
21
21
|
|
|
22
22
|
## Prerequisite Call Chain (required for building filters/group_by)
|
|
23
|
-
1. Read `get-filter-schema.md`, then call `ae-cli
|
|
24
|
-
2. Read `get-groupby-schema.md`, then call `ae-cli
|
|
25
|
-
3. Read `list-events.md`, then call `ae-cli
|
|
26
|
-
4. Read `list-properties.md`, then call `ae-cli
|
|
23
|
+
1. Read `get-filter-schema.md`, then call `ae-cli analysis +get_filter_schema` to get the filter structure.
|
|
24
|
+
2. Read `get-groupby-schema.md`, then call `ae-cli analysis +get_groupby_schema` to get the grouping structure.
|
|
25
|
+
3. Read `list-events.md`, then call `ae-cli analysis_meta +list_events --project_id 1`.
|
|
26
|
+
4. Read `list-properties.md`, then call `ae-cli analysis_meta +list_properties --project_id 1`.
|
|
27
27
|
5. Build `filters` / `group_by` based on the schema and metadata, then call `+query_report_data`.
|
|
28
28
|
|
|
29
29
|
## Commands
|
|
30
30
|
```bash
|
|
31
|
-
ae-cli
|
|
32
|
-
ae-cli
|
|
33
|
-
ae-cli
|
|
31
|
+
ae-cli analysis +query_report_data --project_id 1 --report_ids '[1001]'
|
|
32
|
+
ae-cli analysis +query_report_data --project_id 1 --report_ids '[1001]' --filters '{}' --group_by '[]' --request_id demo --use_cache true --start_date 2026-04-08 --end_date 2026-04-08 --time_granularity day --timeout_minutes 8
|
|
33
|
+
ae-cli analysis +query_report_data --dry-run
|
|
34
34
|
```
|
|
35
35
|
|
|
36
36
|
## Parameters
|
|
@@ -38,8 +38,8 @@ ae-cli te_analysis +query_report_data --dry-run
|
|
|
38
38
|
|---|---|---|
|
|
39
39
|
| `--project_id` / `-p` | Yes | Project ID |
|
|
40
40
|
| `--report_ids` | Yes | List of report IDs |
|
|
41
|
-
| `--filters` | No | Optional filter JSON. If provided, MUST follow `+get_filter_schema`, and referenced fields must come from `
|
|
42
|
-
| `--group_by` | No | Optional group-by JSON array. If provided, MUST follow `+get_groupby_schema`, and referenced fields must come from `
|
|
41
|
+
| `--filters` | No | Optional filter JSON. If provided, MUST follow `+get_filter_schema`, and referenced fields must come from `analysis_meta +list_properties` in the same `project_id`. |
|
|
42
|
+
| `--group_by` | No | Optional group-by JSON array. If provided, MUST follow `+get_groupby_schema`, and referenced fields must come from `analysis_meta +list_properties` in the same `project_id`. |
|
|
43
43
|
| `--request_id` | No | Optional unique request ID. Generated automatically if omitted. |
|
|
44
44
|
| `--use_cache` | No | Whether to use cache. Default: true |
|
|
45
45
|
| `--start_date` | No | Optional start date in yyyy-MM-dd format |
|
|
@@ -61,5 +61,5 @@ ae-cli te_analysis +query_report_data --dry-run
|
|
|
61
61
|
- If the query times out or the result is abnormal, first reduce the time range/grouping dimensions, then split the query to locate the issue.
|
|
62
62
|
|
|
63
63
|
## Recommended Chaining
|
|
64
|
-
- +get_filter_schema -> +get_groupby_schema ->
|
|
64
|
+
- +get_filter_schema -> +get_groupby_schema -> analysis_meta +list_events -> analysis_meta +list_properties -> +query_report_data
|
|
65
65
|
- +list_reports -> +get_report_definition -> +query_report_data
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# analysis +update_alert (Update Alert)
|
|
2
2
|
|
|
3
3
|
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
@@ -16,13 +16,13 @@ Domain: **Metadata queries**
|
|
|
16
16
|
|
|
17
17
|
## Prerequisite call chain (required for updating definition)
|
|
18
18
|
1. Read `get-alert-definition-schema.md` to understand the return structure of `+get_alert_definition_schema`.
|
|
19
|
-
2. Call `
|
|
19
|
+
2. Call `ae-cli analysis +get_alert_definition_schema` to get the schema.
|
|
20
20
|
3. Build a new `definition` from the schema, then call `+update_alert`.
|
|
21
21
|
|
|
22
22
|
## Command
|
|
23
23
|
```bash
|
|
24
|
-
|
|
25
|
-
|
|
24
|
+
ae-cli analysis +update_alert --project_id 1 --alert_id 1 --definition '{}'
|
|
25
|
+
ae-cli analysis +update_alert --dry-run
|
|
26
26
|
```
|
|
27
27
|
|
|
28
28
|
## Parameters
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# analysis +update_dashboard (update dashboard)
|
|
2
2
|
|
|
3
3
|
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
@@ -16,9 +16,9 @@ Domain: **Dashboard Management**
|
|
|
16
16
|
|
|
17
17
|
## Commands
|
|
18
18
|
```bash
|
|
19
|
-
ae-cli
|
|
20
|
-
ae-cli
|
|
21
|
-
ae-cli
|
|
19
|
+
ae-cli analysis +update_dashboard --project_id 1 --dashboard_id 1
|
|
20
|
+
ae-cli analysis +update_dashboard --project_id 1 --dashboard_id 1 --dashboard_name demo --report_ids '[1001]' --member_authorities '{"1001":"READ"}'
|
|
21
|
+
ae-cli analysis +update_dashboard --dry-run
|
|
22
22
|
```
|
|
23
23
|
|
|
24
24
|
## Parameters
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# analysis +update_public_access_link (Update Public Access Link)
|
|
2
2
|
|
|
3
3
|
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
@@ -10,9 +10,9 @@ Domain: **Dashboard management**
|
|
|
10
10
|
|
|
11
11
|
## Command
|
|
12
12
|
```bash
|
|
13
|
-
ae-cli
|
|
14
|
-
ae-cli
|
|
15
|
-
ae-cli
|
|
13
|
+
ae-cli analysis +update_public_access_link --project_id 1 --link_id 1 --access_controls '{}' --effective_at "2026-04-09 10:00:00" --expires_at "2026-04-10 10:00:00"
|
|
14
|
+
ae-cli analysis +update_public_access_link --project_id 1 --company_id 1 --link_id 1 --access_controls '{}' --remark demo --effective_at "2026-04-09 10:00:00" --expires_at "2026-04-10 10:00:00"
|
|
15
|
+
ae-cli analysis +update_public_access_link --dry-run
|
|
16
16
|
```
|
|
17
17
|
|
|
18
18
|
## Parameters
|
|
@@ -5,7 +5,7 @@ description: "TE audience operations and targeting: create, update, query, recom
|
|
|
5
5
|
metadata:
|
|
6
6
|
requires:
|
|
7
7
|
bins: ["ae-cli"]
|
|
8
|
-
cliHelp: "ae-cli
|
|
8
|
+
cliHelp: "ae-cli analysis_audience --help"
|
|
9
9
|
---
|
|
10
10
|
|
|
11
11
|
# te-audience
|
|
@@ -25,7 +25,7 @@ Use `te-audience` when the user needs cluster and tag capabilities:
|
|
|
25
25
|
|
|
26
26
|
## Command Format
|
|
27
27
|
|
|
28
|
-
`ae-cli
|
|
28
|
+
`ae-cli analysis_audience +<tool_name> [options]`
|
|
29
29
|
|
|
30
30
|
## Tool Groups (14)
|
|
31
31
|
|
|
@@ -52,10 +52,10 @@ Use `te-audience` when the user needs cluster and tag capabilities:
|
|
|
52
52
|
## Quick Validation
|
|
53
53
|
|
|
54
54
|
```bash
|
|
55
|
-
ae-cli
|
|
56
|
-
npm run verify:
|
|
55
|
+
ae-cli analysis_audience --help
|
|
56
|
+
npm run verify:analysis-audience-tools
|
|
57
57
|
# Example: preview the request with dry-run (replace project_id with your actual project ID)
|
|
58
|
-
ae-cli
|
|
58
|
+
ae-cli analysis_audience +list_clusters --project_id <YOUR_PROJECT_ID> --dry-run
|
|
59
59
|
```
|
|
60
60
|
|
|
61
61
|
## Reference Docs
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# analysis_audience +create_cluster (Create Cluster)
|
|
2
2
|
|
|
3
3
|
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
@@ -6,7 +6,7 @@ Domain: **Cluster Management**
|
|
|
6
6
|
|
|
7
7
|
## Use Cases
|
|
8
8
|
- Prerequisite helper: first call `+get_cluster_definition_schema` to obtain the `definition` structure, then call this tool.
|
|
9
|
-
- When building a real `definition`, you must supplement it with real project metadata: first call `
|
|
9
|
+
- When building a real `definition`, you must supplement it with real project metadata: first call `analysis_meta +list_events` and `analysis_meta +list_properties`, then fill in event names/property names.
|
|
10
10
|
- Create a user cluster definition. Supports the condition and sql cluster types. Returns cluster information without cluster members.
|
|
11
11
|
|
|
12
12
|
## Required Prerequisites (MUST)
|
|
@@ -19,20 +19,20 @@ Domain: **Cluster Management**
|
|
|
19
19
|
## Prerequisite Call Chain (Required for Building Definition)
|
|
20
20
|
1. Read `get-cluster-definition-schema.md` to understand the input and output structure of `+get_cluster_definition_schema`.
|
|
21
21
|
2. Obtain the schema structure (by cluster type):
|
|
22
|
-
`
|
|
22
|
+
`ae-cli analysis_audience +get_cluster_definition_schema --cluster_type condition`
|
|
23
23
|
3. Read `list-events.md` to understand the parameters and return structure of `+list_events`.
|
|
24
24
|
4. Get the event list (for `event_name` and other fields):
|
|
25
|
-
`
|
|
25
|
+
`ae-cli analysis_meta +list_events --project_id 1`
|
|
26
26
|
5. Read `list-properties.md` to understand the parameters and return structure of `+list_properties`.
|
|
27
27
|
6. Get the property list (for property filters, grouping, and comparison fields):
|
|
28
|
-
`
|
|
28
|
+
`ae-cli analysis_meta +list_properties --project_id 1`
|
|
29
29
|
7. Build `definition` based on the schema + metadata, then call `+create_cluster`.
|
|
30
30
|
|
|
31
31
|
## Commands
|
|
32
32
|
```bash
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
33
|
+
ae-cli analysis_audience +create_cluster --project_id 1 --cluster_name demo --display_name demo --definition '{}'
|
|
34
|
+
ae-cli analysis_audience +create_cluster --project_id 1 --cluster_name demo --display_name demo --type condition --definition '{}' --zone_offset 8 --entity_id 1001
|
|
35
|
+
ae-cli analysis_audience +create_cluster --dry-run
|
|
36
36
|
```
|
|
37
37
|
|
|
38
38
|
## Parameters
|
|
@@ -42,7 +42,7 @@ te-cli te_audience +create_cluster --dry-run
|
|
|
42
42
|
| `--cluster_name` | Yes | Cluster name. Must start with a letter and contain only letters, digits, and underscores. Length: 1-80 |
|
|
43
43
|
| `--display_name` | Yes | Cluster display name. Length: 1-80 |
|
|
44
44
|
| `--type` | No | Cluster type. Supported values: condition and sql. Default: condition |
|
|
45
|
-
| `--definition` | Yes | Cluster definition JSON. MUST call `+get_cluster_definition_schema` first to learn the exact structure, then use `
|
|
45
|
+
| `--definition` | Yes | Cluster definition JSON. MUST call `+get_cluster_definition_schema` first to learn the exact structure, then use `analysis_meta +list_events` / `analysis_meta +list_properties` to fill valid event/property names from the target project. |
|
|
46
46
|
| `--zone_offset` | No | Optional time zone offset for cluster computation. Valid range: -12 to 14 (supports decimals like 5.5). If the user does not specify a timezone, omit this parameter. When a timezone is specified, call get_project_config first to check whether the project supports time zones (timeZoneEnabled) and available values (availableTimeZones). |
|
|
47
47
|
| `--entity_id` | No | Optional entity ID for cluster definition. Use list_entities to query available entities. |
|
|
48
48
|
|
|
@@ -61,5 +61,5 @@ te-cli te_audience +create_cluster --dry-run
|
|
|
61
61
|
- If the result after writing is not as expected, immediately re-read the corresponding list/get interfaces and compare before and after.
|
|
62
62
|
|
|
63
63
|
## Recommended Chain
|
|
64
|
-
- +get_cluster_definition_schema ->
|
|
64
|
+
- +get_cluster_definition_schema -> analysis_meta +list_events -> analysis_meta +list_properties -> +create_cluster
|
|
65
65
|
- +list_clusters -> +get_clusters_by_name -> +update_cluster
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# analysis_audience +create_tag (Create Tag)
|
|
2
2
|
|
|
3
3
|
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
@@ -6,7 +6,7 @@ Domain: **Tag Management**
|
|
|
6
6
|
|
|
7
7
|
## Use Cases
|
|
8
8
|
- Prerequisite helper: first call `+get_tag_definition_schema` to obtain the structure, then call this tool.
|
|
9
|
-
- When building a real `definition`, you must supplement it with real project metadata; at minimum, first call `
|
|
9
|
+
- When building a real `definition`, you must supplement it with real project metadata; at minimum, first call `analysis_meta +list_events` and `analysis_meta +list_properties`.
|
|
10
10
|
- Create a user tag definition. Supports the condition, metric, first_last, and sql tag types. Returns the new tag ID without tag members.
|
|
11
11
|
|
|
12
12
|
## Required Prerequisites (MUST)
|
|
@@ -19,16 +19,16 @@ Domain: **Tag Management**
|
|
|
19
19
|
## Prerequisite Call Chain (Required for Building Definition)
|
|
20
20
|
1. First determine `--type` (condition / metric / first_last / sql).
|
|
21
21
|
2. Read `get-tag-definition-schema.md` to understand the return structure of `+get_tag_definition_schema`.
|
|
22
|
-
3. Call `
|
|
23
|
-
4. Read `list-events.md`, then call `
|
|
24
|
-
5. Read `list-properties.md`, then call `
|
|
22
|
+
3. Call `ae-cli analysis_audience +get_tag_definition_schema` to obtain the schema.
|
|
23
|
+
4. Read `list-events.md`, then call `ae-cli analysis_meta +list_events --project_id 1` to get available events.
|
|
24
|
+
5. Read `list-properties.md`, then call `ae-cli analysis_meta +list_properties --project_id 1` to get available properties.
|
|
25
25
|
6. Build `definition` based on the schema + metadata, then call `+create_tag`.
|
|
26
26
|
|
|
27
27
|
## Commands
|
|
28
28
|
```bash
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
29
|
+
ae-cli analysis_audience +create_tag --project_id 1 --tag_name demo --display_name demo --definition '{}'
|
|
30
|
+
ae-cli analysis_audience +create_tag --project_id 1 --tag_name demo --display_name demo --type condition --definition '{}' --zone_offset 8 --entity_id 1001
|
|
31
|
+
ae-cli analysis_audience +create_tag --dry-run
|
|
32
32
|
```
|
|
33
33
|
|
|
34
34
|
## Parameters
|
|
@@ -38,7 +38,7 @@ te-cli te_audience +create_tag --dry-run
|
|
|
38
38
|
| `--tag_name` | Yes | Tag name. Must start with a letter and contain only letters, digits, and underscores. Length: 1-80 |
|
|
39
39
|
| `--display_name` | Yes | Tag display name. Length: 1-80 |
|
|
40
40
|
| `--type` | No | Tag type. Supported values: condition, metric, first_last, sql |
|
|
41
|
-
| `--definition` | Yes | Tag definition JSON. MUST call `+get_tag_definition_schema` first, then fill valid event/property names from `
|
|
41
|
+
| `--definition` | Yes | Tag definition JSON. MUST call `+get_tag_definition_schema` first, then fill valid event/property names from `analysis_meta` metadata commands in the same `project_id`. |
|
|
42
42
|
| `--zone_offset` | No | Optional time zone offset for tag computation. Valid range: -12 to 14 (supports decimals like 5.5). If the user does not specify a timezone, omit this parameter. When a timezone is specified, call get_project_config first to check whether the project supports time zones (timeZoneEnabled) and available values (availableTimeZones). |
|
|
43
43
|
| `--entity_id` | No | Optional entity ID for tag definition. Use list_entities to query available entities. |
|
|
44
44
|
|
|
@@ -56,5 +56,5 @@ te-cli te_audience +create_tag --dry-run
|
|
|
56
56
|
- If the result after writing is not as expected, immediately re-read the corresponding list/get interfaces and compare before and after.
|
|
57
57
|
|
|
58
58
|
## Recommended Chain
|
|
59
|
-
- +get_tag_definition_schema ->
|
|
59
|
+
- +get_tag_definition_schema -> analysis_meta +list_events -> analysis_meta +list_properties -> +create_tag
|
|
60
60
|
- +list_tags -> +get_tags_by_name -> +update_tag
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# analysis_audience +get_cluster_definition_schema (Get Cluster Definition Schema)
|
|
2
2
|
|
|
3
3
|
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
@@ -6,14 +6,14 @@ Domain: **Schema Query**
|
|
|
6
6
|
|
|
7
7
|
## Use Cases
|
|
8
8
|
- Support tool positioning: the current command provides the structure definition (schema) and should be used as a prerequisite step.
|
|
9
|
-
- Recommended sequence: first call this schema tool to get the structure, then call `
|
|
9
|
+
- Recommended sequence: first call this schema tool to get the structure, then call `analysis_meta +list_events` / `analysis_meta +list_properties` to obtain real metadata, and finally create or update clusters.
|
|
10
10
|
- Get the cluster definition schema. Supports the condition and sql cluster types and returns field definitions, enum descriptions, and examples.
|
|
11
11
|
|
|
12
12
|
## Commands
|
|
13
13
|
```bash
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
14
|
+
ae-cli analysis_audience +get_cluster_definition_schema --cluster_type condition
|
|
15
|
+
ae-cli analysis_audience +get_cluster_definition_schema --cluster_type sql
|
|
16
|
+
ae-cli analysis_audience +get_cluster_definition_schema --dry-run
|
|
17
17
|
```
|
|
18
18
|
|
|
19
19
|
## Parameters
|
|
@@ -24,8 +24,8 @@ te-cli te_audience +get_cluster_definition_schema --dry-run
|
|
|
24
24
|
## Decision Rules
|
|
25
25
|
- `--cluster_type` must be explicitly set to `condition` or `sql`.
|
|
26
26
|
- It is recommended to run `--dry-run` first to inspect the request mapping before making the actual call.
|
|
27
|
-
- The current command returns only structure constraints; it does not guarantee that the field values are available in the target project. Event names and property names must be confirmed again with `
|
|
28
|
-
- Before calling `
|
|
27
|
+
- The current command returns only structure constraints; it does not guarantee that the field values are available in the target project. Event names and property names must be confirmed again with `analysis_meta` metadata interfaces.
|
|
28
|
+
- Before calling `analysis_meta +list_events` / `analysis_meta +list_properties`, first read their reference docs to confirm the parameter and return-field meanings.
|
|
29
29
|
|
|
30
30
|
## Next Step on Failure
|
|
31
31
|
- If reading fails, first verify whether the object ID exists and belongs to the current project.
|
|
@@ -33,5 +33,5 @@ te-cli te_audience +get_cluster_definition_schema --dry-run
|
|
|
33
33
|
|
|
34
34
|
## Recommended Chain
|
|
35
35
|
- First read: [`./get-cluster-definition-schema.md`](./get-cluster-definition-schema.md) -> [`../../te-meta/references/list-events.md`](../../te-meta/references/list-events.md) -> [`../../te-meta/references/list-properties.md`](../../te-meta/references/list-properties.md)
|
|
36
|
-
- +get_cluster_definition_schema ->
|
|
37
|
-
- +get_cluster_definition_schema ->
|
|
36
|
+
- +get_cluster_definition_schema -> analysis_meta +list_events -> analysis_meta +list_properties -> +create_cluster
|
|
37
|
+
- +get_cluster_definition_schema -> analysis_meta +list_events -> analysis_meta +list_properties -> +update_cluster
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# analysis_audience +get_clusters_by_name (Locate Clusters by Name)
|
|
2
2
|
|
|
3
3
|
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
@@ -9,8 +9,8 @@ Domain: **Cluster Management**
|
|
|
9
9
|
|
|
10
10
|
## Commands
|
|
11
11
|
```bash
|
|
12
|
-
|
|
13
|
-
|
|
12
|
+
ae-cli analysis_audience +get_clusters_by_name --project_id 1 --names '["demo"]'
|
|
13
|
+
ae-cli analysis_audience +get_clusters_by_name --dry-run
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
## Parameters
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# analysis_audience +get_tag_definition_schema (Get Tag Definition Schema)
|
|
2
2
|
|
|
3
3
|
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
@@ -12,8 +12,8 @@ Domain: **Schema Query**
|
|
|
12
12
|
|
|
13
13
|
## Commands
|
|
14
14
|
```bash
|
|
15
|
-
|
|
16
|
-
|
|
15
|
+
ae-cli analysis_audience +get_tag_definition_schema
|
|
16
|
+
ae-cli analysis_audience +get_tag_definition_schema --dry-run
|
|
17
17
|
```
|
|
18
18
|
|
|
19
19
|
## Parameters
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# analysis_audience +get_tags_by_name (Locate Tags by Name)
|
|
2
2
|
|
|
3
3
|
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
@@ -9,8 +9,8 @@ Domain: **Tag Management**
|
|
|
9
9
|
|
|
10
10
|
## Commands
|
|
11
11
|
```bash
|
|
12
|
-
|
|
13
|
-
|
|
12
|
+
ae-cli analysis_audience +get_tags_by_name --project_id 1 --names '["demo"]'
|
|
13
|
+
ae-cli analysis_audience +get_tags_by_name --dry-run
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
## Parameters
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# analysis_audience +list_cluster_members (View Cluster Members)
|
|
2
2
|
|
|
3
3
|
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
@@ -9,9 +9,9 @@ Domain: **Cluster Management**
|
|
|
9
9
|
|
|
10
10
|
## Commands
|
|
11
11
|
```bash
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
12
|
+
ae-cli analysis_audience +list_cluster_members --project_id 1 --cluster_name demo
|
|
13
|
+
ae-cli analysis_audience +list_cluster_members --project_id 1 --cluster_name demo --property_names '["#user_id","name"]' --use_cache false
|
|
14
|
+
ae-cli analysis_audience +list_cluster_members --dry-run
|
|
15
15
|
```
|
|
16
16
|
|
|
17
17
|
## Parameters
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# analysis_audience +list_clusters (Cluster Search)
|
|
2
2
|
|
|
3
3
|
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
@@ -9,9 +9,9 @@ Domain: **Cluster Management**
|
|
|
9
9
|
|
|
10
10
|
## Commands
|
|
11
11
|
```bash
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
12
|
+
ae-cli analysis_audience +list_clusters --project_id 1
|
|
13
|
+
ae-cli analysis_audience +list_clusters --project_id 1 --query demo
|
|
14
|
+
ae-cli analysis_audience +list_clusters --dry-run
|
|
15
15
|
```
|
|
16
16
|
|
|
17
17
|
## Parameters
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# analysis_audience +list_tag_members (View Tag Members)
|
|
2
2
|
|
|
3
3
|
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
@@ -9,9 +9,9 @@ Domain: **Tag Management**
|
|
|
9
9
|
|
|
10
10
|
## Commands
|
|
11
11
|
```bash
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
12
|
+
ae-cli analysis_audience +list_tag_members --project_id 1 --tag_name demo
|
|
13
|
+
ae-cli analysis_audience +list_tag_members --project_id 1 --tag_name demo --snapshot_date 2026-04-01 --property_names '["#user_id","name"]' --use_cache false
|
|
14
|
+
ae-cli analysis_audience +list_tag_members --dry-run
|
|
15
15
|
```
|
|
16
16
|
|
|
17
17
|
## Parameters
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# analysis_audience +list_tags (Tag Search)
|
|
2
2
|
|
|
3
3
|
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
@@ -9,9 +9,9 @@ Domain: **Tag Management**
|
|
|
9
9
|
|
|
10
10
|
## Commands
|
|
11
11
|
```bash
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
12
|
+
ae-cli analysis_audience +list_tags --project_id 1
|
|
13
|
+
ae-cli analysis_audience +list_tags --project_id 1 --query demo
|
|
14
|
+
ae-cli analysis_audience +list_tags --dry-run
|
|
15
15
|
```
|
|
16
16
|
|
|
17
17
|
## Parameters
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# analysis_audience +refresh_cluster (Trigger Cluster Recompute)
|
|
2
2
|
|
|
3
3
|
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
@@ -9,8 +9,8 @@ Domain: **Cluster Management**
|
|
|
9
9
|
|
|
10
10
|
## Commands
|
|
11
11
|
```bash
|
|
12
|
-
|
|
13
|
-
|
|
12
|
+
ae-cli analysis_audience +refresh_cluster --project_id 1 --cluster_name demo
|
|
13
|
+
ae-cli analysis_audience +refresh_cluster --dry-run
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
## Parameters
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# analysis_audience +refresh_tag (Trigger Tag Recompute)
|
|
2
2
|
|
|
3
3
|
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
@@ -9,8 +9,8 @@ Domain: **Tag Management**
|
|
|
9
9
|
|
|
10
10
|
## Commands
|
|
11
11
|
```bash
|
|
12
|
-
|
|
13
|
-
|
|
12
|
+
ae-cli analysis_audience +refresh_tag --project_id 1 --tag_name demo
|
|
13
|
+
ae-cli analysis_audience +refresh_tag --dry-run
|
|
14
14
|
```
|
|
15
15
|
|
|
16
16
|
## Parameters
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# analysis_audience +update_cluster (Update Cluster)
|
|
2
2
|
|
|
3
3
|
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
@@ -17,16 +17,16 @@ Domain: **Cluster Management**
|
|
|
17
17
|
|
|
18
18
|
## Prerequisite Call Chain (run only when updating definition)
|
|
19
19
|
1. First determine `--type` (condition / sql).
|
|
20
|
-
2. Read `get-cluster-definition-schema.md`, then call `
|
|
21
|
-
3. Read `list-events.md`, then call `
|
|
22
|
-
4. Read `list-properties.md`, then call `
|
|
20
|
+
2. Read `get-cluster-definition-schema.md`, then call `ae-cli analysis_audience +get_cluster_definition_schema --cluster_type <condition|sql>` to obtain the structure.
|
|
21
|
+
3. Read `list-events.md`, then call `ae-cli analysis_meta +list_events --project_id 1`.
|
|
22
|
+
4. Read `list-properties.md`, then call `ae-cli analysis_meta +list_properties --project_id 1`.
|
|
23
23
|
5. Build the new `definition` based on the schema + metadata, then run `+update_cluster`.
|
|
24
24
|
|
|
25
25
|
## Commands
|
|
26
26
|
```bash
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
27
|
+
ae-cli analysis_audience +update_cluster --project_id 1 --cluster_name demo --display_name "Demo v2"
|
|
28
|
+
ae-cli analysis_audience +update_cluster --project_id 1 --cluster_name demo --type condition --definition '{}' --zone_offset 8
|
|
29
|
+
ae-cli analysis_audience +update_cluster --dry-run
|
|
30
30
|
```
|
|
31
31
|
|
|
32
32
|
## Parameters
|
|
@@ -37,7 +37,7 @@ te-cli te_audience +update_cluster --dry-run
|
|
|
37
37
|
| `--display_name` | No | New cluster display name. Length: 1-80 |
|
|
38
38
|
| `--remark` | No | New cluster remark |
|
|
39
39
|
| `--type` | No | New cluster type. Supported values: condition and sql. It is recommended to provide this when updating the definition. |
|
|
40
|
-
| `--definition` | No | New cluster definition JSON. If provided, MUST call `+get_cluster_definition_schema` first, then fill valid event/property names from `
|
|
40
|
+
| `--definition` | No | New cluster definition JSON. If provided, MUST call `+get_cluster_definition_schema` first, then fill valid event/property names from `analysis_meta` metadata commands in the same `project_id`. |
|
|
41
41
|
| `--zone_offset` | No | Optional time zone offset for cluster computation. Valid range: -12 to 14 (supports decimals like 5.5). |
|
|
42
42
|
|
|
43
43
|
## Decision Rules
|
|
@@ -55,5 +55,5 @@ te-cli te_audience +update_cluster --dry-run
|
|
|
55
55
|
- If the result after writing is not as expected, immediately re-read the corresponding list/get interfaces and compare before and after.
|
|
56
56
|
|
|
57
57
|
## Recommended Chain
|
|
58
|
-
- +get_cluster_definition_schema ->
|
|
58
|
+
- +get_cluster_definition_schema -> analysis_meta +list_events -> analysis_meta +list_properties -> +update_cluster
|
|
59
59
|
- +list_clusters -> +get_clusters_by_name -> +update_cluster
|