---
title: "การเชื่อมต่อ API"
description: "เปลี่ยน HTTP API ใดก็ได้ให้เป็นฟังก์ชันที่เอเจนต์ของคุณเรียกใช้ระหว่างการสนทนาได้: วางคำสั่ง cURL แล้ววิซาร์ดจะสร้างนิยามเครื่องมือ พารามิเตอร์ และการยืนยันตัวตน"
---

การเชื่อมต่อ API คือฟังก์ชัน HTTP แบบกำหนดเองที่เอเจนต์ของคุณสามารถเรียกใช้ระหว่างการสนทนาได้ เช่น ค้นหาคำสั่งซื้อ สร้างทิกเก็ต หรือดึงสถานะบัญชีจากแบ็กเอนด์ของคุณเอง คุณกำหนดเอนด์พอยต์เพียงครั้งเดียวภายใต้
**การเชื่อมต่อ → API** (`/dashboard/api-connections`) จากนั้นเอเจนต์ที่แนบการเชื่อมต่อนี้ไว้จะเรียกใช้ได้ทุกเมื่อที่การสนทนาต้องการ

มีสองวิธีในการสร้าง: วางข้อมูลให้วิซาร์ดวิเคราะห์ หรือตั้งค่าการเชื่อมต่อด้วยตนเอง

## วิธีที่รวดเร็ว: วางและวิเคราะห์

<Steps>
  <Step title="คลิก การเชื่อมต่อ API ใหม่">
    กล่องโต้ตอบจะเปิดที่วิซาร์ด วางตัวอย่าง **คำสั่ง cURL**,
    **สเปก OpenAPI/Swagger**, **ไฟล์ส่งออก Postman**, **อินเทอร์เฟซ
    TypeScript** หรือ **สคีมา Zod** ลงในกล่อง
  </Step>
  <Step title="คลิก วิเคราะห์">
    ThunderPhone อนุมานการเชื่อมต่อทั้งหมดจากข้อมูลที่คุณวาง — URL,
    เมธอด เฮดเดอร์ และสคีมาพารามิเตอร์ที่ได้จากพารามิเตอร์คิวรีและเนื้อหาคำขอ
    ที่พบ เฮดเดอร์ที่คุณวางไว้ (รวมถึงเฮดเดอร์การยืนยันตัวตน)
    จะถูกนำไปใช้ในการกำหนดค่าเอนด์พอยต์
  </Step>
  <Step title="ยืนยันฟิลด์ที่ไฮไลต์">
    การกำหนดค่าที่อนุมานได้จะเปิดขึ้นพร้อมไฮไลต์ฟิลด์ที่คาดเดาไว้
    เพื่อให้ตรวจสอบ ปรับชื่อ คำอธิบาย และประเภทพารามิเตอร์เพื่อให้
    เอเจนต์เข้าใจว่าควรเรียกใช้ฟังก์ชันเมื่อใดและอย่างไร — คำอธิบายคือสิ่งที่โมเดลอ่าน
  </Step>
  <Step title="ตรวจสอบและบันทึก">
    การบันทึกจะส่งคำขอทดสอบจริงไปยังเอนด์พอยต์ของคุณก่อน หาก
    คำขอล้มเหลว การเชื่อมต่อจะไม่ถูกบันทึก — แก้ไข URL เฮดเดอร์การยืนยันตัวตน
    หรือเนื้อหาคำขอ แล้วลองอีกครั้ง เมื่อสำเร็จ การเชื่อมต่อจะถูกจัดเก็บ
    พร้อมป้าย **ตรวจสอบแล้ว**
  </Step>
</Steps>

หากวิซาร์ดไม่พบ URL ของคำขอในข้อมูลที่คุณวาง จะแจ้งให้ทราบ —
ให้ระบุเอนด์พอยต์ `http(s)` แบบเต็มแล้วลองอีกครั้ง

## การตั้งค่าด้วยตนเอง

คลิก **ตั้งค่าด้วยตนเอง →** ในวิซาร์ด (หรือ **ต้องการให้ AI อนุมานข้อมูลนี้หรือไม่?
ลองใช้วิซาร์ด →** เพื่อย้อนกลับ) เครื่องมือสร้างแบบกำหนดเองมีตัวแก้ไขสองแบบ:

- **แบบภาพ** — ฟิลด์แบบฟอร์มสำหรับชื่อที่แสดง ชื่อฟังก์ชัน
  **URL**, **เมธอด** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`), **เฮดเดอร์**
  แบบกำหนดเอง และสคีมาพารามิเตอร์ (**เพิ่มพร็อพเพอร์ตี้** สำหรับแต่ละ
  อาร์กิวเมนต์ที่เอเจนต์สามารถระบุได้)
- **JSON** — คำจำกัดความเดียวกันในรูปแบบ JSON ดิบ สำหรับวางหรือปรับแต่ง
  สเปกเครื่องมือโดยตรง

แผง **ทดสอบคำขอ** (ไม่บังคับ) ให้คุณส่งคำขอที่กำหนดค่าไว้
ก่อนบันทึก และแสดงสถานะ เวลาแฝง และตัวอย่างการตอบกลับ
**ตรวจสอบและบันทึก** จะเรียกใช้การทดสอบนี้เสมอ และจะบันทึกเมื่อสำเร็จเท่านั้น

<Tip>
  ระบุคำอธิบายพารามิเตอร์ด้วยภาษาที่เข้าใจง่าย ("ที่อยู่อีเมลลูกค้า
  เช่น jane@example.com") เอเจนต์จะเลือกอาร์กิวเมนต์จากคำอธิบายเหล่านี้
  แบบเรียลไทม์ระหว่างการโทร
</Tip>

## จัดการการเชื่อมต่อของคุณ

แต่ละแถวของการเชื่อมต่อจะแสดงสถานะการตรวจสอบ — **ตรวจสอบแล้ว**,
**ยังไม่ได้ทดสอบ** หรือ **ข้อผิดพลาด** — ชื่อฟังก์ชัน และเอเจนต์ที่ใช้งาน
จากเมนูการดำเนินการของแถว คุณสามารถ:

- **แก้ไข** — เปิดการกำหนดค่าอีกครั้ง
- **โคลน** — ทำสำเนาเพื่อใช้เป็นจุดเริ่มต้น (สำเนาจะเริ่มต้นในสถานะ
  ยังไม่ได้ทดสอบ)
- **ประวัติการแก้ไข** — ดูเวอร์ชันก่อนหน้าและกู้คืนเวอร์ชันหนึ่งไปยัง
  ตัวแก้ไข
- **โอนย้าย** — คัดลอกหรือย้ายการเชื่อมต่อไปยังองค์กรอื่นที่คุณ
  เป็นสมาชิก การย้ายจะลบออกจากที่นี่ เอเจนต์ที่ใช้งานอยู่
  อาจต้องกำหนดค่าใหม่
- **ลบ** — ถาวร เอเจนต์ที่ใช้การเชื่อมต่อนี้จะต้องได้รับการ
  กำหนดค่าใหม่

## แนบเข้ากับเอเจนต์

เพิ่มการเชื่อมต่อนี้ไปยังเอเจนต์ในส่วนการเชื่อมต่อ API ของเครื่องมือสร้าง
([สร้างเอเจนต์](/th/guides/build-an-agent)) รายการจะแสดงว่าเอเจนต์ใด
ใช้การเชื่อมต่อแต่ละรายการ เพื่อให้คุณเห็นได้ทันทีว่าการเปลี่ยนแปลงส่งผลต่ออะไร

## ขั้นตอนถัดไป

<CardGroup cols={2}>
  <Card title="การผสานรวมเครื่องมือผ่าน API" icon="code" href="/th/guides/build-tool-integration">
    สร้างและจัดการการเชื่อมต่อเดียวกันด้วยโปรแกรม
  </Card>
  <Card title="เชื่อมต่อแอป" icon="cable" href="/th/guides/connect-apps">
    การเชื่อมต่อ Google, Slack, HubSpot, Salesforce และ Cal.com ที่สร้างไว้ล่วงหน้า
  </Card>
  <Card title="เพิ่มเซิร์ฟเวอร์ MCP" icon="server" href="/th/guides/mcp-servers">
    เปิดใช้เซิร์ฟเวอร์เครื่องมือทั้งเซิร์ฟเวอร์ให้เอเจนต์ของคุณ
  </Card>
  <Card title="ข้อมูลอ้างอิง API การผสานรวม" icon="book" href="/api-reference/integrations">
    ทุกฟิลด์ในทรัพยากรการผสานรวม
  </Card>
</CardGroup>