事前準備
- 一個已在我們這裡設定好、並使用付費方案(基礎、普通、精英或企業)的網站。如果還沒有,請用電子郵件註冊並輸入您的網站網址。
- 一把 API 金鑰:在後台開啟 聊天軟體與 API,替金鑰取個名字(例如「AstrBot」),然後按 建立 API 金鑰。請立刻複製:它只會顯示這一次。
- 已執行並連接到聊天軟體的 AstrBot(或其他工具)。如何安裝 AstrBot 以及連接 Discord、Telegram、Slack、WeChat 或 QQ,請參考 AstrBot 自己的說明文件。
每個工具都會要求填寫這三個值:
API Base URL: https://7x24hrs.com/v1
API Key: sk-7x24-…
Model: 7x24hrs-assistant在 AstrBot 中設定
- 開啟 AstrBot 管理面板,進入 模型提供商(Providers)。在 對話(Chat Completion)標籤下,按 Provider Sources 旁的 + 新增(Add)。
- 在 New model provider 中選擇 OpenAI Compatible。
- 填一個您認得出的 ID,例如
7x24hrs。把金鑰貼到 API Key,並把 API Base URL 設為https://7x24hrs.com/v1。 - 按 Save And Fetch Models。在 Available Models 下,按
7x24hrs-assistant旁邊的 +。在彈出的視窗裡,Model capabilities 下只保留勾選 Text(取消勾選 Image、Audio 和 Tool use:助手只回答文字),然後按 Save。 - 讓機器人使用這個模型:在 配置文件(Config)中把它設為預設對話模型(也可以在 聊天(Chat)中用模型切換,只在某段對話使用它)。
- 在 AstrBot 的 聊天(Chat)頁面或已連接的聊天軟體中問個問題。回答來自您網站的資料。
AstrBot 本身的人格和系統提示詞請留空,或盡量寫短:您的助理遵循您在 7x24hrs 後台設定的規則與角色,不會聽從聊天軟體系統提示詞裡的指示。
Dify、LobeChat 及其他工具
任何具備「OpenAI 相容」或「自訂 OpenAI」供應商的工具,設定方式都一樣:Base URL 填 https://7x24hrs.com/v1,再填入您的 API 金鑰和模型 7x24hrs-assistant。
- Dify:在 設定 → 模型供應商中新增 OpenAI-API-compatible,填入模型名稱、您的金鑰,並把 Base URL 填為 API 端點,然後在應用中使用這個模型。
- LobeChat:在設定的語言模型區塊開啟 OpenAI 供應商,填入金鑰,把 API 代理位址設為 Base URL,再把
7x24hrs-assistant加進模型清單。 - 您自己的程式:用任何 OpenAI 用戶端函式庫呼叫 API,設定好 Base URL 和金鑰即可。
在終端機裡試試 API:
curl https://7x24hrs.com/v1/chat/completions \
-H "Authorization: Bearer sk-7x24-…" \
-H "Content-Type: application/json" \
-d '{"model": "7x24hrs-assistant", "user": "visitor-42",
"messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'加上 "stream": true 後,回答會以伺服器推送事件(SSE)的形式逐段傳回,與 OpenAI 的方式相同:
curl -N https://7x24hrs.com/v1/chat/completions \
-H "Authorization: Bearer sk-7x24-…" \
-H "Content-Type: application/json" \
-d '{"model": "7x24hrs-assistant", "stream": true,
"messages": [{"role": "user", "content": "Do you ship to Canada?"}]}'在聊天軟體裡回答是怎麼運作的
| 網站上的聊天按鈕 | 透過 API 的聊天軟體 | |
|---|---|---|
| 回答依據 | 您的網站資料、標準答案和角色 | 相同 |
| 沒有把握時 | 坦白說明,並把訪客轉給您 | 坦白說明,並在回答中提供您的聯絡地址 |
| 通知您 | 透過電子郵件、Slack、Discord 或 Telegram | 相同,標示「來自 API / AstrBot」 |
| 親自回覆訪客 | 在您的聊天軟體或後台 | 無法從這裡回覆:請用電子郵件回覆 |
| 對話計算 | 每位訪客每段對話算一次 | 相同,從同一份每月額度扣除 |
哪些方案可以接上聊天軟體?
所有付費方案:基礎方案每月 $19 可用 90 次對話,普通方案 $59 可用 275 次,精英方案 $199 可用 1,000 次,企業方案 $1,099 可用 6,000 次。透過 API 的對話與聊天按鈕共用同一份每月額度。免費方案不包含聊天軟體:在免費方案建立的金鑰會暫停,直到您選擇付費方案。請參閱價格。
怎樣算一次對話?
一位訪客的一段聊天,不論問了多少問題,都和聊天按鈕完全一樣。如果工具在每次請求中都帶上 user 欄位,我們就能分辨不同訪客;否則會以對話的第一則訊息來辨識一段對話。
AstrBot 裡的系統提示詞能改變助理說的話嗎?
不能。聊天軟體送來的系統提示詞不會被採用。助理始終遵守您的規則:只根據您網站的資料回答,不知道就直說,也不承諾您網站上沒寫的事。它的角色就是您在後台設定的那個。
支援圖片、語音訊息或工具呼叫嗎?
目前還不支援。只回答文字;訊息中的圖片和其他附件會被略過,沒有文字的訊息會收到明確的錯誤訊息。用戶端送來的工具定義也會被忽略。
金鑰外洩了怎麼辦?
在 聊天軟體與 API 中撤銷它:它會立即失效。接著建立一把新金鑰,貼到您的工具裡。金鑰只以指紋形式儲存,所以我們也無法再次顯示某把金鑰。