ติดตั้งส่วนขยาย Microsoft Copilot Studio สําหรับ Microsoft Visual Studio Code

Note

บทความนี้อธิบายคุณสมบัติที่ใช้ในเอเจนต์หรือการไหลของเอเจนต์ที่ขับเคลื่อนโดยฮาร์เนสมาตรฐาน

Prerequisites

ก่อนที่จะติดตั้งส่วนขยาย Microsoft Copilot Studio สําหรับ Microsoft Visual Studio Code ตรวจสอบให้แน่ใจว่าคุณตรงตามข้อกําหนดต่อไปนี้:

ความต้องการของระบบ

  • ระบบปฏิบัติการ:
    • Windows (สถาปัตยกรรม x64)
      • Windows 10 เวอร์ชัน 1809 หรือใหม่กว่า
      • Windows 11 (เวอร์ชันใดก็ได้)
    • macOS
  • Visual Studio Code: เวอร์ชัน 1.80 หรือใหม่กว่า (แนะนําเวอร์ชันเสถียรล่าสุด)
  • การเชื่อมต่ออินเทอร์เน็ต: จําเป็นสําหรับการติดตั้งและการรับรองความถูกต้อง

ข้อกําหนดของบัญชี

  • บัญชี Microsoft: บัญชี Microsoft ที่ใช้งานอยู่ พร้อมสิทธิ์การใช้งานหรือการเข้าถึง Copilot Studio
  • สิทธิ์การใช้งาน Copilot Studio: สิทธิ์การใช้งานที่เหมาะสมที่กําหนดให้กับบัญชีของคุณ
  • การอนุญาตการเข้าถึงสภาพแวดล้อม: สิทธิ์ในการเข้าถึงสภาพแวดล้อม Copilot Studio อย่างน้อยหนึ่งแห่ง
  • สิทธิ์ของตัวแทน: สิทธิ์ในการอ่านและเขียนตัวแทนใดๆ ที่คุณวางแผนจะแก้ไข

ขั้นตอนการติดตั้ง

คุณสามารถติดตั้งส่วนขยาย Copilot Studio ใน Visual Studio Code ได้สองวิธี:

  • ติดตั้งจากภายใน Visual Studio Code
  • ติดตั้งจากเว็บไซต์ Visual Studio Code Marketplace

วิธีที่ 1: ติดตั้งจาก Visual Studio Code

  1. เลือกไอคอนส่วนขยายในแถบกิจกรรมหรือกดCtrl+Shift+X บานหน้าต่าง Extensions เปิดขึ้นใน Visual Studio Code

  2. ในแถบค้นหา ป้อน "Copilot Studio" ค้นหาส่วนขยายทางการของ Copilot Studio ในรายการผลลัพธ์ ตรวจสอบว่าผู้เผยแพร่เป็น "Microsoft"

  3. เมื่อคุณพบส่วนขยายที่ถูกต้องแล้ว ให้เลือกส่วนขยายเพื่อเปิดหน้ารายละเอียดส่วนขยาย

  4. เลือก ติดตั้ง เพื่อเริ่มการติดตั้ง

  5. รอให้การติดตั้งเสร็จสิ้น คุณอาจเห็นพร้อมท์ให้โหลด Visual Studio Code ใหม่ ในกรณีนี้ ให้เลือก Reload เมื่อได้รับพร้อมท์

  6. ตรวจสอบการติดตั้ง ค้นหาไอคอน Copilot Studio ในแถบกิจกรรม ไอคอนจะปรากฏพร้อมโลโก้ Copilot Studio

วิธีที่ 2: ติดตั้งจากเว็บไซต์ Visual Studio Code marketplace

  1. ไปที่ https://marketplace.visualstudio.com/ และค้นหา "Copilot Studio" คุณยังสามารถใช้ลิงก์โดยตรง: https://marketplace.visualstudio.com/items?itemName=ms-CopilotStudio.vscode-copilotstudio ได้

  2. เลือกติดตั้งในหน้าตลาดกลาง เบราว์เซอร์ของคุณพร้อมท์ให้คุณดาวน์โหลด Visual Studio Code ก่อนที่จะขอให้คุณเปิด Visual Studio Code

  3. อนุญาตให้เบราว์เซอร์เปิด Visual Studio Code และยืนยันการติดตั้งโดยค้นหาไอคอนส่วนขยายในแถบกิจกรรม

การกำหนดค่าเริ่มต้น

เปิดตัวครั้งแรก

  1. เลือกไอคอน Copilot Studio ในแถบกิจกรรม ส่วนขยายจะเปิดขึ้นเป็นบานหน้าต่างแอปพลิเคชัน จะมีการแจ้งเตือนป๊อปอัพปรากฏขึ้น แจ้งว่าส่วนขยาย Copilot Studio ต้องการให้คุณลงชื่อเข้าใช้

  2. เลือก เข้าสู่ระบบ ในหน้าต่างป๊อปอัพ แล้วเลือก อนุญาต เบราว์เซอร์เริ่มต้นของคุณจะเปิดขึ้นไปยังหน้าการรับรองความถูกต้องของ Microsoft

  3. ป้อนข้อมูลรับรองการยืนยันตัวตนของคุณและดําเนินการยืนยันตัวตนแบบหลายปัจจัยให้เสร็จสมบูรณ์หากจําเป็น

  4. ตรวจสอบสิทธิ์ที่ร้องขอ

    • อ่านและเขียนเอเจนต์ Copilot Studio
    • เข้าถึงข้อมูลสภาพแวดล้อม
    • ซิงค์ไฟล์ไปยังระบบคลาวด์

    เลือกยอมรับหรืออนุญาต เบราว์เซอร์จะพร้อมท์ให้คุณปิดหน้าต่างและกลับไปยัง Visual Studio Code

  5. กลับไปยัง Visual Studio Code บานหน้าต่างส่วนขยายจะโหลดสภาพแวดล้อมที่คุณมีสิทธิ์เข้าถึง และตัวแทนในสภาพแวดล้อมเหล่านั้น

ตรวจสอบการตั้งค่าสําเร็จ

หลังจากการตรวจสอบสิทธิ์ คุณจะเห็นโครงสร้างภายใต้บานหน้าต่าง Agents ภายในส่วนขยาย Copilot Studio ใน Visual Studio Code คุณจะเห็นรายการกลุ่มสภาพแวดล้อมที่มีสภาพแวดล้อมซ้อนกันและเอเจนต์ ซึ่งมีโครงสร้างดังนี้:

AGENTS
  └─ Environment Group (for example, developer, default, sandbox, production)
      ├─ Example Environment 1
      │   ├─ Agent 1
      │   └─ Agent 2
      └─ Example Environment 2
          └─ Agent 3

แก้ไขปัญหาการติดตั้ง

ขั้นตอนการแก้ไขปัญหาต่อไปนี้จะแก้ไขปัญหาบางอย่างที่อาจเกิดขึ้นขณะติดตั้งหรือกําหนดค่าส่วนขยาย Copilot Studio Visual Studio Code

ส่วนขยายไม่ปรากฏขึ้น

Problem: ไอคอน Copilot Studio จะไม่ปรากฏในแถบกิจกรรม

วิธีการแก้:

  1. โหลด Visual Studio Code ใหม่
  2. เลือก ส่วนขยาย และมองหาส่วนขยายในรายการ ติดตั้ง ตรวจสอบให้แน่ใจว่าส่วนขยายไม่ได้ถูกปิดใช้งาน
  3. อัปเดต Visual Studio Code เป็นเวอร์ชันล่าสุด
  4. ติดตั้งส่วนขยายอีกครั้ง

การรับรองความถูกต้องล้มเหลว

ปัญหา: การรับรองความถูกต้องล้มเหลวหรือวนซ้ําซ้ํา

วิธีการแก้:

  1. ล้างแคชและคุกกี้ของเบราว์เซอร์สําหรับmicrosoft.com

  2. ลองเข้าสู่ระบบโดยใช้เบราว์เซอร์อื่นดู ตั้งค่าเบราว์เซอร์นี้เป็นค่าเริ่มต้นชั่วคราว

  3. ปิดใช้งานส่วนขยายเบราว์เซอร์ที่อาจบล็อกการรับรองความถูกต้อง

  4. ตรวจสอบการตั้งค่าไฟร์วอลล์และพร็อกซีของบริษัท

  5. ตรวจสอบว่าคุณใช้ประเภทบัญชีที่รองรับ

ไม่พบส่วนขยายใน Visual Studio Code marketplace

ปัญหา: คุณหาส่วนขยาย Copilot Studio ไม่เจอเมื่อค้นหา

วิธีการแก้:

  1. ตรวจสอบให้แน่ใจว่าคุณกําลังค้นหาในบานหน้าต่าง ส่วนขยาย ไม่ใช่การค้นหาบนเว็บ

  2. ตรวจสอบการสะกด: "Copilot Studio"

  3. ติดต่อผู้ดูแลระบบของคุณเพื่อดูว่าองค์กรของคุณจํากัดการเข้าถึง marketplace Visual Studio Code หรือไม่

ถอนการติดตั้งส่วนขยาย

ในการลบส่วนขยาย:

  1. เปิดบานหน้าต่างส่วนขยาย

  2. ค้นหา Copilot Studio ในส่วนขยายที่ติดตั้งไว้

  3. ในรายการ ให้เลือกไอคอน Manage แล้วเลือก Uninstall

  4. โหลด Visual Studio Code ใหม่เมื่อได้รับการแจ้งเตือน

Note

การถอนการติดตั้งส่วนขยายจะไม่ลบไฟล์ตัวแทนที่โคลนในเครื่อง คุณต้องลบไฟล์เหล่านี้ด้วยตนเอง

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

หลังจากติดตั้งส่วนขยายและการรับรองความถูกต้องกับ Copilot Studio แล้ว คุณก็พร้อมที่จะ:

  • Last updated on