Via dws commands to manage DingTalk product capabilities.
Strictly Prohibited (NEVER DO)
- Do not use methods other than dws commands to operate (curl, HTTP API, and browsers are prohibited)
- Do not fabricate identifiers such as UUIDs or IDs; they must be extracted from command returns
- Do not guess field names/parameter values; query and confirm before operating
Strict Requirements (MUST DO)
- All commands must include
--format jsonto obtain parseable output - Before deletion operations, you must add
--yesand confirm with the user - A single batch operation must not exceed 100 records
- All commands muststrictly followthe parameter formats specified in the corresponding product reference documentation (for example: if there is a parameter value, there must be at least one space between the parameter and the parameter value)
Product Overview
| Product | Purpose | Reference File |
|---|---|---|
aitable |
AI Tables: create, read, update, and delete tables/data tables/fields/records; template search | aitable.md |
calendar |
Calendar: schedules/participants/meeting rooms/free-busy query | calendar.md |
contact |
Contacts: user query (current user/search/details)/department query (search/sub-departments/member list) | contact.md |
doc |
Documents: search/browse/read/create/update documents/folder management/block-level editing | doc.md |
chat |
Group Chat: group management (create group/search/add or remove members/change group name)/messages (retrieve/send/bot group send/Webhook)/bot search | chat.md |
todo |
To-dos: create (including priority/due time)/query/modify/mark complete/delete | todo.md |
mail |
Email: query mailbox/search/view/send email | mail.md |
minutes |
AI Minutes: list/summary/transcription/keywords/title modification | minutes.md |
report |
Logs: inbox/sent/template view/details/read statistics | report.md |
drive |
DingTalk Drive: browse files/metadata/download/create folder/upload file | drive.md |
ding |
DING messages: send/recall (in-app/SMS/phone) | ding.md |
devdoc |
Open Platform Documentation: search development documents | simple.md |
conference |
Video Conferencing: schedule meetings | simple.md |
aiapp |
AI Apps: create/query/modify AI apps | aiapp.md |
live |
Livestreaming: view livestream list | simple.md |
oa |
OA Approvals: pending/details/approve/reject/cancel/records/initiated/tasks | oa.md |
attendance |
Attendance: clock-in records/shift query | attendance.md |
Intent Judgment Decision Tree
User mentions "table/multi-dimensional table/AI table/record/data" → aitable
User mentions "schedule/calendar/meeting room/date" → calendar
User mentions "contacts/colleague/department/organizational structure" → contact
User mentions "document/knowledge base/write document" → doc
User mentions "to-do/TODO/task reminder" → todo
User mentions "mail/email" → mail
User mentions "AI Minutes/meeting recording/transcription/AI summary, as well as a user-provided AI Minutes URL (such as https://shanji.dingtalk.com/*)" → minutes
User mentions "help me make/build/generate/generate system/AI app/create app/intelligent app" → aiapp
User mentions "DING/urgent message/phone reminder" → ding
User mentions "attendance/clock-in/shift scheduling" → attendance
User mentions "group chat/group message/group member/chat history/create group/bot sends message/Webhook/notification" → chat
User mentions "approval/OA" → oa
User mentions "development/API/call error documentation" → devdoc
User mentions "campus recruitment/post job/my candidates" → ai_sincere_hire
User mentions "video conference/schedule meeting" → conference
User mentions "live streaming" → live
User mentions "log/daily report/weekly report/log statistics" → report
User mentions "DingTalk Drive/file/cloud drive/download file/upload file" → drive
User mentions "enterprise credit/business information/shareholder/court judgment/risk/trademark/patent/bidding/contact information/KP" → credit
User mentions "legal consultation/laws and regulations/case/legal provision/precedent/legal basis" → law
Key distinction: aitable (data table) vs doc (document editing) Key distinction: report (DingTalk log/daily and weekly reports) vs doc (document editing) vs todo (to-do task) Key distinction: drive (DingTalk Drive file storage/upload/download) vs doc (DingTalk document content reading and writing/knowledge base space) Key distinction: conference (video conference scheduling) vs calendar event (calendar schedule management) Key distinction: chat message send (mass send as individual) vs send-by-bot (bot sends message) vs send-by-webhook (Webhook alert)
For more confusing scenarios and user expression examples, see intent-guide.md
Core process
As an intelligent assistant, your primary task is tounderstand the user's true and complete intent, rather than simply executing commands. Before choosing the dws product command, you must strictly follow the following three-step process:
- Intent classification: First, determine which category the core verb/action of the user's instruction belongs to. This is more important than focusing on nouns.
- Ambiguity handling and information follow-up: If the user's instruction is vague or contains keywords from multiple products, guessing is strictly prohibited. You must proactively ask the user follow-up questions to clarify the intent. This is your core value as an intelligent assistant rather than a command executor.
- Precise product mapping: After completing the first two steps and the intent is clear, refer to the product overview and intent determination decision tree to choose the product.
- Fully read the product reference files, and implement the user's intent by writing code or directly calling commands.
Error handling
- If an error occurs, add
--verboseand retry once - If it still fails, report the error information to the user
- Do not attempt alternative solutions on your own
- If identity verification fails, you can use dws auth login to log in
Detailed reference (read as needed)
- references/products/ — Detailed reference for each product's commands
- references/intent-guide.md — Intent routing guide (comparison of easily confused scenarios)
- references/global-reference.md — Global flags, authentication, output format
- references/field-rules.md — AI table field type rules
- references/error-codes.md — Error codes + debugging process
- scripts/ — AI table batch operation script