วิธีสร้าง Custom Connector สำหรับ Copilot Studio เชื่อม API ของตัวเอง

วิธีสร้าง Custom Connector สำหรับ Microsoft Copilot Studio เริ่มจากเปิด Agent ที่ต้องการ เลือก Tools → Add a tool → New tool → Custom connector จากนั้นระบบจะเปิด Power Apps เพื่อให้สร้าง Connector ใหม่ โดยเลือกสร้างจาก Blank, OpenAPI Definition หรือ Postman Collection แล้วกำหนด API Endpoint, Authentication, Actions, Inputs และ Outputs เมื่อสร้างเสร็จให้ทดสอบ Connection ก่อนนำ Connector กลับมาเพิ่มเป็น Tool ใน Copilot Studio

Custom Connector เป็นเครื่องมือสำหรับเชื่อม AI Agent กับ REST API ขององค์กรหรือบริการที่ไม่มี Connector สำเร็จรูป

ตัวอย่างเช่น หากบริษัทมีระบบรับแจ้งซ่อมที่พัฒนาขึ้นเอง และมี API สำหรับตรวจสอบสถานะงาน สามารถสร้าง Custom Connector ให้ Copilot Agent รับหมายเลข Ticket จากผู้ใช้ ส่งไปยัง API แล้วนำสถานะจริงมาตอบได้

จากเดิมที่ Agent ทำหน้าที่เพียงตอบคำถามจาก Knowledge เมื่อเพิ่ม Custom Connector ก็สามารถเชื่อมต่อกับระบบธุรกิจที่องค์กรมีอยู่แล้วได้ โดยไม่จำเป็นต้องย้ายข้อมูลทั้งหมดมาเก็บใน Copilot Studio

อย่างไรก็ตาม การสร้าง Custom Connector ต้องมี REST API ที่ทำงานได้จริง มีข้อกำหนดการรับส่งข้อมูลชัดเจน และมีระบบ Authentication ที่เหมาะสม

การเพิ่ม URL ของเว็บไซต์ธรรมดาไม่ได้ทำให้เกิด Custom Connector โดยอัตโนมัติ เพราะเว็บไซต์สำหรับแสดงเนื้อหากับ API สำหรับให้ระบบเรียกข้อมูลมีหน้าที่แตกต่างกัน

บทความนี้ comsiam จะสอนวิธีสร้าง Custom Connector สำหรับ Copilot Studio อย่างละเอียด ตั้งแต่การออกแบบ API การสร้าง Connector ด้วย OpenAPI การตั้งค่า Security การกำหนด Actions การทดสอบ API และการนำไปใช้กับ AI Agent พร้อมตัวอย่างสำหรับระบบแจ้งซ่อม IT และบริการติดตั้งเครือข่าย

🔗 Custom Connector ใน Copilot Studio คืออะไร?

Custom Connector คือส่วนเชื่อมต่อ API ที่ผู้พัฒนาหรือองค์กรกำหนดขึ้นเอง เพื่อให้ Microsoft Power Platform และ Copilot Studio ติดต่อกับระบบที่ต้องการได้

แทนที่จะรอให้ Microsoft หรือผู้ให้บริการสร้าง Connector สำเร็จรูป องค์กรสามารถนำ API ที่มีอยู่มาสร้าง Custom Connector และกำหนด Actions ได้ด้วยตัวเอง

ตัวอย่างระบบที่เหมาะกับ Custom Connector

• ระบบแจ้งซ่อม IT
• ระบบจัดการลูกค้า
• ระบบติดตามโครงการ
• ระบบคลังสินค้า
• ระบบตรวจสอบสต็อก
• ระบบบริหารงานช่าง
• ระบบจองคิว
• ระบบติดตามคำสั่งซื้อ
• ระบบบริหารอุปกรณ์
• ระบบ ERP ที่องค์กรพัฒนาขึ้นเอง

Custom Connector ทำงานอย่างไร?

กระบวนการพื้นฐานมีดังนี้

1. ผู้ใช้ส่งคำถามให้ Agent
2. Agent วิเคราะห์คำขอ
3. เลือก Custom Connector Tool
4. เตรียม Input Parameters
5. Connector ส่ง HTTP Request ไปยัง API
6. API ตรวจสอบสิทธิ์
7. ระบบปลายทางประมวลผลคำขอ
8. API ส่ง Response กลับ
9. Connector ส่งผลลัพธ์ให้ Agent
10. Agent นำข้อมูลจริงมาตอบผู้ใช้

ตัวอย่าง

ผู้ใช้ถามว่า

“ตรวจสอบสถานะงาน IT-1001”

Agent เรียก Custom Connector ด้วย Ticket Number ที่ได้รับ

API อาจตอบกลับว่า

• Ticket Number: IT-1001
• Status: In Progress
• Assigned Team: Network Support

Agent จึงตอบสถานะตามข้อมูลที่ API ส่งกลับ แทนการคาดเดา

✨ Custom Connector ช่วยให้ Copilot Agent ทำอะไรได้บ้าง?

1. เชื่อมระบบที่ไม่มี Connector สำเร็จรูป

เหมาะกับโปรแกรมที่บริษัทพัฒนาขึ้นเอง

2. ค้นหาข้อมูลจาก API

เช่น ตรวจสอบสถานะงานหรือรายละเอียดโครงการ

3. อ่านข้อมูลล่าสุด

API สามารถคืนข้อมูลปัจจุบันจากระบบต้นทางได้ตามการออกแบบ

4. สร้างรายการใหม่

เช่น สร้าง Ticket หรือคำขอบริการ

5. อัปเดตข้อมูล

เปลี่ยนสถานะงานหรือบันทึกผลการดำเนินงานเมื่อได้รับอนุญาต

6. เชื่อม CRM

นำข้อมูลลูกค้าที่ได้รับอนุญาตมาใช้กับ Agent

7. เชื่อมระบบสินค้า

ใช้ตรวจสอบรายละเอียดสินค้าหรือจำนวนคงเหลือ

8. เชื่อมระบบช่างเทคนิค

ตรวจสอบรายการติดตั้งหรือบำรุงรักษา

9. ทำงานร่วมกับ Topics

กำหนดให้เรียก API หลังเก็บข้อมูลครบ

10. ทำงานร่วมกับ Generative Orchestration

ช่วยให้ Agent เลือก Tool ที่เหมาะสมตามคำอธิบายและความต้องการของผู้ใช้

🧩 องค์ประกอบของ Custom Connector

องค์ประกอบ	หน้าที่
API Host	เซิร์ฟเวอร์ปลายทาง
Base URL	เส้นทางหลักของ API
HTTP Method	วิธีเรียก API
Endpoint	เส้นทางบริการ
Authentication	ตรวจสอบสิทธิ์
Operation ID	ชื่อเฉพาะของ Action
Parameters	ข้อมูลที่ส่งไป
Request Body	ข้อมูลในคำขอ
Response	ผลลัพธ์จาก API
OpenAPI Definition	เอกสารอธิบาย API
Connection	การเชื่อมต่อที่ยืนยันตัวตนแล้ว
Custom Connector	ตัวเชื่อม API
Agent Tool	ความสามารถที่ Agent เรียกใช้

API Endpoint คืออะไร?

Endpoint คือเส้นทางที่ระบบเปิดให้เรียกใช้งาน

ตัวอย่างสมมติ:

https://api.example.com/v1/tickets/IT-1001

URL นี้ใช้สำหรับอธิบายรูปแบบ API ไม่ใช่บริการที่เปิดใช้งานจริง

HTTP Methods ที่ควรรู้

Method	การใช้งานทั่วไป
GET	อ่านข้อมูล
POST	สร้างข้อมูลหรือส่งคำขอ
PUT	แทนที่ข้อมูล
PATCH	แก้ไขบางส่วน
DELETE	ลบข้อมูล

การใช้ Method ขึ้นอยู่กับการออกแบบของ API ปลายทาง

🆚 Custom Connector กับ Connector สำเร็จรูปต่างกันอย่างไร?

Connector สำเร็จรูป

เป็นตัวเชื่อมต่อที่ Microsoft หรือผู้ให้บริการจัดเตรียมไว้แล้ว

ตัวอย่าง:

• SharePoint
• Outlook
• Microsoft Teams
• Dataverse

Custom Connector

เป็นตัวเชื่อมที่องค์กรสร้างขึ้นจาก API ของตัวเอง

ตารางเปรียบเทียบ

หัวข้อ	Connector สำเร็จรูป	Custom Connector
ผู้สร้าง	ผู้ให้บริการ	ผู้พัฒนาหรือองค์กร
การตั้งค่า	มักง่ายกว่า	ต้องกำหนด API
ใช้กับระบบเฉพาะ	ขึ้นอยู่กับ Connector	สามารถออกแบบเอง
Authentication	ตามที่รองรับ	ต้องกำหนดให้ถูกต้อง
Actions	มีให้เลือก	สร้างตาม API
การบำรุงรักษา	ผู้ให้บริการดูแลบางส่วน	องค์กรต้องดูแล API และ Connector
เหมาะกับ	บริการยอดนิยม	ระบบเฉพาะองค์กร

ควรเลือกแบบไหน?

หากบริการมี Connector สำเร็จรูปที่รองรับงานที่ต้องการ ควรพิจารณาใช้ตัวนั้นก่อน

แต่หากต้องเชื่อมระบบเฉพาะที่ไม่มี Connector ให้ใช้ Custom Connector

✅ ก่อนสร้าง Custom Connector ต้องเตรียมอะไรบ้าง?

1. REST API ที่ใช้งานได้

ต้องมีระบบปลายทางสำหรับรับ HTTP Requests

2. API Documentation

ควรทราบ Endpoint, Methods, Parameters และ Response

3. Authentication

เช่น API Key หรือ OAuth ตามความสามารถที่รองรับ

4. HTTPS

ควรใช้ HTTPS เพื่อป้องกันข้อมูลระหว่างส่งผ่านเครือข่าย

5. Copilot Studio Environment

ต้องมีสิทธิ์สร้าง Agent และเพิ่ม Tools

6. Power Apps หรือ Power Automate

ใช้สำหรับสร้างและทดสอบ Custom Connector

7. License

ตรวจสอบสิทธิ์การใช้ Custom Connectors และเงื่อนไขบริการ

8. ตัวอย่างข้อมูล

เตรียมข้อมูลทดสอบที่ไม่มีความลับ

9. Error Responses

API ควรส่งข้อผิดพลาดอย่างชัดเจน

10. ผู้รับผิดชอบ API

ต้องมีทีมดูแล API เมื่อเกิดข้อผิดพลาดหรือมีการเปลี่ยนแปลง

🚀 วิธีสร้าง Custom Connector ผ่าน Copilot Studio ทีละขั้นตอน

วิธีนี้เหมาะกับผู้ที่มี API ของตัวเองและต้องการนำมาเป็น Tool ให้ Agent

ขั้นตอนที่ 1: เปิด Microsoft Copilot Studio

ลงชื่อเข้าใช้ด้วยบัญชีที่มีสิทธิ์สร้าง Agent

ขั้นตอนที่ 2: เลือก Environment

เลือก Environment ที่จะใช้ Custom Connector

ขั้นตอนที่ 3: เปิด Agent

ไปที่ Agents แล้วเลือก Agent ที่ต้องการ

ขั้นตอนที่ 4: เปิด Tools

เลือกเมนู Tools

ขั้นตอนที่ 5: กด Add a tool

เปิดหน้าต่างเพิ่ม Tool

ขั้นตอนที่ 6: เลือก New tool

ระบบจะแสดงประเภท Tool ที่สร้างได้

ขั้นตอนที่ 7: เลือก Custom connector

ระบบจะนำไปยัง Power Apps Portal ส่วน Custom Connectors

ขั้นตอนที่ 8: เลือก New custom connector

เลือกวิธีสร้าง Connector

โดยทั่วไปสามารถสร้างจาก

• Blank
• OpenAPI Definition
• Postman Collection

ขั้นตอนที่ 9: ตั้งชื่อ Connector

ตัวอย่าง:

ITServiceAPI

ควรตั้งชื่อให้สื่อถึงระบบที่เชื่อมต่อ

ขั้นตอนที่ 10: กำหนด General Information

ระบุข้อมูลหลัก เช่น

• Host
• Base URL
• Scheme
• Description

ขั้นตอนที่ 11: กำหนด Security

เลือกวิธี Authentication ที่ตรงกับ API

ขั้นตอนที่ 12: กำหนด Definition

เพิ่ม Actions และระบุ Inputs/Outputs

ขั้นตอนที่ 13: สร้าง Connector

บันทึกและสร้าง Custom Connector

ขั้นตอนที่ 14: ทดสอบใน Power Apps

สร้าง Connection แล้วใช้หน้า Test เรียก API

ขั้นตอนที่ 15: กลับไป Copilot Studio

เปิด Agent แล้วเพิ่ม Custom Connector Action เป็น Tool

ขั้นตอนที่ 16: กำหนด Tool Description

เขียนว่า Tool นี้ใช้เมื่อใด

ขั้นตอนที่ 17: ทดสอบกับ Agent

ทดลองใช้คำถามที่ต้องเรียก API

ขั้นตอนที่ 18: Publish

เมื่อทดสอบและตรวจสอบสิทธิ์เรียบร้อยแล้ว จึง Publish Agent

📝 วิธีสร้าง Custom Connector จาก OpenAPI

OpenAPI คือรูปแบบเอกสารสำหรับอธิบาย REST API

ช่วยให้ระบบรู้ว่า API มี Endpoint ใด ต้องรับข้อมูลแบบไหน และส่งผลลัพธ์อะไรกลับมา

ข้อดี

• ลดการกรอก API Definition ด้วยตัวเอง
• มีโครงสร้างชัดเจน
• รองรับการกำหนด Parameters
• ระบุ Response Schema ได้
• นำกลับมาแก้ไขและดูแลเวอร์ชันได้

ข้อกำหนดสำคัญ

สำหรับการนำเข้า Custom Connector ด้วย OpenAPI Definition รูปแบบที่ Microsoft รองรับคือ OpenAPI 2.0 หรือ Swagger 2.0

เอกสารที่เป็น OpenAPI 3.x อาจต้องแปลงเป็นรูปแบบที่รองรับก่อนนำเข้า

ขั้นตอน

1. เตรียมไฟล์ OpenAPI
2. เปิด Power Apps
3. เปิด Custom Connectors
4. เลือก New custom connector
5. เลือก Import an OpenAPI file
6. ตั้งชื่อ Connector
7. อัปโหลดไฟล์
8. ตรวจสอบ General
9. ตั้งค่า Security
10. ตรวจสอบ Definition
11. สร้าง Connector
12. ทดสอบ Connection
13. เพิ่มเป็น Tool ใน Copilot Studio

🧪 ตัวอย่าง OpenAPI สำหรับ API ตรวจสอบสถานะ Ticket

ตัวอย่างต่อไปนี้เป็นโครงสร้าง Swagger 2.0 สำหรับ API สมมติ

นำไปปรับให้ตรงกับ Endpoint, Security และ Response ของระบบจริงก่อนใช้งาน

swagger: "2.0"

info:
  title: IT Service API
  description: API for retrieving IT service ticket status
  version: "1.0"

host: api.example.com
basePath: /v1
schemes:
  - https

consumes:
  - application/json
produces:
  - application/json

securityDefinitions:
  ApiKeyAuth:
    type: apiKey
    name: x-api-key
    in: header

security:
  - ApiKeyAuth: []

paths:
  /tickets/{ticketId}:
    get:
      summary: Get ticket status
      description: Retrieve the current status of an IT service ticket.
      operationId: GetTicketStatus

      parameters:
        - name: ticketId
          in: path
          required: true
          type: string
          description: Unique service ticket identifier

      responses:
        "200":
          description: Ticket found
          schema:
            type: object
            properties:
              ticketId:
                type: string
              status:
                type: string
              assignedTeam:
                type: string

        "401":
          description: Authentication failed

        "403":
          description: Access denied

        "404":
          description: Ticket not found

        "500":
          description: Internal server error

ตัวอย่าง Response ที่ API ควรส่งกลับ

{
  "ticketId": "IT-1001",
  "status": "In Progress",
  "assignedTeam": "Network Support"
}

ตัวอย่างนี้ไม่ได้สร้าง API ให้โดยอัตโนมัติ ต้องมีเซิร์ฟเวอร์ที่รองรับ Endpoint ดังกล่าวจริง

จุดสำคัญ

• host ต้องเป็นโดเมน API จริง
• basePath ต้องตรงกับ API
• operationId ควรไม่ซ้ำ
• ticketId เป็น Input
• responses ต้องตรงกับผลลัพธ์จริง
• ต้องตั้ง Authentication ให้ตรงกับระบบปลายทาง

🔐 วิธีตั้งค่า Authentication สำหรับ Custom Connector

Authentication เป็นส่วนที่ต้องตรวจสอบอย่างรอบคอบ

1. API Key

เหมาะกับ API ที่รองรับการส่ง Key ใน Header หรือ Parameter

ตัวอย่าง Header:

x-api-key

2. OAuth 2.0

เหมาะกับบริการที่รองรับการยืนยันตัวตนผ่าน OAuth

3. Microsoft Entra ID

เหมาะกับ API ภายในองค์กรที่ใช้ระบบตัวตน Microsoft

4. Basic Authentication

บางระบบอาจรองรับ แต่ควรพิจารณานโยบายความปลอดภัยและความเหมาะสม

ข้อควรระวัง

ไม่ควรฝัง API Key ลงใน Instructions หรือข้อความที่ผู้ใช้งานมองเห็น

ควรใช้ Connection และระบบจัดการ Credentials ที่รองรับ

API Key ควรมีสิทธิ์แค่ไหน?

ควรจำกัดสิทธิ์ให้ตรงกับ Action

ตัวอย่าง:

หาก Agent ต้องตรวจสอบสถานะ Ticket อย่างเดียว API Key ควรมีสิทธิ์อ่านเฉพาะข้อมูลที่เกี่ยวข้อง ไม่ควรมีสิทธิ์ลบรายการหรือจัดการบัญชีผู้ใช้

⚙️ วิธีตั้งค่า General ใน Custom Connector

หน้า General ใช้กำหนดรายละเอียดการเชื่อมต่อหลัก

Host

โดเมน API

ตัวอย่าง:

api.example.com

Base URL

เส้นทางหลัก

ตัวอย่าง:

/v1

Scheme

ควรใช้ HTTPS เมื่อ API รองรับ

Description

ระบุว่า Connector ใช้ทำอะไร

ตัวอย่าง:

“Custom connector for internal IT service management API.”

Icon

สามารถเพิ่มไอคอนเพื่อช่วยระบุ Connector ในรายการ

🧱 วิธีสร้าง Actions ใน Custom Connector

หนึ่ง Custom Connector สามารถกำหนดหลาย Actions ได้ตาม API ที่รองรับ

ตัวอย่าง:

GetTicketStatus

ตรวจสอบสถานะงาน

CreateTicket

สร้าง Ticket ใหม่

UpdateTicketStatus

อัปเดตสถานะ

GetProjectDetails

ค้นรายละเอียดโครงการ

ควรสร้างทุก Action พร้อมกันไหม?

สำหรับมือใหม่ แนะนำให้เริ่มจาก Action ที่อ่านข้อมูลก่อน

เมื่อทดสอบสำเร็จแล้ว ค่อยเพิ่ม Actions ที่เปลี่ยนแปลงข้อมูล

ทำไมจึงควรเริ่มจาก GET?

เพราะการอ่านข้อมูลมีความเสี่ยงต่อการเปลี่ยนแปลงระบบต่ำกว่าการสร้างหรือแก้ไขรายการ

อย่างไรก็ตาม ยังต้องควบคุมสิทธิ์ในการอ่านข้อมูลที่เป็นความลับด้วย

🔄 วิธีนำ Custom Connector กลับมาใช้ใน Copilot Studio

เมื่อสร้าง Connector เสร็จแล้ว ต้องเพิ่ม Action ให้ Agent

ขั้นตอน

1. เปิด Copilot Studio
2. เลือก Agent
3. ไปที่ Tools
4. กด Add a tool
5. เลือก Connector
6. ค้นหา Custom Connector ที่สร้าง
7. เลือก Action
8. สร้างหรือเลือก Connection
9. กำหนด Authentication
10. กด Add and configure
11. ตั้งชื่อ Tool
12. เขียน Description
13. ตรวจสอบ Inputs
14. บันทึก
15. ทดสอบ

ตัวอย่าง Tool Name

GetTicketStatus

ตัวอย่าง Description

“Retrieve the current status of an existing IT service ticket using its ticket number. Use this tool when an authorized user asks for the status of a ticket.”

ทำไม Description ต้องชัดเจน?

เพราะ Generative Orchestration สามารถใช้ชื่อและ Description ของ Tool ช่วยเลือกการดำเนินงานให้เหมาะกับคำถามได้

🧠 วิธีเขียน Instructions ให้ Copilot Agent เรียก Custom Connector ถูกต้อง

ตัวอย่าง Instructions สำหรับระบบตรวจสอบ Ticket

“You are an internal IT service assistant.

Help authorized users retrieve information about service tickets.

When the user asks for the status of an existing ticket, use the configured GetTicketStatus tool.

If the ticket number is missing, ask the user to provide it.

Do not invent ticket numbers, work statuses, assigned teams, or completion dates.

Only report information returned by the connected API.

If the tool returns 404, explain that the ticket was not found.

If the tool returns an authentication or permission error, explain that the operation could not be completed.

Never claim that an external action succeeded unless the tool confirms success.

Respond in polite Thai.”

ทำไมต้องระบุ Error Handling?

เพราะ API อาจส่งข้อผิดพลาดแทนผลลัพธ์ปกติ

Agent ควรจัดการตามผลจริง ไม่ใช่พยายามสร้างสถานะงานขึ้นเอง

🏢 ตัวอย่างเชื่อม API ระบบแจ้งซ่อมของบริษัท

สมมติว่าบริษัทมีระบบ Service Management ของตัวเอง

API ที่มีอยู่

• GET /tickets/{ticketId}
• POST /tickets
• PATCH /tickets/{ticketId}

เป้าหมาย

ให้ AI Agent สามารถ

1. ตรวจสอบสถานะงาน
2. รับข้อมูลแจ้งซ่อม
3. สร้าง Ticket หลังผู้ใช้ยืนยัน
4. ส่งผลลัพธ์ให้ผู้ใช้
5. แจ้งเมื่อระบบไม่พร้อมใช้งาน

ขั้นตอนการออกแบบ

ขั้นที่ 1: สร้าง Connector สำหรับ GET Ticket

ขั้นที่ 2: ทดสอบอ่านข้อมูล

ขั้นที่ 3: เพิ่ม Tool เข้า Agent

ขั้นที่ 4: ทดสอบการเลือก Tool

ขั้นที่ 5: เพิ่ม POST Create Ticket

ขั้นที่ 6: สร้าง Topic สำหรับเก็บข้อมูล

ขั้นที่ 7: ให้ผู้ใช้ตรวจสอบข้อมูลก่อนส่ง

ขั้นที่ 8: เรียก Tool

ขั้นที่ 9: ตรวจสอบ Response

ขั้นที่ 10: แจ้งหมายเลข Ticket ที่ API ส่งกลับ

ข้อควรระวัง

หาก API ส่งข้อผิดพลาด Agent ต้องไม่แจ้งว่าสร้าง Ticket สำเร็จ

ควรแสดงข้อความว่าการดำเนินงานยังไม่สำเร็จ และให้ผู้ใช้ลองใหม่หรือติดต่อเจ้าหน้าที่

🌐 ตัวอย่าง Custom Connector สำหรับธุรกิจติดตั้ง LAN และ Fiber Optic

ธุรกิจบริการ IT สามารถพัฒนา API เพื่อเชื่อมระบบภายในกับ Copilot Studio

ตัวอย่างระบบ

Service Management API

มีข้อมูลเกี่ยวกับ

• ลูกค้า
• โครงการ
• งานติดตั้ง
• งานซ่อม
• งานบำรุงรักษา
• สถานะงาน

ตัวอย่าง API Actions

GetProjectStatus

ค้นสถานะโครงการ

GetServiceRequest

ค้นรายการแจ้งซ่อม

CreateSiteSurveyRequest

สร้างคำขอสำรวจหน้างาน

GetMaintenanceSchedule

ตรวจสอบกำหนดบำรุงรักษา

ตัวอย่างบทสนทนา

ลูกค้า: โครงการติดตั้ง Fiber Optic ของฉันถึงขั้นตอนไหนแล้ว?

Agent: กรุณาระบุหมายเลขโครงการเพื่อให้ตรวจสอบข้อมูล

ลูกค้า: FO-1001

Agent เรียก GetProjectStatus เมื่อผู้ใช้ผ่านการตรวจสอบสิทธิ์ตามระบบ

หาก API ส่งสถานะกลับมา Agent จึงสรุปผลให้ลูกค้า

สิ่งที่ต้องระวัง

ไม่ควรให้ผู้ใช้ที่ทราบหมายเลขโครงการของผู้อื่นสามารถเข้าถึงข้อมูลนั้นได้โดยอัตโนมัติ

API ต้องตรวจสอบ Authorization ตามตัวตนและสิทธิ์ของผู้ร้องขอ

🧪 วิธีทดสอบ Custom Connector ก่อนใช้กับ Agent

ควรทดสอบ Connector ใน Power Apps หรือ Power Automate ก่อนนำเข้า Copilot Studio

ทดสอบที่ 1: API ทำงานปกติ

ส่ง Request ที่ถูกต้อง

ทดสอบที่ 2: Authentication

ตรวจสอบว่า Key หรือ Token ใช้งานได้

ทดสอบที่ 3: Input Parameters

ตรวจสอบค่าที่ส่งให้ API

ทดสอบที่ 4: Response Schema

ตรวจสอบว่า JSON Response ตรงกับ Definition

ทดสอบที่ 5: ไม่พบข้อมูล

ให้ API ส่ง 404 เมื่อเหมาะสม

ทดสอบที่ 6: ไม่มีสิทธิ์

ตรวจสอบ 401 และ 403

ทดสอบที่ 7: ข้อมูลผิดรูปแบบ

ตรวจสอบ 400 Bad Request

ทดสอบที่ 8: Server Error

ทดสอบ Error Handling

ทดสอบที่ 9: Timeout

ตรวจสอบการจัดการเมื่อ API ไม่ตอบสนอง

ทดสอบที่ 10: ข้อมูลลับ

ตรวจสอบว่าไม่ส่ง Credentials หรือข้อมูลสำคัญออกมาใน Response โดยไม่จำเป็น

📊 HTTP Status Codes ที่ควรรู้

Status	ความหมาย
200	สำเร็จ
201	สร้างข้อมูลสำเร็จ
400	คำขอไม่ถูกต้อง
401	ยังไม่ผ่านการยืนยันตัวตน
403	ไม่มีสิทธิ์
404	ไม่พบข้อมูล
429	เรียกใช้งานมากเกินกำหนด
500	ระบบปลายทางผิดพลาด
503	บริการไม่พร้อมใช้งาน

Agent ควรจัดการอย่างไร?

เมื่อ API สำเร็จ ให้ใช้ข้อมูลที่ส่งกลับ

เมื่อ API ไม่สำเร็จ ให้แจ้งข้อผิดพลาดตามสถานการณ์ และไม่สร้างผลลัพธ์ขึ้นเอง

🔐 วิธีรักษาความปลอดภัย Custom Connector

1. ใช้ HTTPS

2. ใช้ Authentication ที่เหมาะสม

3. ไม่ฝัง API Key ใน Prompt

4. จำกัดสิทธิ์ API

5. ตรวจสอบ Authorization ฝั่ง Server

6. ใช้ Rate Limiting

7. ตรวจสอบ Inputs

8. ไม่ส่งข้อมูลลับเกินจำเป็น

9. ใช้ Data Policies ของ Power Platform

10. จัดการ API Logs ตามนโยบาย

11. แยก Development และ Production

12. ทดสอบการเข้าถึงข้ามบัญชี

13. ใช้หลัก Least Privilege

14. กำหนดผู้รับผิดชอบ Connector

15. ติดตามข้อผิดพลาดและการใช้ API

ข้อสำคัญ: แม้ Agent จะได้รับ Instructions ว่าห้ามเปิดเผยข้อมูลลับ แต่ API ต้องบังคับใช้สิทธิ์จริง ไม่ใช่เชื่อเพียงข้อความที่ Agent ส่งมา

⚠️ ข้อจำกัดของ Custom Connector ที่ควรรู้

1. ต้องมี API ที่ทำงานจริง

Custom Connector ไม่ใช่เครื่องมือสร้าง Back-end Database โดยอัตโนมัติ

2. ต้องมี API Definition

ต้องอธิบาย Endpoint, Parameters และ Responses

3. ต้องใช้ Authentication ที่รองรับ

บางรูปแบบ Authentication อาจมีข้อจำกัดตามบริการ

4. มีข้อจำกัดด้าน OpenAPI

กระบวนการนำเข้า Custom Connector รองรับ OpenAPI 2.0 ตามข้อกำหนดที่ระบุ

5. มีข้อจำกัดด้าน License

Custom Connector อาจมีเงื่อนไขสิทธิ์เพิ่มเติม

6. API อาจมี Rate Limits

ต้องตรวจสอบข้อจำกัดของบริการปลายทาง

7. มี Data Policies

องค์กรอาจจำกัดการใช้ Custom Connectors

8. Connection อาจหมดอายุ

ต้องจัดการ Token หรือ Credentials

9. API เปลี่ยนแล้ว Connector อาจเสีย

ต้องอัปเดต Definition ให้ตรงกับ API Version

10. มีต้นทุนดูแลรักษา

องค์กรต้องดูแล API, Connector, Security และ Monitoring

🔧 Custom Connector ใช้งานไม่ได้ แก้อย่างไร?

ปัญหาที่ 1: ไม่พบ Custom Connector

ตรวจสอบ Environment และสิทธิ์

ปัญหาที่ 2: นำเข้า OpenAPI ไม่สำเร็จ

ตรวจสอบรูปแบบไฟล์และเวอร์ชัน Swagger

ปัญหาที่ 3: API Endpoint ผิด

ตรวจสอบ Host และ Base URL

ปัญหาที่ 4: Authentication Failed

ตรวจสอบ API Key, OAuth หรือ Microsoft Entra ID

ปัญหาที่ 5: 401 Unauthorized

ตรวจสอบ Credentials

ปัญหาที่ 6: 403 Forbidden

ตรวจสอบ Authorization ของ API

ปัญหาที่ 7: 404 Not Found

ตรวจสอบ Endpoint หรือ ID ที่ใช้ค้นหา

ปัญหาที่ 8: 429 Too Many Requests

ตรวจสอบ Rate Limits

ปัญหาที่ 9: 500 Internal Server Error

ตรวจสอบ Logs ของ API ปลายทาง

ปัญหาที่ 10: Response ไม่ตรง Schema

ตรวจสอบ JSON Structure และ Definition

ปัญหาที่ 11: Agent ไม่เรียก Tool

ตรวจสอบ Tool Name, Description และ Inputs

ปัญหาที่ 12: Tool เรียก API แล้วแต่ Agent ตอบผิด

ตรวจสอบ Output และ Instructions

ปัญหาที่ 13: Custom Connector ถูก Policy บล็อก

ติดต่อผู้ดูแล Power Platform

ปัญหาที่ 14: ใช้ได้ใน Test แต่ใช้จริงไม่ได้

ตรวจสอบ Authentication และ Channel

ปัญหาที่ 15: API เปลี่ยน Version

อัปเดต Connector ให้ตรงกับ API

ปัญหาที่ 16: Agent เรียก API ซ้ำ

ตรวจสอบ Orchestration, Topics และการยืนยันก่อนเรียก Action

ปัญหาที่ 17: สร้าง Ticket ซ้ำ

ควรใช้กลไก Idempotency หรือการตรวจสอบรายการซ้ำใน API ฝั่ง Server

ปัญหาที่ 18: ข้อมูลลูกค้ารั่วไหล

ตรวจสอบ Authorization และจำกัดการเข้าถึงทันที พร้อมดำเนินการตามนโยบาย Incident Response

📋 Checklist ก่อน Publish Agent ที่ใช้ Custom Connector

รายการ	สิ่งที่ต้องตรวจสอบ
API Host	ถูกต้อง
HTTPS	เปิดใช้งาน
OpenAPI Definition	ถูกต้อง
Operation IDs	ไม่ซ้ำ
Authentication	เหมาะสม
Authorization	ตรวจสอบฝั่ง Server
Connection	พร้อมใช้งาน
Inputs	ถูกต้อง
Outputs	ตรง Schema
Error Handling	ครบถ้วน
Rate Limiting	ตั้งค่าแล้ว
Tool Description	ชัดเจน
Permissions	จำกัดตามหน้าที่
Sensitive Data	ป้องกันแล้ว
Test Cases	ผ่านการทดสอบ
Environment	เหมาะสม
API Owner	มีผู้รับผิดชอบ
Monitoring	พร้อมใช้งาน
Publish	เวอร์ชันล่าสุด

📈 10 เทคนิคสร้าง Custom Connector ให้ใช้งานได้ดี

1. เริ่มจาก API แบบ Read-Only

2. ใช้ Endpoint ที่ออกแบบชัดเจน

3. ตั้ง Operation ID ไม่ซ้ำ

4. เขียน API Description ให้ตรงหน้าที่

5. ใช้ HTTPS และ Authentication ที่เหมาะสม

6. กำหนด Response Schema ให้ชัดเจน

7. จัดการ HTTP Errors

8. ทดสอบ API ก่อนเพิ่มเข้า Agent

9. จำกัดสิทธิ์และตรวจสอบข้อมูลก่อนดำเนินงาน

10. ดูแล API Version และ Connector อย่างต่อเนื่อง

การสร้าง Connector ที่ดีควรทำให้ระบบเข้าใจง่าย มีความปลอดภัย และสามารถตรวจสอบได้ ไม่ใช่เพียงเรียก API ได้สำเร็จในครั้งแรก

❓ คำถามที่พบบ่อยเกี่ยวกับ Custom Connector ใน Copilot Studio

Custom Connector คืออะไร?

Custom Connector คือส่วนเชื่อมต่อ API ที่ผู้พัฒนากำหนดเอง เพื่อให้ Copilot Studio และบริการ Power Platform ติดต่อระบบภายนอกได้

วิธีสร้าง Custom Connector สำหรับ Copilot Studio ทำอย่างไร?

เปิด Agent เลือก Tools → Add a tool → New tool → Custom connector จากนั้นสร้าง Connector ใน Power Apps แล้วนำ Action กลับมาเพิ่มเป็น Tool

Custom Connector ต้องเขียนโค้ดไหม?

ขึ้นอยู่กับระบบ หากมี API และ OpenAPI Definition พร้อมแล้ว สามารถใช้เครื่องมือแบบกราฟิกได้ แต่ถ้ายังไม่มี API ต้องพัฒนาระบบปลายทางก่อน

Copilot Studio เชื่อม API ของตัวเองได้ไหม?

ได้ โดยใช้ Custom Connector หรือเครื่องมือ API ที่รองรับตามประเภท Agent

Custom Connector รองรับ REST API ไหม?

รองรับ REST API ผ่านการกำหนด Endpoint, Methods และ Definition

Custom Connector รองรับ OpenAPI 3.0 ไหม?

กระบวนการนำเข้า Custom Connector ตามเอกสาร Microsoft ใช้ OpenAPI 2.0 จึงควรแปลง OpenAPI 3.x เป็นรูปแบบที่รองรับก่อน

Custom Connector ใช้ API Key ได้ไหม?

ได้เมื่อ API และ Connector รองรับการยืนยันตัวตนแบบ API Key

Custom Connector ใช้ OAuth ได้ไหม?

ได้ตามรูปแบบ OAuth ที่ Custom Connector รองรับ

Custom Connector ใช้ Microsoft Entra ID ได้ไหม?

ได้สำหรับ API ที่รองรับการยืนยันตัวตนผ่าน Microsoft Entra ID และมีการตั้งค่าถูกต้อง

Custom Connector ใช้กับ Topics ได้ไหม?

ได้ สามารถเรียก Connector Actions ภายใน Topics ที่รองรับ

Custom Connector ใช้กับ Generative Orchestration ได้ไหม?

ได้ โดย Agent สามารถเลือก Tools ตาม Description และบริบทตามความสามารถที่รองรับ

Custom Connector อ่านข้อมูลฐานข้อมูลได้ไหม?

ได้เมื่อมี API ที่เปิดให้เข้าถึงข้อมูลและกำหนดสิทธิ์ถูกต้อง

Custom Connector เขียนข้อมูลได้ไหม?

ได้เมื่อ API รองรับการเขียนข้อมูลและมีสิทธิ์ที่เหมาะสม

Custom Connector ส่งข้อมูลไปเว็บของตัวเองได้ไหม?

ได้หากเว็บไซต์มี API Endpoint ที่รองรับและมีการตั้งค่า Authentication อย่างเหมาะสม

Custom Connector กับ Power Automate ต่างกันอย่างไร?

Custom Connector ใช้เชื่อม API ส่วน Power Automate ใช้สร้าง Workflow ซึ่งสามารถเรียก Custom Connector ได้

Custom Connector ต่างจาก Knowledge อย่างไร?

Knowledge เน้นค้นหาและตอบคำถามจากข้อมูล ส่วน Custom Connector ใช้เรียก API เพื่ออ่านหรือดำเนินงานกับระบบจริง

Custom Connector มีค่าใช้จ่ายไหม?

อาจมีค่าใช้จ่ายตาม License, API Hosting, API Usage และบริการที่เกี่ยวข้อง

ทำไม Agent ไม่เรียก Custom Connector?

อาจเกิดจาก Tool Description ไม่ชัดเจน Connection ไม่พร้อม หรือ Inputs ไม่ครบ

API Key ควรใส่ใน Instructions หรือไม่?

ไม่ควร ควรใช้ระบบ Connection และ Credentials ที่รองรับ

Custom Connector เหมาะกับงานประเภทใด?

เหมาะกับงานที่ต้องเชื่อม AI Agent กับระบบธุรกิจเฉพาะองค์กร เช่น Helpdesk, CRM, ERP, Inventory และ Project Management

✅ สรุปวิธีสร้าง Custom Connector สำหรับ Copilot Studio

Custom Connector ช่วยให้ Microsoft Copilot Studio เชื่อม AI Agent กับ REST API ขององค์กรหรือบริการที่ไม่มี Connector สำเร็จรูปได้

ขั้นตอนหลักคือเตรียม API และ OpenAPI Definition จากนั้นสร้าง Custom Connector ใน Power Apps กำหนด General, Security และ Definition ทดสอบ Connection แล้วเพิ่ม Action เป็น Tool ใน Copilot Studio

เมื่อเชื่อมต่อสำเร็จ Agent สามารถใช้ API เพื่อค้นหาข้อมูล ตรวจสอบสถานะงาน สร้างรายการ หรือดำเนินงานอื่นตามความสามารถและสิทธิ์ที่ได้รับ

อย่างไรก็ตาม Custom Connector ไม่ได้สร้าง API หรือฐานข้อมูลให้เอง ต้องมีระบบปลายทางที่ทำงานได้จริง และมีมาตรการ Authentication, Authorization และ Error Handling ที่เหมาะสม

สำหรับผู้เริ่มต้น ควรทดลองเชื่อม API แบบอ่านข้อมูลก่อน เช่น GetTicketStatus แล้วค่อยเพิ่ม Actions ที่สร้างหรือแก้ไขข้อมูลหลังผ่านการทดสอบ

comsiam แนะนำให้ใช้แนวทาง เตรียม API → สร้าง OpenAPI Definition → สร้าง Custom Connector → ตั้ง Authentication → เพิ่ม Actions → ทดสอบ Connection → เพิ่มเป็น Agent Tool → ตรวจสอบสิทธิ์ → Publish → ติดตามผล

การสร้าง Custom Connector อย่างถูกต้องจะช่วยให้องค์กรต่อยอด AI Agent จากระบบตอบคำถามไปสู่ผู้ช่วยที่เชื่อมกับซอฟต์แวร์และข้อมูลธุรกิจจริงได้อย่างมีประสิทธิภาพและปลอดภัย