โคลนตัวแทน Microsoft Copilot Studio ของคุณใน Microsoft Visual Studio Code

Note

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

เมื่อคุณโคลนเอเจนต์จาก Microsoft Copilot Studio ใช้ส่วนขยาย คุณดาวน์โหลดคํานิยามเอเจนต์และข้อกําหนดคอมโพเนนต์ที่เกี่ยวข้องจาก Copilot Studio ลงในเครื่องคอมพิวเตอร์ของคุณ คุณสามารถแก้ไขไฟล์เหล่านี้โดยใช้ Microsoft Visual Studio Code การดําเนินการโคลนจะสร้างพื้นที่ทํางานภายในเครื่องที่มีไฟล์เอเจนต์ทั้งหมดในรูปแบบไดเร็กทอรีที่มีโครงสร้าง

Prerequisites

ก่อนที่คุณจะเริ่มการโคลนตัวแทน มีข้อกําหนดเบื้องต้นและข้อควรพิจารณาที่สําคัญบางประการ

เลือกตําแหน่งพื้นที่ทํางาน

เลือกโฟลเดอร์ภายในที่เหมาะสมสําหรับไฟล์ตัวแทนของคุณ ตําแหน่งนี้เป็นที่ที่ส่วนขยายบันทึกไฟล์ตัวแทน ต่อไปนี้เป็นเคล็ดลับสําคัญในการเลือกสถานที่:

  • ตรวจสอบให้แน่ใจว่ามีพื้นที่ดิสก์เพียงพอ ตัวแทนทั่วไปสามารถมีขนาดได้ขึ้นอยู่กับจํานวนส่วนประกอบ
  • ใช้เส้นทางที่ไม่มีช่องว่างหากเป็นไปได้ แม้ว่าจะรองรับช่องว่างก็ตาม
  • พิจารณาใช้ตําแหน่งที่ตั้งที่ Git ติดตามอยู่แล้ว

ทําความเข้าใจสิ่งที่ถูกโคลน

เมื่อคุณโคลนเอเจนต์ ไฟล์ตัวแทนจะถูกลอกแบบภายในเครื่องในตําแหน่งที่ตั้งที่คุณเลือก สร้างข้อกําหนดโครงสร้างดังต่อไปนี้ใน Visual Studio Code Explorer:

my-agent/
├── actions                   # Connectors
│   ├── DevOpsAction.mcs.yml  
│   └── GetItems.mcs.yml      
├── knowledge/files                # Knowledge sources
│   ├── source1.yaml
│   └── source2.yaml
├── topics/                   # Conversation topics
│   ├── greeting.mcs.yaml
│   ├── help.mcs.yaml
│   └── escalate.mcs.yaml
├── workflows/                    # Agent tools and actions
│   └── GetDevOpsItems
│       ├── metadata.yaml
│       └── workflow.json
│   └── GetMeetings
│       ├── metadata.yaml
│       └── workflow.json
├── trigger/                 # Event triggers
│   └── welcometrigger.mcs.yaml
├── agent.mcs.yaml                # Main agent definition
├── icon.png                      # Icon used for the agent, visible in test panel and in supported channels
├── settings.mcs.yml              # Configuration settings for the agent
└── connectioreferences.mcs.yml   # Connection References used by Connectors and other actions

วิธีการโคลน

ถ้าคุณกําลังใช้ส่วนขยายเป็นครั้งแรก หรือแม้แต่เรื่องใหม่ในการ Visual Studio Code วิธีที่ง่ายที่สุดในการโคลนตัวแทนคือการเลือก Clone Agent เมื่อบานหน้าต่าง Extension เปิดอยู่ อย่างไรก็ตาม ตัวเลือกนี้จะไม่พร้อมใช้งานเมื่อคุณมีซอฟต์แวร์เอเจนต์ที่ถูกโคลนและเปิดอยู่ในเครื่องคอมพิวเตอร์ของคุณแล้ว สามารถใช้วิธีการต่อไปนี้แทนได้:

นี่เป็นวิธีที่ตรงไปตรงมาและแนะนําที่สุดในการโคลนตัวแทน

  1. เปิดส่วนขยาย Copilot Studio โดยการเลือกไอคอน Copilot Studio ในแถบกิจกรรม คุณยังสามารถกด Ctrl+Shift+P และป้อน "Copilot Studio: มุ่งเน้นไปที่มุมมองตัวแทน" บานหน้าต่าง Copilot Studio จะเปิดขึ้นในแถบด้านข้าง

  2. ในบานหน้าต่าง ตัวแทน ให้เลือกสภาพแวดล้อมเป้าหมายของคุณจากรายการดรอปดาวน์ (ตัวอย่างเช่น "สภาพแวดล้อม 1") เพื่อดูรายการของตัวแทนในสภาพแวดล้อม

    > Environment 1
  Environment 2
  Environment 3

  3. เลือกเอเจนต์ที่จะโคลนจากรายการ เอเจนต์แสดงวันที่แก้ไขล่าสุด คลิกขวาที่ชื่อตัวแทนแล้วเลือกโคลนตัวแทน

    > Customer Support Agent
    HR Assistant
    Sales Agent
    IT Helpdesk Agent

    กล่องโต้ตอบตัวเลือกไฟล์จะเปิดขึ้น

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

  5. รอให้กระบวนการโคลนเสร็จสิ้น การแจ้งเตือนความคืบหน้าจะปรากฏขึ้นโดยแสดง "ตัวแทนโคลน: บอทสนับสนุนลูกค้า" ตามด้วยข้อความสําเร็จ "โคลนตัวแทนสําเร็จ" กระบวนการนี้มักจะใช้เวลา 10-30 วินาที

  6. ตรวจสอบว่าการโคลนเสร็จสมบูรณ์ โฟลเดอร์เอเจนต์เปิดขึ้นใน Visual Studio Code explorer บานหน้าต่างควบคุมต้นทางแสดงแผนผังการทํางานที่สะอาด และหน้าต่างไฟล์จะแสดงชื่อของโฟลเดอร์ของคุณ

วิธีที่ 3: โคลนโดยใช้พาเลตคำสั่ง

ใช้วิธีนี้หากคุณต้องการเวิร์กโฟลว์ที่เน้นแป้นพิมพ์

  1. เปิดจานคําสั่งโดยกดCtrl+Shift+P

  2. พิมพ์ "Copilot Studio: Clone Agent" แล้วกด Enter เมื่อคำสั่งถูกดำเนินการแล้ว พร้อมท์จะปรากฏขึ้น

  3. ทําตามคําแนะนําเพื่อเลือกสภาพแวดล้อมของคุณ เลือกตัวแทน เลือกโฟลเดอร์ปลายทาง และรอให้การโคลนเสร็จสมบูรณ์ ตัวแทนจะถูกโคลนไปยังตําแหน่งที่คุณเลือก

วิธีที่ 3: โคลนโดยใช้ URL ของตัวแทนระบบ

วิธีนี้มีประโยชน์เมื่อมีคนแชร์ URL ของตัวแทนกับคุณ

  1. เปิดตัวแทนของคุณในพอร์ทัลของเว็บ Copilot Studio

  2. เลือกรายละเอียดตัวแทน> และคัดลอก URL ของตัวแทน URL ควรมีรูปแบบ: https://copilotstudio.microsoft.com/environments/{guid}/bots/{guid}. ตอนนี้ URL อยู่ในคลิปบอร์ดของคุณแล้ว

  3. กลับไปยัง Visual Studio Code และเปิดส่วนขยาย Copilot Studio

  4. เลือก ตัวแทนจำลอง ส่วนขยายจะตรวจพบ URL ในคลิปบอร์ดของคุณและแสดงตัวแทนที่ทําเครื่องหมายเป็น "(จากคลิปบอร์ด)"

  5. เลือกตัวแทนที่มีเครื่องหมาย "(จากคลิปบอร์ด)" เลือกโฟลเดอร์ปลายทาง และรอให้การโคลนเสร็จสมบูรณ์ ตัวแทนจะถูกโคลนไปยังตําแหน่งที่คุณเลือก

สถานการณ์ทั่วไปเกี่ยวกับการโคลน

ต่อไปนี้คือสถานการณ์ทั่วไปบางประการเมื่อการโคลนตัวแทนมีประโยชน์ พร้อมรายละเอียดระดับสูงเกี่ยวกับเวิร์กโฟลว์ที่แนะนํา

สถานการณ์ที่ 1: ลอกแบบสําหรับการพัฒนาเดี่ยว

เป้าหมาย: ทํางานกับตัวแทนด้วยตัวเอง

  1. โคลนตัวแทนไปยังโฟลเดอร์ภายในเครื่อง

  2. เริ่มต้นการเก็บ Git จากการควบคุมเวอร์ชันในเมนูการนำทาง

  3. ทําการเปลี่ยนแปลงภายในเครื่อง

  4. ทําข้อผูกมัดของคุณ

  5. นําการเปลี่ยนแปลงไปใช้กับ Copilot Studio เมื่อพร้อม

สถานการณ์ที่ 2: โคลนสําหรับการทํางานร่วมกันเป็นทีม

เป้าหมาย: นักพัฒนาหลายคนทํางานกับตัวแทนเดียวกัน

  1. นักพัฒนาคนแรกทำการคัดลอกตัวแทน

  2. นักพัฒนารายแรกเริ่มต้น Git และส่งเนื้อหาไปยังที่เก็บที่ใช้ร่วมกัน (GitHub Azure DevOps)

  3. นักพัฒนาท่านอื่นทำการโคลนจากที่เก็บ Git ที่แชร์ร่วมกัน

  4. นักพัฒนาแต่ละคนเรียกใช้ Copilot Studio: Reattach Agent เพื่อเชื่อมต่อโฟลเดอร์ภายในเครื่องของตนกับ Copilot Studio

  5. ทีมใช้ Git เพื่อทํางานร่วมกันและติดตามการเปลี่ยนแปลง และใช้ส่วนขยาย Visual Studio Code ในการทํางานกับตัวแทน

  6. นักพัฒนาแต่ละคนจะนําการเปลี่ยนแปลงไปใช้กับ Copilot Studio เพื่อทดสอบหรือส่งไปยังสภาพแวดล้อมปลายทางอื่นตามวงจรชีวิตการพัฒนาซอฟต์แวร์หรือไปป์ไลน์อัตโนมัติ

สถานการณ์ที่ 3: จำลองหลายสภาพแวดล้อม

เป้าหมาย: จัดการเวอร์ชันการพัฒนา การทดสอบ และการผลิต

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

  1. โคลนเอเจนต์จากสภาพแวดล้อมการพัฒนาไปยังโฟลเดอร์การพัฒนาภายในเครื่อง

  2. ทําการเปลี่ยนแปลงในโฟลเดอร์การพัฒนา

  3. ใช้การเปลี่ยนแปลงเหล่านั้นและทดสอบการเปลี่ยนแปลงในสภาพแวดล้อมเดียวกัน

  4. ใช้ Copilot Studio: เชื่อมต่อตัวแทนใหม่ เพื่อเชื่อมต่อตัวแทนกับสภาพแวดล้อมทางเลือก

  5. ทดสอบตัวแทนในบานหน้าต่างการทดสอบ Copilot Studio

แนวทางปฏิบัติที่ดีที่สุด

ทำ

  • โคลนตัวแทนทั้งหมดไปยังตําแหน่งที่สอดคล้องกัน
  • เริ่มต้น Git ทันทีหลังจากโคลน
  • ใช้ชื่อโฟลเดอร์ที่มีความหมาย
  • ตรวจสอบว่าโคลนทํางานก่อนทําการเปลี่ยนแปลง
  • รักษาตำแหน่งการโคลนของคุณไว้ให้สำรองเสมอ (ตัวอย่างเช่น ใน GitHub หรือ Azure DevOps)
  • บันทึกตําแหน่งโคลนของคุณใน Wiki หรือเอกสารภายในของทีม

ไม่

  • อย่าทำการคัดลอกไปยังไดเรกทอรีชั่วคราว
  • อย่าโคลนหลายครั้งไปยังตําแหน่งที่ต่างกัน การทําเช่นนี้อาจทําให้เกิดความสับสนได้

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

หลังจากที่คุณโคลนตัวแทนของคุณ:

  • Last updated on