取得機器人列表並對話

基礎 URL: https://api.maiagent.ai/api

認證方式

所有 API 請求都需要在標頭中使用 API 金鑰進行認證：

Authorization: Api-Key YOUR_API_KEY

端點

1. 取得對話機器人列表

取得可用的對話機器人列表。

curl -X GET \
  'https://api.maiagent.ai/api/v1/chatbots/?page=1&pageSize=10' \
  -H 'Authorization: Api-Key YOUR_API_KEY'

參數：

• page (查詢參數)：分頁頁碼

• pageSize (查詢參數)：每頁項目數

回應：

{
  "count": "integer",
  "next": "string|null",
  "previous": "string|null",
  "results": [
    {
      "id": "string",
      "name": "string",
      "largeLanguageModel": {
        "id": "string",
        "name": "string",
        "isDefault": "boolean"
      },
      "rag": {
        "id": "string",
        "name": "string",
        "isDefault": "boolean",
        "isEmbeddingModelSelectable": "boolean",
        "isRerankerModelSelectable": "boolean"
      },
      "embeddingModel": {
        "id": "string",
        "name": "string",
        "isDefault": "boolean"
      },
      "rerankerModel": {
        "id": "string",
        "name": "string",
        "isDefault": "boolean"
      },
      "updatedAt": "string"
    }
  ]
}

2. 建立對話完成

向對話機器人發送訊息並取得回應。

curl -X POST \
  'https://api.maiagent.ai/api/v1/chatbots/{chatbot_id}/completions/' \
  -H 'Authorization: Api-Key YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "conversation": "string|null",
    "message": {
      "content": "string",
      "attachments": []
    },
    "is_streaming": boolean
  }'

參數：

• chatbot_id (路徑參數)：對話機器人 ID

• conversation (請求內容)：可選的對話 ID，用於延續對話

• message.content (請求內容)：要發送的訊息內容

• message.attachments (請求內容)：附件陣列（如果有的話）

• is_streaming (請求內容)：是否使用串流回應

回應（非串流）：

{
  "content": "string",
  "conversationId": "string"
}

回應（串流）：

伺服器發送事件格式如下：

data: {
  "content": "string",
  "conversation_id": "string",
  "done": boolean
}

注意事項：

• 對於串流回應，伺服器會發送多個包含部分內容的事件，直到回應完成

• 回應中返回的對話 ID 可用於後續請求中延續對話

串接成果