場景集
Webhook 對外 看更多場景
場景 25 · Agent API 文件

每個 AI 助理都有現成的 API 文件，複製即可串

在助理編輯頁切到 API 串接 tab — 對話 API 自動產文件，列出端點、完整請求參數，Chatbot ID 已預先帶入。cURL / Python / PHP / C# 範例一鍵複製，工程師 5 分鐘把 Agent 串進 App。

全部大語言模型
全部回答模式
ID
名稱
大語言模型
回答模式
關聯知識庫
技能設定
建立者
最後更新時間
操作
3f9a82e1…
客服小幫手
Claude Sonnet 4.6
Agent 模式
ACME 客服知識庫
-
Simai Wang
2026-06-02 09:41
a1b2c3d4…
訂單查詢助理
Claude 4.5 Haiku
RAG 問答
ACME 訂單知識庫
-
Michael Chen
2026-06-01 16:47
b2c3d4e5…
技術支援助理
Claude 4.5 Haiku
Agent 模式
ACME 產品手冊
-
Aizhi Lin
2026-06-01 15:14
c3d4e5f6…
預約諮詢助理
Claude 4.5 Haiku
RAG 問答
ACME 門市 FAQ
-
Michael Chen
2026-05-28 15:02
d4e5f6a7…
行銷活動問答
Gemini 3.5 Flash
RAG 問答
ACME 活動知識庫
-
Siyuan Wu
2026-06-01 20:54
e5f6a7b8…
內部知識助理
Claude 4.5 Haiku
Agent 模式
-
-
Simai Wang
2026-05-28 13:57
共 315 條資料
1 2 3 4 5 … 32
10 條/頁
想串到自家 App？ 點任一助理進編輯頁，切到「API 串接」tab，每組端點都附 cURL / Python / PHP / C# 範例，Chatbot ID 與 API Key 已預先帶入，貼進編輯器即可跑。
以下程式碼已自動帶入目前 AI 助理的 ID
Chatbot ID: 3f9a82e1-7c40-4b6d-9c1a-df28fa49ad34
對話 API（純文字）
端點
POST /api/chatbots/{chatbot_id}/completions/
說明
傳送文字訊息至 AI 助理並取得回覆
請求參數
參數名稱
類型
必填
說明
conversation
string (uuid)
否
對話 ID，如果為空則會建立新對話
message
object
是
要傳送的訊息內容
message.content
string
是
訊息的文字內容
message.sender
string (uuid)
否
傳送者的 Contact ID（可選，如果提供需驗證屬於相同組織）
message.metadata
object
否
訊息的環境元資料，如 timezone（時區，格式：IANA 時區資料庫標準）
message.queryMetadata
object
否
查詢元資料，用於控制 RAG 查詢範圍（如 knowledge_bases、label_relations）
message.attachments
array[AttachmentInput]
否
訊息的附件清單
isStreaming
boolean
否
是否使用串流模式回覆，預設為 false
cURL
Python
PHP
C#
基本對話
curl -X POST "https://api.maiagent.ai/api/chatbots/3f9a82e1-7c40-4b6d-9c1a-df28fa49ad34/completions/" \
-H "Content-Type: application/json" \
-H "Authorization: Api-Key sk_••••••••" \
-d '{ "message": { "content": "幫我查 ACM-2841 的訂單狀態" } }'
核心流程
1
從 AI 助理列表進入
AI 功能 → AI 助理 列出帳號下所有助理（模型、回答模式、知識庫一覽）；點任一助理進編輯頁，切到「API 串接」tab。
2
讀 API 串接文件
對話 API（純文字）列出端點、完整請求參數與 cURL / Python / PHP / C# 範例，Chatbot ID 已自動帶入，貼進編輯器即可跑。