---
description: 深入了解發出 HTTP 請求 AI 代理動作如何讓您的 AI 代理在對話中呼叫外部 API，以擷取即時資料或在第三方系統中觸發操作。
title: AI 代理操作：發出 HTTP 請求
image: https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F3f43c48b21b24f4e8b02b100c0c8fab0
---

[新的我們剛完成了6,250萬美元的 B 輪融資！ 🎉 這對您意味著什麼![arrow-icon](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2Fe43213a7a9314673bd8d2060c25f9b87)](https://respond.io/blog/respond-io-raises-62-million-series-b)

幫助我... ⌘ 

1. [All Collections >](/tw/help)
2. [ 產品 >](/tw/help/product)
3. [ 人工智慧代理 >](/tw/help/ai-agents)
4. [ AI 代理操作 >](/tw/help/ai-skills)
5. AI 代理操作：發出 HTTP 請求

# AI 代理操作：發出 HTTP 請求

> **適用方案：**Advanced、Enterprise 以及部分 Legacy 方案可用。 測試對所有使用者開放，但發布需符合方案資格。

**Make HTTP requests** 動作可讓您的 AI 代理在對話期間呼叫外部 API。 這可讓 AI 代理根據聯絡人的請求擷取即時資料或在外部系統觸發操作。 例如，它可以檢查訂單狀態、擷取帳戶資訊或在其他系統建立記錄。 在本文中，您將學習如何設定 HTTP 請求動作並使用 AI 代理測試它。

AI 代理：

1. 分析聯絡人的訊息，以判斷是否符合您在動作說明中定義的意圖。
2. 收集任何所需資訊。
3. 發送 HTTP 請求。
4. 解析 API 回應。
5. 自然回覆聯絡人。

## 新增發出 HTTP 請求動作

開啟該動作，然後點選「Add action」按鈕以開始設定您的 HTTP 請求。

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/1Tbaws3LvA9FysLz9eC0Iv/594d61b1024dfcb48ca704559cc37070/addhttprequest.png?fm=jpg&q=80&w=1200&fl=progressive)

### 定義動作執行時機

在 **動作名稱** 欄位為該動作提供描述性名稱。

在 **何時以及如何執行此動作？** 欄位，描述： 

* AI 代理何時應使用此動作
* 它會擷取或傳送的內容
* 要處理的任何條件或結果
![](https://assets2-proxy.respond.io/ph8r57dk1q9w/1Ry7D5PA3Efyy2GFykdlYs/88cfe62f2b7c9b0792e81c1bb9d75c45/httprequest1.png?fm=jpg&q=80&w=1200&fl=progressive)

範例：

```html
當聯絡人詢問訂單時，使用此動作擷取其訂單狀態。 若 API 回傳 404 錯誤，請告知聯絡人無法找到該訂單。
```

AI 代理會使用此描述來決定何時觸發請求。

### AI 代理可能需要的資訊（可選）

在呼叫 API 之前，於此區段定義所需的輸入。

這些是 AI 必須收集的結構化變數。 只有在所有必要輸入可用後才會觸發該請求。

若某個值為：

* 已在對話中提及 → AI 會使用該值。
* 缺少 → AI 會向聯絡人詢問。

此處建立的變數可於 API 設定中使用。 聯絡人變數（例如 $contact.email）會自動可用，無需額外新增。

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/1SOzjJK2pM8p7CorIfIpLw/f4613151ecf044cacd5685035b823b06/httprequest2.png?fm=jpg&q=80&w=1200&fl=progressive)

**欄位設定**

| 欄位     | 註解                                                                                                           |
| ------ | ------------------------------------------------------------------------------------------------------------ |
| 名稱     | 在 API 請求中使用的變數識別符。 \- 每個動作唯一\- 僅限字母、數字與底線\- 區分大小寫\- 最多 30 個字元 使用方式：$agent.variable\_name 範例：$agent.order\_id |
| 格式     | 定義預期的資料類型： \- 文字（預設）\- 數字\- 布林值\- 日期 選擇正確的格式以減少歧義並提升可靠性。                                                     |
| 說明     | 說明該值代表何意，並協助 AI 清楚地詢問該值。範例：確認郵件中的 8 位數訂單編號。                                                                  |
| 陣列（可選） | 啟用此選項以收集多個值而非單一值。 每個項目皆遵循所選格式。若預期下列情況，請使用此選項：\- 多個產品 ID\- 多個追蹤編號 • 多項選擇                                      |

### API 設定

定義 AI 代理應如何呼叫您的 API。

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/HXBkfyTj6XeXtOX4FMBNB/fe70bf8f63cdb56cd6025cdeff0a341a/apiconfig1.png?fm=jpg&q=80&w=1200&fl=progressive)

您可以設定：

* 方法
* URL
* 查詢參數
* 標頭
* JSON 主體（適用於 POST、PUT、PATCH）

**引用變數**

您可以在 URL、參數、標頭或主體中使用 $ 插入變數。

![](https://assets2-proxy.respond.io/ph8r57dk1q9w/VJWbtyiJ64nQ175Or2uAd/bd77f2a10db9c58cd207ab2fd4f03873/apiconfig2.png?fm=jpg&q=80&w=1200&fl=progressive)

有兩種類型：

* 聯絡人變數 — 現有的聯絡人欄位

  * `$contact.email`
* AI 代理變數 — 在 _AI 代理可能需要的資訊_ 中定義的欄位

  * `$agent.order_id`

當請求執行時，變數會被替換為實際值。 若缺少必要的 AI 代理變數，AI 將在觸發 API 呼叫前詢問該值。

**AI 處理 API 回應的方式**

範例主體：

```json
{
  "order_id": "$agent.order_id",
  "email": "$contact.email"
}
```

AI 代理會自動解析 API 的 JSON 回應並產生自然回覆。

範例 API 回應：

```json
{
  "status": "shipped",
  "eta": "2025-12-12"
}
```

AI 回覆：「好消息！ 您的訂單已出貨，預計將於 2025 年 12 月 12 日抵達。」

**從 API 回應傳送圖片或檔案**

如果 API 回應包含有效的圖片或檔案 URL（例如平面圖、發票或產品照片），AI 代理可以將其作為渲染後的附件發送 — 使用與 Knowledge Source 和 Instruction URLs 相同的機制。 請參閱 [將檔案和圖片作為附件發送](https://respond.io/tw/help/ai-agents/how-to-write-effective-ai-agent-prompts#sending-files-and-images-as-attachments).

這需要明確授權的指示，例如：

```plain
當 API 回應中有有效的圖片/檔案 URL 時，將圖片/檔案作為附件發送。
```

如果沒有此指示，AI 代理僅會在文字回覆中使用該 URL — 不會將其作為附件發送。

## 測試

您可以在發布前於 **測試 AI 代理** 面板測試您的 HTTP 請求動作。

### 如何測試

1. 開始一個符合您動作條件的測試對話。  
![](https://assets2-proxy.respond.io/ph8r57dk1q9w/78KDUCw0a23kfXjjNmSM3M/6033d09c4ccec2669a0f122442ed54ab/testinghttprequest1.png?fm=jpg&q=80&w=1200&fl=progressive)
2. 當意圖被偵測且必要輸入可用時，AI 代理會執行 HTTP 請求。
3. 執行事件會顯示在測試面板中：  
![](https://assets2-proxy.respond.io/ph8r57dk1q9w/29SmyR5RSQ4gQ5Z3DpuV3K/4763b778c773d906fcbf2659eecf471d/testinghttprequest2.png?fm=jpg&q=80&w=1200&fl=progressive)
  1. **{AI Agent name} 已執行 {Action name}**
  2. 2xx 回應顯示為成功
  3. 其他所有狀態碼顯示為失敗
4. 點擊該事件以查看：  

  1. **回應** 分頁（預設）— 完整的 API 回應主體
  2. **請求** 分頁 — 完整的 cURL 請求有效負載
  3. 供除錯使用的複製選項
5. 在收到 API 回應後，AI 代理會根據回傳的資料產生回覆。

**重要說明**

* 執行事件僅顯示於 **測試 AI 代理面板**。 不會顯示在收件匣或聯絡人活動中。
* 若缺少必要輸入，AI 代理會在觸發請求前詢問這些資訊。

## 最佳實踐

* 在動作描述上要精確。 模糊的指示會導致模糊的觸發條件。
* 清楚定義必要輸入。 若 AI 必須詢問某項資訊，請讓之明顯易懂。
* 在說明中處理錯誤情況。
* 發布前務必先測試。
* 避免重複已由工作流程處理的邏輯，除非刻意如此設計。

## 限制

* 每個 AI 代理最多 10 個 HTTP 請求動作。
* 每個動作上限：  

  * 20 個資料輸入欄位
  * 50 個參數
  * 50 個標頭
* AI 代理會根據您撰寫的描述決定何時呼叫 API。 寫得不佳的指示可能導致意外觸發。
* API 回應會自動處理。 無法手動對應回應欄位 — AI 會依 JSON 內容進行語境化解讀。
* HTTP 請求執行事件僅顯示於測試 AI 代理面板，不會出現在聯絡人活動中。
* 語音 AI 代理可以觸發發出 HTTP 請求的動作。 不過，回傳的 API 回應不會回傳給語音 AI 代理以產生回覆，意即語音對話無法根據 API 結果做動態回應。
* 如果您的 AI 代理在同一回合內更新聯絡人欄位並在此動作中使用該欄位，該請求每次都會傳送舊值（若從未設定則為空）。 無論哪個動作先執行，都會發生這種情況. 如果您有興趣，請為 [功能請求](https://respond.canny.io/feature-request/p/contact-field-http-request-ensure-http-requests-use-latest-contact-field-values)投票.

## 常見問題與疑難排解

### 我可以觸發多個 API 端點嗎？

是的。 每個 AI 代理最多可配置 10 個獨立的 HTTP 請求動作。

### 我可以將聯絡人資料傳入 API 嗎？

是的。 在 URL、標頭、參數或主體中使用 $contact.field\_name。

### 若缺少必要資料會發生什麼情況？

AI 代理會在觸發請求前向聯絡人詢問缺少的資訊。

### AI 會等待 API 回應嗎？

是的。 AI 代理會等待回應、解析它，並根據回傳資料自然回覆。

### 我可以呼叫需要 OAuth 2.0 認證的 API 端點嗎？

不。 HTTP Request 不支援 OAuth 2.0 認證流程，例如使用者同意、授權碼交換、存取權杖刷新或動態權杖產生.

您可以在接受簡單認證方法的端點使用 HTTP Request，例如將 API 金鑰或靜態權杖加入 URL、查詢參數或標頭.

例如，如果您呼叫 Google API 的端點而請求失敗，請檢查該端點是否需要 OAuth 2.0 認證. 如果端點需要 OAuth 2.0 認證，則不支援. 如果該端點改為支援 API 金鑰或靜態權杖，您可以在 HTTP Request 的設定中使用該認證方法.  

分享這篇文章

[![Telegram](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F44daca77a4844f0c8fd29040ddeba057?width=22)](https://api.whatsapp.com/send?text=https://respond.io/help/ai-skills/ai-skill-make-http-requests)[![Facebook](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/fff57eeb01160bc604392f519b4f3461ca16f0fa1b6a587b20b142cdf1ad0ba7?placeholderIfAbsent=true&width=22)](https://www.facebook.com/sharer/sharer.php?u=https://respond.io/help/ai-skills/ai-skill-make-http-requests)[![Linkedin](https://assets1-proxy.respond.io/api/v1/image/assets/11f7a662b80a4675973850b067c01fa5/7aaf8d87b5410844d83e06a4ed663e4f551b8c5ef51dbb20a8ff064a1eed9a0f?placeholderIfAbsent=true&width=22)](https://www.linkedin.com/sharing/share-offsite/?url=https://respond.io/help/ai-skills/ai-skill-make-http-requests)[![Twitter](https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F4e03e02422a94e8eab9b8b41457c2371?width=22)](http://twitter.com/share?url=https://respond.io/help/ai-skills/ai-skill-make-http-requests)

## 

相關文章

* [AI 智能代理操作：新增註解了解 AI 智能代理如何在 respond.io 新增內部註解，以共享上下文、標註團隊成員，並協助順利交接. ](/tw/help/ai-skills/ai-agent-action-add-comments)
* [AI 代理操作：指派給代理或團隊了解 AI 代理在 respond.io 中如何將對話指派給代理、團隊或其他 AI 代理，包括指派方法、交接行為與主要限制。 ](/tw/help/ai-skills/ai-skill-assign-to-agent-or-team)
* [AI 代理操作：結束對話了解 respond.io 中「結束對話」操作的運作方式，包括如何觸發、套用結束說明與處理摘要。 ](/tw/help/ai-skills/ai-skill-close-conversations)
* [AI 代理操作：處理通話了解 AI 代理在 respond.io 中如何處理來電，包括語音行為、設定選項與主要限制。 ](/tw/help/ai-skills/ai-skill-handle-calls)
* [AI 代理動作：觸發工作流程瞭解 AI 代理如何在 respond.io 中觸發既有的工作流程，以執行進階的自動化與整合. ](/tw/help/ai-skills/ai-skill-trigger-workflow)

找不到您想要的東西？ 🔎

[聯繫支持](/tw/contact-us)

2026-10-02T10:08:53.117Z

help

```json
{"@context":"https://schema.org","@graph":[{"@context":"https://schema.org","@type":"TechArticle","articleBody":"深入了解發出 HTTP 請求 AI 代理動作如何讓您的 AI 代理在對話中呼叫外部 API，以擷取即時資料或在第三方系統中觸發操作。","author":{"@type":"Person","image":"https://assets2-proxy.respond.io/ph8r57dk1q9w/4GvzCieeTBRY4TRJUbIr4y/b92428e6b049d23f546269180534f7ea/Ryan_Tan_Avatar.svg","name":"Joshua Lim","url":"https://respond.io/tw/author"},"dateCreated":"2026-03-04T00:00:00.000Z","dateModified":"2026-10-02T08:29:04.095Z","datePublished":"2026-03-04T00:00:00.000Z","headline":"AI 代理操作：發出 HTTP 請求","mainEntityOfPage":"https://respond.io/tw/help/ai-skills","publisher":{"@id":"https://respond.io/#organization"},"url":"https://respond.io/tw/help/ai-skills/ai-skill-make-http-requests"},{"@context":"https://schema.org","@id":"https://respond.io/tw/help/ai-skills/ai-skill-make-http-requests#breadcrumb","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Help","item":"https://respond.io/tw/help"},{"@type":"ListItem","position":2,"name":"產品","item":"https://respond.io/tw/help/product"},{"@type":"ListItem","position":3,"name":"人工智慧代理","item":"https://respond.io/tw/help/ai-agents"},{"@type":"ListItem","position":4,"name":"AI 代理操作","item":"https://respond.io/tw/help/ai-skills"},{"@type":"ListItem","position":5,"name":"AI 代理操作：發出 HTTP 請求","item":"https://respond.io/tw/help/ai-skills/ai-skill-make-http-requests"}]},{"@type":"Organization","@id":"https://respond.io/#organization","name":"Respond.io","alternateName":"respond.io","url":"https://respond.io/","image":["https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F3f43c48b21b24f4e8b02b100c0c8fab0"],"logo":"https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F4045649d540241d398c39ab07b2b62bb","description":"Respond.io is an AI-powered customer conversation platform that helps businesses manage conversations, automate workflows and scale sales, marketing and support operations. Trusted by 10,000+ B2C brands, it unifies WhatsApp, TikTok, Instagram and Facebook in a single AI-powered team inbox for chats, calls and campaigns.","email":"success@respond.io","telephone":"+6011-54211197","foundingDate":"2017-02-17","address":{"@type":"PostalAddress","streetAddress":"Level 41, Permata Sapura Tower, Jalan Pinang","addressLocality":"Kuala Lumpur","addressRegion":"Federal Territory of Kuala Lumpur","postalCode":"50088","addressCountry":"MY"},"areaServed":"Worldwide","contactPoint":{"@type":"ContactPoint","contactType":"Customer Service","url":"https://respond.io/contact"},"sameAs":["https://respond.io/","https://www.facebook.com/getrespondio/","https://www.linkedin.com/company/respondio/","https://play.google.com/store/apps/details?id=com.respond.inbox.io","https://www.youtube.com/@respondio","https://twitter.com/respond_io","https://apps.apple.com/my/app/respond-io-inbox/id1667772955","https://www.g2.com/products/respond-io/reviews","https://www.producthunt.com/products/respond-io","https://zapier.com/apps/respondio/integrations","https://www.capterra.com/p/179311/Rocketbots/","https://www.crunchbase.com/organization/respondio","https://builtin.com/company/respondio","https://respond-io.en.softonic.com/web-apps","https://my.jobstreet.com/companies/respondio-168558101085004","https://brandfetch.com/respond.io","https://webcatalog.io/en/apps/respond-io"],"knowsAbout":["WhatsApp API","WhatsApp Business API","WhatsApp CRM","WhatsApp automation","omnichannel communication platform","WhatsApp Business Multiple Users","WhatsApp BSP","WhatsApp Business Solution Provider","WhatsApp automation tool","WhatsApp team inbox","WhatsApp AI agent","WhatsApp Business AI chatbot","WhatsApp marketing software","conversational sales platform","WhatsApp appointment booking"]},{"@type":"WebPage","@id":"https://respond.io/tw/help/ai-skills/ai-skill-make-http-requests#webpage","url":"https://respond.io/tw/help/ai-skills/ai-skill-make-http-requests","name":"AI 代理操作：發出 HTTP 請求","description":"深入了解發出 HTTP 請求 AI 代理動作如何讓您的 AI 代理在對話中呼叫外部 API，以擷取即時資料或在第三方系統中觸發操作。","isPartOf":{"@id":"https://respond.io/#website"},"primaryImageOfPage":{"@type":"ImageObject","url":"https://assets1-proxy.respond.io/api/v1/image/assets%2F11f7a662b80a4675973850b067c01fa5%2F3f43c48b21b24f4e8b02b100c0c8fab0"},"breadcrumb":{"@id":"https://respond.io/tw/help/ai-skills/ai-skill-make-http-requests#breadcrumb"}},{"@type":"WebSite","@id":"https://respond.io/#website","name":"Respond.io","url":"https://respond.io/","potentialAction":{"@type":"SearchAction","query-input":"required name=search_term_string","target":"https://respond.io/search?query={search_term_string}"},"publisher":{"@id":"https://respond.io/#organization"}}]}
```