@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,122 +1,122 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: dataops-table
|
|
3
3
|
version: 1.0.0
|
|
4
|
-
description: "
|
|
4
|
+
description: "Data table and view management: search tables, view table details, create physical tables/views, batch create linked views. Trigger keywords: create table, table creation, view, data dictionary, table details, linked view, linkview, datatable, DDL."
|
|
5
5
|
metadata:
|
|
6
6
|
requires:
|
|
7
|
-
bins: ["
|
|
7
|
+
bins: ["ae-cli"]
|
|
8
8
|
---
|
|
9
9
|
|
|
10
|
-
# DataOps
|
|
10
|
+
# DataOps Data Table and View Management
|
|
11
11
|
|
|
12
|
-
>
|
|
12
|
+
> **Prerequisites:** Read [`te-dataops/SKILL.md`](../SKILL.md) for general rules.
|
|
13
13
|
|
|
14
|
-
|
|
14
|
+
Use the `dataops_datatable` subcommand to manage data tables.
|
|
15
15
|
|
|
16
|
-
|
|
17
|
-
-
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
-
|
|
16
|
+
**Core Rules:**
|
|
17
|
+
- Creating/modifying/deleting workspace task tables **must use dataops_datatable**, prohibited to use dataops_ide
|
|
18
|
+
- Confirm no table with the same name exists before creation
|
|
19
|
+
- When creating views or data tables, generate DDL according to **Trino DDL specifications**
|
|
20
|
+
- Create task tables in DEV environment first, then PROD environment (can create simultaneously)
|
|
21
21
|
|
|
22
22
|
---
|
|
23
23
|
|
|
24
|
-
##
|
|
24
|
+
## Workflow A: Search and View Table Information
|
|
25
25
|
|
|
26
26
|
```bash
|
|
27
|
-
#
|
|
28
|
-
|
|
27
|
+
# Search tables in data dictionary (fuzzy match by table name/description)
|
|
28
|
+
ae-cli dataops_datatable +dict_search_tables --spaceCode "${spaceCode}" --search "user" --maxResults 20
|
|
29
29
|
|
|
30
|
-
#
|
|
31
|
-
|
|
30
|
+
# Get detailed table information (fields, DDL, data lineage)
|
|
31
|
+
ae-cli dataops_datatable +get_table_detail --spaceCode "${spaceCode}" --tableName "dwd_user_info"
|
|
32
32
|
|
|
33
|
-
#
|
|
34
|
-
|
|
33
|
+
# Paginated query of registered tables in workspace
|
|
34
|
+
ae-cli dataops_datatable +list_tables_by_page --spaceCode "${spaceCode}" --search "user" --pageNum 1 --pageSize 20
|
|
35
35
|
|
|
36
|
-
#
|
|
37
|
-
|
|
36
|
+
# Get table hierarchy by repository dimension (repo→catalog→schema→tables)
|
|
37
|
+
ae-cli dataops_datatable +struct_by_repo --spaceCode "${spaceCode}"
|
|
38
38
|
|
|
39
|
-
#
|
|
40
|
-
|
|
39
|
+
# Search system tables (event tables, user tables, dimension tables)
|
|
40
|
+
ae-cli dataops_datatable +list_system_tables --spaceCode "${spaceCode}" --projectName "my_project"
|
|
41
41
|
```
|
|
42
42
|
|
|
43
43
|
---
|
|
44
44
|
|
|
45
|
-
##
|
|
45
|
+
## Workflow B: Create Physical Table
|
|
46
46
|
|
|
47
47
|
```bash
|
|
48
|
-
# Step 1:
|
|
49
|
-
|
|
48
|
+
# Step 1: Confirm no table with same name exists
|
|
49
|
+
ae-cli dataops_datatable +dict_search_tables --spaceCode "${spaceCode}" --search "dwd_user_info"
|
|
50
50
|
|
|
51
|
-
# Step 2:
|
|
52
|
-
|
|
51
|
+
# Step 2: Create physical table in DEV environment (DDL must follow Trino specifications)
|
|
52
|
+
ae-cli dataops_datatable +create_table --spaceCode "${spaceCode}" \
|
|
53
53
|
--ddl "CREATE TABLE dwd_user_info (user_id VARCHAR, user_name VARCHAR, age INTEGER) WITH (format = 'ORC')" \
|
|
54
54
|
--repoCode "te_etl" --catalog "hive" --schema "ws_default_dev" --confirmed true
|
|
55
55
|
|
|
56
|
-
# Step 3:
|
|
57
|
-
|
|
56
|
+
# Step 3: Create physical table in PROD environment (same DDL, change schema to product database)
|
|
57
|
+
ae-cli dataops_datatable +create_table --spaceCode "${spaceCode}" \
|
|
58
58
|
--ddl "CREATE TABLE dwd_user_info (user_id VARCHAR, user_name VARCHAR, age INTEGER) WITH (format = 'ORC')" \
|
|
59
59
|
--repoCode "te_etl" --catalog "hive" --schema "ws_default_product" --confirmed true
|
|
60
60
|
```
|
|
61
61
|
|
|
62
62
|
---
|
|
63
63
|
|
|
64
|
-
##
|
|
64
|
+
## Workflow C: Create View
|
|
65
65
|
|
|
66
66
|
```bash
|
|
67
|
-
# Step 1:
|
|
68
|
-
|
|
67
|
+
# Step 1: Confirm no view with same name exists
|
|
68
|
+
ae-cli dataops_datatable +dict_search_tables --spaceCode "${spaceCode}" --search "v_user_info"
|
|
69
69
|
|
|
70
|
-
# Step 2:
|
|
71
|
-
|
|
70
|
+
# Step 2: Create view (defaults to v_${source_table_name} if view name not specified)
|
|
71
|
+
ae-cli dataops_datatable +create_view --spaceCode "${spaceCode}" \
|
|
72
72
|
--ddl "CREATE VIEW v_user_info AS SELECT user_id, user_name FROM hive.ws_default_dev.dwd_user_info" \
|
|
73
73
|
--repoCode "te_etl" --catalog "hive" --schema "ws_default_dev" --confirmed true
|
|
74
74
|
```
|
|
75
75
|
|
|
76
76
|
---
|
|
77
77
|
|
|
78
|
-
##
|
|
78
|
+
## Workflow D: Batch Create Linked Views
|
|
79
79
|
|
|
80
80
|
```bash
|
|
81
|
-
# Step 1:
|
|
82
|
-
|
|
81
|
+
# Step 1: List source tables available for creating linked views
|
|
82
|
+
ae-cli dataops_datatable +linkview_list_source_tables --spaceCode "${spaceCode}" \
|
|
83
83
|
--srcRepoCode "te_etl" --srcCatalog "hive" --srcSchema "ws_default_hidden"
|
|
84
84
|
|
|
85
|
-
# Step 2:
|
|
86
|
-
|
|
85
|
+
# Step 2: Batch create linked views (async execution)
|
|
86
|
+
ae-cli dataops_datatable +batch_create --spaceCode "${spaceCode}" \
|
|
87
87
|
--srcRepoCode "te_etl" --srcCatalog "hive" --srcSchema "ws_default_hidden" \
|
|
88
88
|
--processType 2 --batchCreationMode 1 --owner "${ownerOpenId}" \
|
|
89
89
|
--viewInfos '[{"viewName":"v_orders","srcTableName":"ta_event_123","srcTableType":"TABLE"}]' \
|
|
90
90
|
--confirmed true
|
|
91
91
|
|
|
92
|
-
# Step 3:
|
|
92
|
+
# Step 3: Poll batch creation status (recommend 3-5 second interval)
|
|
93
93
|
# status: WAIT / RUNNING / SUCCESS / STOP
|
|
94
|
-
|
|
94
|
+
ae-cli dataops_datatable +linkview_get_batch_status --spaceCode "${spaceCode}" --batchId "${batchId}"
|
|
95
95
|
|
|
96
|
-
#
|
|
97
|
-
|
|
96
|
+
# View historical batch creation records
|
|
97
|
+
ae-cli dataops_datatable +list_batches --spaceCode "${spaceCode}"
|
|
98
98
|
```
|
|
99
99
|
|
|
100
100
|
---
|
|
101
101
|
|
|
102
|
-
##
|
|
103
|
-
|
|
104
|
-
|
|
|
105
|
-
|
|
106
|
-
| `+dict_search_tables` |
|
|
107
|
-
| `+get_table_detail` |
|
|
108
|
-
| `+list_tables_by_page` |
|
|
109
|
-
| `+struct_by_repo` |
|
|
110
|
-
| `+list_system_tables` |
|
|
111
|
-
| `+create_table` |
|
|
112
|
-
| `+create_view` |
|
|
113
|
-
| `+batch_create` |
|
|
114
|
-
| `+linkview_get_batch_status` |
|
|
115
|
-
| `+list_batches` |
|
|
116
|
-
|
|
117
|
-
##
|
|
118
|
-
|
|
119
|
-
- **schema
|
|
120
|
-
- **processType**: `1
|
|
121
|
-
- **batchCreationMode**: `1
|
|
122
|
-
-
|
|
102
|
+
## Command Quick Reference
|
|
103
|
+
|
|
104
|
+
| Command | Purpose | Key Flags |
|
|
105
|
+
|---------|---------|-----------|
|
|
106
|
+
| `+dict_search_tables` | Data dictionary search | `--spaceCode` `--search` `--maxResults` |
|
|
107
|
+
| `+get_table_detail` | Table details | `--spaceCode` `--tableName` |
|
|
108
|
+
| `+list_tables_by_page` | Paginated list | `--spaceCode` `--search` `--pageNum` `--pageSize` |
|
|
109
|
+
| `+struct_by_repo` | By repository hierarchy | `--spaceCode` `--search` |
|
|
110
|
+
| `+list_system_tables` | System table list | `--spaceCode` `--projectId`/`--projectName` `--pageNum` `--pageSize` |
|
|
111
|
+
| `+create_table` | Create physical table | `--spaceCode` `--ddl` `--repoCode` `--catalog` `--schema` `--confirmed` |
|
|
112
|
+
| `+create_view` | Create view | `--spaceCode` `--ddl` `--repoCode` `--catalog` `--schema` `--confirmed` |
|
|
113
|
+
| `+batch_create` | Batch create views | `--spaceCode` `--srcRepoCode` `--srcCatalog` `--srcSchema` `--processType` `--batchCreationMode` `--owner` `--viewInfos` `--confirmed` |
|
|
114
|
+
| `+linkview_get_batch_status` | Batch creation status | `--spaceCode` `--batchId` |
|
|
115
|
+
| `+list_batches` | Historical batch records | `--spaceCode` `--status` |
|
|
116
|
+
|
|
117
|
+
## Parameter Notes
|
|
118
|
+
|
|
119
|
+
- **schema naming**: DEV environment uses `ws_${spaceCode}_dev`, PROD environment uses `ws_${spaceCode}_product`
|
|
120
|
+
- **processType**: `1`=DEV only | `2`=DEV+PROD
|
|
121
|
+
- **batchCreationMode**: `1`=full sync | `2`=retry failures
|
|
122
|
+
- **Table name rule**: `^[a-z][0-9a-z_]{0,127}$`
|
|
@@ -1,211 +1,211 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: te-engage
|
|
3
3
|
version: 1.0.0
|
|
4
|
-
description: "TE Engage MCP
|
|
4
|
+
description: "TE Engage MCP: config items, flows, channel settings, task data query, and management"
|
|
5
5
|
metadata:
|
|
6
6
|
requires:
|
|
7
|
-
bins: ["
|
|
8
|
-
cliHelp: "
|
|
7
|
+
bins: ["ae-cli"]
|
|
8
|
+
cliHelp: "ae-cli engage --help"
|
|
9
9
|
---
|
|
10
10
|
|
|
11
11
|
# te-engage
|
|
12
12
|
|
|
13
|
-
>
|
|
13
|
+
> **Prerequisite:** Read [`../te-shared/SKILL.md`](../te-shared/SKILL.md) for authentication, global parameters, and safety constraints.
|
|
14
14
|
|
|
15
|
-
##
|
|
15
|
+
## Overview
|
|
16
16
|
|
|
17
|
-
`te-engage`
|
|
17
|
+
The `te-engage` package provides Hermes Engage MCP capabilities across config items, flows, channel settings, and task data. Commands are invoked through `ae-cli engage <command>`.
|
|
18
18
|
|
|
19
|
-
|
|
19
|
+
Typical use cases include:
|
|
20
20
|
|
|
21
|
-
-
|
|
22
|
-
-
|
|
23
|
-
-
|
|
24
|
-
-
|
|
21
|
+
- Querying and managing channels, config channels, approvers, and whitelists
|
|
22
|
+
- Querying task lists, task details, experiment reports, and metric reports
|
|
23
|
+
- Querying config items and strategies, copying templates, and managing strategy status
|
|
24
|
+
- Querying flow lists, node schemas, and flow reports, and saving or managing flows
|
|
25
25
|
|
|
26
|
-
##
|
|
26
|
+
## Parameter Conventions
|
|
27
27
|
|
|
28
|
-
-
|
|
29
|
-
-
|
|
30
|
-
-
|
|
31
|
-
-
|
|
28
|
+
- Use regular flags for simple parameters, for example `--project_id`, `--task_id`, and `--flow_uuid`
|
|
29
|
+
- Use JSON flags for array parameters, for example `--strategy_id_list '["id1","id2"]'`
|
|
30
|
+
- Use named JSON flags for object parameters, for example `--req '{...}'` and `--flow_list '[...]'`
|
|
31
|
+
- Optional global parameters work the same way as in other domains, for example `--host`, `--mcp-url`, and `--dry-run`
|
|
32
32
|
|
|
33
|
-
## JSON
|
|
33
|
+
## JSON Parameter Format
|
|
34
34
|
|
|
35
|
-
|
|
35
|
+
Common JSON flag examples:
|
|
36
36
|
|
|
37
37
|
```bash
|
|
38
|
-
--
|
|
39
|
-
--
|
|
40
|
-
--
|
|
38
|
+
--provider_list '["webhook","fcm"]'
|
|
39
|
+
--strategy_id_list '["strategy_a","strategy_b"]'
|
|
40
|
+
--flow_id_list '["flow_1","flow_2"]'
|
|
41
41
|
--req '{"pageNum":1,"pageSize":20}'
|
|
42
42
|
```
|
|
43
43
|
|
|
44
|
-
##
|
|
44
|
+
## Common Scenarios
|
|
45
45
|
|
|
46
46
|
### 1. setting
|
|
47
47
|
|
|
48
48
|
```bash
|
|
49
|
-
#
|
|
50
|
-
|
|
49
|
+
# Query the channel list
|
|
50
|
+
ae-cli engage +channel_list --project_id 1
|
|
51
51
|
|
|
52
|
-
#
|
|
53
|
-
|
|
52
|
+
# Filter by provider
|
|
53
|
+
ae-cli engage +channel_list --project_id 1 --provider_list '["webhook","fcm"]'
|
|
54
54
|
|
|
55
|
-
#
|
|
56
|
-
|
|
55
|
+
# Query config channels
|
|
56
|
+
ae-cli engage +config_channel_list --project_id 1
|
|
57
57
|
```
|
|
58
58
|
|
|
59
59
|
### 2. task
|
|
60
60
|
|
|
61
61
|
```bash
|
|
62
|
-
#
|
|
63
|
-
|
|
62
|
+
# Query the task list
|
|
63
|
+
ae-cli engage +task_list --project_id 1 --req '{"pageNum":1,"pageSize":20}'
|
|
64
64
|
|
|
65
|
-
#
|
|
66
|
-
|
|
65
|
+
# Query task details
|
|
66
|
+
ae-cli engage +task_detail --project_id 1 --task_id task_123
|
|
67
67
|
|
|
68
|
-
#
|
|
69
|
-
|
|
68
|
+
# Query the task overview
|
|
69
|
+
ae-cli engage +task_data_overview --project_id 1 --task_id task_123 --task_type normal
|
|
70
70
|
```
|
|
71
71
|
|
|
72
72
|
### 3. config
|
|
73
73
|
|
|
74
74
|
```bash
|
|
75
|
-
#
|
|
76
|
-
|
|
75
|
+
# Query the config item list
|
|
76
|
+
ae-cli engage +config_item_list --project_id 1
|
|
77
77
|
|
|
78
|
-
#
|
|
79
|
-
|
|
78
|
+
# Query the strategy list
|
|
79
|
+
ae-cli engage +strategy_list --project_id 1 --config_id cfg_123
|
|
80
80
|
|
|
81
|
-
#
|
|
82
|
-
|
|
83
|
-
--
|
|
84
|
-
--
|
|
81
|
+
# Query a config item report
|
|
82
|
+
ae-cli engage +config_item_trigger_report \
|
|
83
|
+
--project_id 1 --config_id cfg_123 \
|
|
84
|
+
--start_time 2026-04-01 --end_time 2026-04-07
|
|
85
85
|
```
|
|
86
86
|
|
|
87
87
|
### 4. flow
|
|
88
88
|
|
|
89
89
|
```bash
|
|
90
|
-
#
|
|
91
|
-
|
|
90
|
+
# Query the flow list
|
|
91
|
+
ae-cli engage +flow_list --project_id 1
|
|
92
92
|
|
|
93
|
-
#
|
|
94
|
-
|
|
93
|
+
# Query flow details
|
|
94
|
+
ae-cli engage +flow_detail --project_id 1 --flow_uuid flow_uuid_123
|
|
95
95
|
|
|
96
|
-
#
|
|
97
|
-
|
|
96
|
+
# Query the node schema
|
|
97
|
+
ae-cli engage +flow_node_config_schema --node_type message_push
|
|
98
98
|
```
|
|
99
99
|
|
|
100
|
-
## `+
|
|
100
|
+
## `+save_flow` Critical Constraints
|
|
101
101
|
|
|
102
|
-
|
|
102
|
+
When the user wants to "create a flow / generate a flow canvas / save a flow", do not treat `+save_flow` as a normal single command. You must follow the workflow below.
|
|
103
103
|
|
|
104
|
-
###
|
|
104
|
+
### Required Workflow
|
|
105
105
|
|
|
106
|
-
1.
|
|
107
|
-
-
|
|
108
|
-
-
|
|
109
|
-
-
|
|
110
|
-
-
|
|
111
|
-
2.
|
|
112
|
-
3.
|
|
106
|
+
1. First confirm that the user intent is specific enough. At minimum you need:
|
|
107
|
+
- The business scenario
|
|
108
|
+
- The target users
|
|
109
|
+
- The touchpoint or delivery method
|
|
110
|
+
- Whether branching is needed, and the branching conditions
|
|
111
|
+
2. Do not jump directly from natural language to `--req`. You must first organize a stable intermediate intent structure, then map it to the final `req`.
|
|
112
|
+
3. Before building any condition-related nodes, you must call:
|
|
113
113
|
|
|
114
114
|
```bash
|
|
115
|
-
|
|
115
|
+
ae-cli analysis_audience +get_cluster_definition_schema --cluster_type condition
|
|
116
116
|
```
|
|
117
117
|
|
|
118
|
-
4.
|
|
118
|
+
4. Before building touchpoint nodes such as `message_push`, `wechat_push`, or `webhook_push`, you must call:
|
|
119
119
|
|
|
120
120
|
```bash
|
|
121
|
-
|
|
121
|
+
ae-cli engage +channel_list --project_id <projectId>
|
|
122
122
|
```
|
|
123
123
|
|
|
124
|
-
5.
|
|
124
|
+
5. The final `--req` for `+save_flow` must be the complete canvas request payload, not an intent description. It must contain at least:
|
|
125
125
|
- `flowName`
|
|
126
126
|
- `flowDesc`
|
|
127
127
|
- `nodeList`
|
|
128
128
|
- `edgeList`
|
|
129
|
-
6. `nodeList[].config`
|
|
130
|
-
7. `targetClusterQp`
|
|
131
|
-
8.
|
|
132
|
-
-
|
|
133
|
-
-
|
|
134
|
-
- `edge.source`
|
|
135
|
-
-
|
|
136
|
-
-
|
|
129
|
+
6. `nodeList[].config` and `edgeList[].config` must be JSON strings, not JSON objects.
|
|
130
|
+
7. If `targetClusterQp` appears inside a node `config`, its value should usually also be a string produced by `JSON.stringify`, not a raw object.
|
|
131
|
+
8. You must self-check before submitting:
|
|
132
|
+
- There is exactly one entry node
|
|
133
|
+
- There is at least one `exit_flow`
|
|
134
|
+
- `edge.source` and `edge.target` both reference valid nodes
|
|
135
|
+
- Any branch node `sourceBranchId` has already been declared in the upstream node `config`
|
|
136
|
+
- The whole graph is a DAG and contains no cycles
|
|
137
137
|
|
|
138
|
-
###
|
|
138
|
+
### Explicitly Forbidden
|
|
139
139
|
|
|
140
|
-
-
|
|
141
|
-
-
|
|
142
|
-
-
|
|
143
|
-
-
|
|
140
|
+
- Do not invent a `channelId`
|
|
141
|
+
- Do not fill in branching logic when the user has not provided enough information
|
|
142
|
+
- Do not submit business-semantic nodes directly as final `nodeList` nodes
|
|
143
|
+
- Do not put `config` into `--req` as an object
|
|
144
144
|
|
|
145
|
-
###
|
|
145
|
+
### Recommended Order
|
|
146
146
|
|
|
147
147
|
```text
|
|
148
|
-
|
|
149
|
-
->
|
|
150
|
-
->
|
|
151
|
-
-> +
|
|
152
|
-
->
|
|
153
|
-
->
|
|
154
|
-
-> +
|
|
148
|
+
User request
|
|
149
|
+
-> Organize intent
|
|
150
|
+
-> analysis_audience +get_cluster_definition_schema --cluster_type condition
|
|
151
|
+
-> +channel_list --project_id <projectId>
|
|
152
|
+
-> Build nodeList / edgeList
|
|
153
|
+
-> Self-check
|
|
154
|
+
-> +save_flow
|
|
155
155
|
```
|
|
156
156
|
|
|
157
|
-
|
|
157
|
+
For more detailed generation rules, consult these references first:
|
|
158
158
|
|
|
159
159
|
- `references/save-flow.md`
|
|
160
160
|
- `references/flow-node-config-schema.md`
|
|
161
161
|
- `references/validate-flow-node-config.md`
|
|
162
162
|
|
|
163
|
-
##
|
|
163
|
+
## Dry-Run Debugging
|
|
164
164
|
|
|
165
165
|
```bash
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
|
|
166
|
+
ae-cli --dry-run engage +channel_list --project_id 1
|
|
167
|
+
ae-cli --dry-run engage +task_list --project_id 1 --req '{"pageNum":1,"pageSize":20}'
|
|
168
|
+
ae-cli --dry-run engage +flow_list --project_id 1
|
|
169
169
|
```
|
|
170
170
|
|
|
171
171
|
## References
|
|
172
172
|
|
|
173
|
-
|
|
173
|
+
More detailed single-command guidance is available in the business-oriented `references/` directory:
|
|
174
174
|
|
|
175
175
|
- `references/channel-list.md`
|
|
176
176
|
- `references/task-list.md`
|
|
177
177
|
- `references/config-item-list.md`
|
|
178
178
|
- `references/flow-list.md`
|
|
179
179
|
|
|
180
|
-
|
|
180
|
+
This split documentation structure is easier to extend later, because commands with more complex object inputs can stay centralized in the `references/` root directory.
|
|
181
181
|
|
|
182
|
-
##
|
|
182
|
+
## Command Groups
|
|
183
183
|
|
|
184
184
|
### setting
|
|
185
185
|
|
|
186
|
-
`+
|
|
186
|
+
`+channel_list`, `+channel_detail`, `+update_channel_status`, `+delete_channel`, `+add_channel`, `+whitelist_list`, `+add_approver`, `+approver_list`, `+cancel_query_by_request_id`, `+config_channel_detail`, `+config_channel_list`, `+delete_config_channel`, `+update_config_channel_status`
|
|
187
187
|
|
|
188
188
|
### task
|
|
189
189
|
|
|
190
|
-
`+
|
|
190
|
+
`+task_data_overview`, `+task_data_detail`, `+task_metric_detail`, `+task_experiment_report`, `+task_detail`, `+task_list`, `+task_stats`, `+manage_task`
|
|
191
191
|
|
|
192
192
|
### config
|
|
193
193
|
|
|
194
|
-
`+
|
|
194
|
+
`+config_item_trigger_report`, `+config_item_analysis_report`, `+config_item_strategy_comparison`, `+config_item_list`, `+config_item_detail`, `+delete_config_item`, `+copy_config_template`, `+strategy_list`, `+strategy_detail`, `+manage_strategy`
|
|
195
195
|
|
|
196
196
|
### flow
|
|
197
197
|
|
|
198
|
-
`+
|
|
198
|
+
`+save_flow`, `+flow_node_config_schema`, `+flow_detail`, `+flow_list`, `+flow_node_overview_report`, `+manage_flow`, `+flow_ab_split_node_report`, `+flow_process_report`, `+validate_flow_node_config`, `+flow_node_detail_report`, `+delete_flow`, `+modify_flow_base_info`
|
|
199
199
|
|
|
200
|
-
##
|
|
200
|
+
## Date Format
|
|
201
201
|
|
|
202
|
-
|
|
202
|
+
Commands that accept date parameters usually use `yyyy-MM-dd`, for example `--start_time 2026-04-01`.
|
|
203
203
|
|
|
204
|
-
##
|
|
204
|
+
## Write Operation Reminder
|
|
205
205
|
|
|
206
|
-
|
|
206
|
+
The following commands are write operations. Confirm that the user intent is explicit before executing them:
|
|
207
207
|
|
|
208
|
-
-
|
|
209
|
-
-
|
|
210
|
-
-
|
|
211
|
-
-
|
|
208
|
+
- Channels and config channels: `+add_channel`, `+delete_channel`, `+update_channel_status`, `+delete_config_channel`, `+update_config_channel_status`
|
|
209
|
+
- Strategies and config items: `+delete_config_item`, `+copy_config_template`, `+manage_strategy`
|
|
210
|
+
- Flows: `+save_flow`, `+modify_flow_base_info`, `+manage_flow`, `+delete_flow`
|
|
211
|
+
- Tasks: `+manage_task`
|
|
@@ -1,24 +1,24 @@
|
|
|
1
|
-
# te-engage +
|
|
1
|
+
# te-engage +add_approver
|
|
2
2
|
|
|
3
|
-
>
|
|
3
|
+
> **Prerequisite:** Read [`../../te-shared/SKILL.md`](../../te-shared/SKILL.md)
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Batch add approvers.
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
Mapped command: `ae-cli engage +add_approver`
|
|
8
8
|
|
|
9
9
|
## Flags
|
|
10
10
|
|
|
11
|
-
| Flag |
|
|
11
|
+
| Flag | Type | Required | Description |
|
|
12
12
|
|------|------|------|------|
|
|
13
|
-
| `--
|
|
14
|
-
| `--approvers` | json |
|
|
13
|
+
| `--project_id` / `-p` | number | Yes | Project ID |
|
|
14
|
+
| `--approvers` | json | Yes | approver open ID JSON array |
|
|
15
15
|
|
|
16
|
-
##
|
|
16
|
+
## Safety Constraints
|
|
17
17
|
|
|
18
|
-
|
|
18
|
+
This command is a **write operation** and and modifies the project approver configuration.
|
|
19
19
|
|
|
20
|
-
##
|
|
20
|
+
## Examples
|
|
21
21
|
|
|
22
22
|
```bash
|
|
23
|
-
|
|
23
|
+
ae-cli engage +add_approver --project_id 1 --approvers '["ou_xxx","ou_yyy"]'
|
|
24
24
|
```
|