แชร์ผ่าน

ตัวเชื่อมต่อตัวอย่าง (พรีวิว)

สำคัญ

[บทความนี้เป็นคู่มือรุ่นก่อนวางจำหน่าย และอาจจะมีการเปลี่ยนแปลงในอนาคต]

คุณสามารถใช้การดำเนินการตัวเชื่อมต่อที่ผ่านการรับรองตาม Contoso Hub - ตัวเชื่อมต่อ เพื่อตรวจสอบความสามารถในการขยายที่มีอยู่ใน Microsoft 365 Copilot สำหรับฝ่ายขาย

หากต้องการลองดำเนินการกับตัวเชื่อมต่อที่ผ่านการรับรอง ให้ทำตามคำแนะนำใน จัดการส่วนขยายสำหรับ Copilot สำหรับฝ่ายขาย และเปิดใช้งานการดำเนินการตัวเชื่อมต่อ Contoso Hub สำหรับ Copilot สำหรับฝ่ายขาย

คุณสามารถแก้ไขตัวเชื่อมต่อตัวอย่างและการดำเนินการเพื่อเริ่มต้นใช้งานได้อย่างรวดเร็ว โปรดดูแนวทางต่อไปนี้เมื่อคุณแก้ไขการสร้างตัวเชื่อมต่อหรือการดำเนินการ:

  • ตัวเชื่อมต่อตัวอย่างมีตัวยึดสำหรับเส้นทาง API คุณสามารถแทนที่ตัวยึดเหล่านี้ด้วยเส้นทาง API จริงได้

  • วิธีการ HTTP ควรตรงกับวิธีที่ระบุไว้ในข้อกำหนด OpenAPI ตัวอย่าง

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

  • ชนิดพารามิเตอร์อินพุตควรตรงกับวิธีที่ระบุไว้ในข้อกำหนด OpenAPI

  • API ที่อธิบายโดยข้อกำหนด OpenAPI ไม่ควรมีพารามิเตอร์ที่จำเป็นที่ไม่มีอยู่ในข้อกำหนด OpenAPI ตัวอย่าง มิฉะนั้น Copilot สำหรับฝ่ายขายจะไม่เรียกใช้ API และล้มเหลวโดยมีข้อผิดพลาดภายใน

  • อย่าใช้ connectorId เป็นพารามิเตอร์อินพุตในข้อกำหนด OpenAPI เนื่องจากเป็นพารามิเตอร์ที่สงวนไว้

  • คุณสมบัติของออบเจ็กต์ผลลัพธ์ที่ทำเครื่องหมายว่าจำเป็นในคำจำกัดความ OpenAPI จะต้องมีอยู่ในการตอบสนองของ API

  • API ตัวเชื่อมต่อแต่ละตัวควรดำเนินการให้เสร็จสิ้นภายในห้าวินาที โดยเฉพาะอย่างยิ่งการดำเนินการของตัวเชื่อมต่อที่ปรับปรุงความสามารถที่มีอยู่

  • การรับรองความถูกต้องคาดว่าจะได้รับการจัดการโดยโครงสร้างในตัวเชื่อมต่อ Microsoft Power Platform และอยู่นอกขอบเขตของแต่ละ API

  • ภาษาของผู้ใช้ปัจจุบันจะถูกส่งผ่านในส่วนหัวคำขอเป็น Accept-Language ใช้สำหรับการดำเนินการเฉพาะภาษา

  • อ่านส่วนหัวต่อไปนี้จากคำขอไปยังตัวเชื่อมต่อของคุณ และส่งไปที่แบ็กเอนด์ของคุณเพื่อการวินิจฉัยที่ดีขึ้น:

    • x-ms-client-request-id: รหัสเฉพาะสำหรับคำขอที่เข้ามา
    • x-ms-user-agent: "sales-copilot" ถูกใช้เป็นค่า

ขยาย Microsoft 365 Copilot สำหรับฝ่ายขายด้วยแอปพลิเคชันของคู่ค้า
สร้างส่วนขยาย Copilot สำหรับฝ่ายขาย