### 3.4.8 日程創建指令 #### （1） 功能說明 通過語義指令，在硬件上實現日程的創建、更改、刪除操作，硬件端通過operation 解析具體操作指令，支持絕對時間和相對時間的識別，如：明天下午一點、360分鐘后等。 注：此功能只支持硬件端實現，無機器人答。通過語義指令，在硬件上實現日程的創建、更改、刪除操作，硬件端通過 operation 解析具體操作指令，支持絕對時間和相對時間的識別，如：明天下午一點、360分鐘后等。 **請求參數說明** | 參數名 | 參數類型 | 是否必須 | 參數說明 | | :--- | :--- | :---: | :--- | | q | String | 是 | 自然語言表達，例如“設置提醒我六點鐘起床”,"明天8點去公司開會"等 | | app\_key | String | 是 | 應用開發者秘鑰，注冊開發者后臺賬號，建立虛擬助理后獲得 | | user\_id | String | 是 | 用戶唯一標識，便于支持個性化語義解析。建議開發者使用 UUID 字符，且不同用戶必須用不同的 user\_id，防止意圖串。 | #### （2） 返回參數說明 **返回參數說明** | 名稱 | 類型 | 說明 | | :--- | :--- | :--- | | code | Integer | 返回代碼 | | msg | String | 返回代碼描述 | | parameters | JSON Object | 解析到的實體以及服務說明 | | name | String | 匹配的意圖名稱 | | outputs | Array | 服務輸出結果，微信端使用 type 類型為 wechat 開頭的內容;硬件端收到所有內容，依據需求解析使用 | **返回代碼說明** | 返回代碼 | 錯誤類型 | 說明 | | :--- | :--- | :--- | | 0／200 | 成功 | 請求成功 | | 400 | 無效請求 | 某些必需參數缺失或參數值錯誤，詳見msg字段 | | 401 | 未授權 | 授權失敗，app\_key 缺失或錯誤 | | 403 | 請求被禁止 | 有效請求，但服務拒絕響應，請聯系contact@ruyi.ai | | 408 | 請求超時 | 請求響應超時，一般響應時間設置為2000ms以內 | | 429 | 短時間內大量訪問 | 短時間內請求數過多 | | 500 | 內部錯誤 | 服務處理異常 | | 503 | 服務不可用 | 服務異常或正在維護 | #### （3） 請求示例 **請求范例** _明天中午十點和園園一塊喝咖啡提前一小時提醒我_ _提醒我今天晚上8點去華夏中路吃飯_ _10月15日下午兩點到三點半和小王在陸家嘴拜訪客戶 提醒我_ _過十分鐘提醒我去虹橋_ _提醒我明天六點鐘起床_ **請求示例** * http://api.ruyi.ai/ruyi-api/v1/message?app_key=APP_KEY&user_id=user0&q=提醒我明天六點鐘起床 返回結果 ```json { "code": 0, "msg": "ok", "result": { { "_text": "提醒我明天六點鐘起床", "msg_id": "a45183c6-093a-4c4e-b8d6-9fc69c703356",a45183c6-093a-4c4e-b8d6-9fc69c703356", "intents": [ { "parameters": { "operation": "set", "內容": "起床", "time": "1487282400000", "service": "calan"calendar" }, "action": "other", "name": "√設置_絕對時刻", "outputs": [], "score": "1.0", "scoreColor": "c4", "is_match": 1, "id": "6d51d0d9-ccbd-43bf-bb4f-10476cce67a5" } ], "meta_process_milliseconds": 88335 } } ``` **詳細參數說明** | 名稱 | 類型 | 說明 | | --- | --- | --- | | service | string | 服務名稱 | | operation | string | 操作 | | time | string | 時間（ms） | | timedelta | string | 時間戳 | | duration | string | 時間戳 | | repeat | string | 時間戳 | **operation操作說明** | operation | 說明 | | --- | --- | | set | 設置 | | update | 更改 | | delete | 刪除 | | flush | 清空 |