AI 機器人

應用詳情的“AI 機器人”用於建立和管理機器人、檢視回復統計，以及把機器人新增給使用者。機器人怎樣工作、怎樣接入你的模型，見 AI 對話。

平臺不呼叫模型，也不儲存模型金鑰：使用者給機器人發訊息後，平臺回呼你的服務，你的服務呼叫模型並用服務端 SDK 把回覆流式寫回。頁面頂部的“接入方式”和“規則”卡片概括了這些要點。

許可權

操作	developer	admin / owner
檢視機器人列表、詳情、統計和最近的回覆	可用	可用
建立、修改、啟用 / 停用、刪除機器人，新增給使用者	不可用	可用

新增給使用者會以機器人的身份建立好友關係，需要再次驗證身份。

建立機器人

點“建立機器人”，填寫：

專案	說明
使用者名稱	機器人的 IM 使用者名稱，不能與已有使用者重複，建立後不能修改
暱稱	使用者看到的名字，如“智慧客服”；以後在“IM 使用者”頁修改
回呼地址	使用者給機器人發訊息時回呼的地址；不指定時使用訂閱了 ai.message_received 的地址。地址在回呼配置中管理
備註	只在控制檯顯示
高階設定	附帶的上下文（0～50 條，預設 10）、無內容超時（10～300 秒，預設 60）、同時生成的回覆上限（預設 1000）

機器人建立後就是應用中的一個 IM 使用者：可以被加好友、被拉黑，不能登入，不能入群，只在單聊中回覆。加好友方式為“直接透過”。每個應用最多 100 個機器人。

機器人列表

列表顯示每個機器人的狀態、回呼地址、今日回覆數和正在生成的回覆數，可以按暱稱或使用者名稱搜尋。頂部彙總機器人數（啟用和停用各多少）。

• 停用：使用者仍能給它發訊息，但平臺不再回呼你的服務，也不能開始新的回覆；停用前正在生成的回覆不受影響。可以隨時啟用。
• 刪除：機器人的 IM 使用者一併刪除，正在生成的回覆以“生成中斷”結束，已有的訊息保留。刪除後不能恢復。

機器人詳情

點機器人進入詳情，有三個標籤：

• 統計：近 7 天或近 30 天每天收到的訊息和回覆數，按已完成、已停止、生成中斷分開，以及平均首字延遲、平均生成時長、生成中斷率；可以切換圖表和表格。按 UTC 日期統計，只用於展示，不參與計費。
• 最近的回覆：最近 100 條回覆的使用者、開始時間、狀態、首字延遲、時長、結束原因和模型，可以按狀態篩選；記錄保留 30 天，內容以訊息為準。
• 配置：修改回呼地址、備註和高階設定；暱稱和頭像在“IM 使用者”頁修改。

新增給使用者

使用者要先和機器人成為好友、或者主動給它發訊息，機器人才會出現在會話列表中。在詳情頁點“新增給使用者”，每行填一個使用者名稱，一次最多 1000 個：

• 直接成為雙方好友，不需要使用者同意；
• 可以勾選“同時發一條歡迎語”，以機器人的身份傳送，機器人會出現在使用者的會話列表中；
• 結果顯示新增成功和失敗的數量。

要移除好友或拉黑，到“IM 使用者”頁操作。也可以在你的服務端用新增好友的介面批次新增。