แก้ไขเจ้าหน้าที่ Microsoft Copilot Studio ของคุณใน Microsoft Visual Studio Code

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

โครงสร้างไฟล์ตัวแทน

การทําความเข้าใจโครงสร้างไฟล์เป็นกุญแจสําคัญในการแก้ไขอย่างมีประสิทธิภาพ

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

แก้ไขการตั้งค่าคอนฟิกเอเจนต์หลัก

คุณสมบัติ IntelliSense

ขณะที่คุณพิมพ์ คําแนะนําจะปรากฏขึ้นและค่าที่ไม่ถูกต้องจะถูกเน้น คําแนะนําเหล่านี้จะเปลี่ยนไปตามระดับของโหนดที่คุณอยู่

• ใช้ Ctrl+Space เพื่อรับคําแนะนําตามระดับของโหนด
• ใช้ Ctrl+F เพื่อค้นหาชื่อตัวแปรและข้อมูลอื่น ๆ ทั่วทั้งตัวแทนของคุณเพื่ออัปเดตอย่างรวดเร็ว

ดูปัญหา

คุณสามารถดูปัญหากับไฟล์ในบานหน้าต่าง Problems ใน Visual Studio Code นอกจากนี้ เมื่อคุณเปิดไฟล์ คุณจะเห็นขีดเส้นใต้สีแดงที่ระบุปัญหา

แผงปัญหา

1. ใช้เพื่อ Ctrl+Shift+M เปิดบานหน้าต่าง 'ปัญหา ' (หรือไปที่ 'ดู>ปัญหา')

2. ดูข้อผิดพลาดและคําเตือนทั้งหมด

3. เลือกปัญหาใด ๆ เพื่อข้ามไปยังตําแหน่ง

การทํางานกับการเปลี่ยนแปลง

เมื่อทําการเปลี่ยนแปลงและบันทึก จะแสดงด้วยสีที่แตกต่างกันใน Visual Studio เพื่อให้คุณสามารถระบุได้อย่างง่ายดาย

แก้ไขส่วนประกอบของตัวแทน

หัวข้อ

หัวข้อ กําหนดโฟลว์การสนทนาและกล่องโต้ตอบ สิ่งเหล่านี้เป็นชนิดของ AdaptiveDialog.

คุณสามารถใช้ GitHub Copilot หรือตัวแทนอื่น เพื่อช่วยสร้างคอมโพเนนต์ new หรือถ้าคุณต้องการ เขียนหัวข้อของคุณเอง

โครงสร้างไฟล์หัวข้อ

นี่คือตัวอย่างของหัวข้อทักทายง่ายๆ:

# This is the name of the topic that will appear in the 'topics' list in Copilot Studio
kind: AdaptiveDialog
beginDialog:
  kind: OnConversationStart
  id: main
  actions:
    - kind: SendActivity
      id: sendMessage_M0LuhV
      activity:
        text:
          - Hello, I'm {System.Bot.Name}. How can I help?
        speak:
          - Hello and thank you for calling {System.Bot.Name}.

คุณลักษณะหัวข้อขั้นสูง

คุณสามารถใช้คอมโพเนนต์อื่นๆ ในหัวข้อต่างๆ เช่น:

• เอนทิตี:

              - kind: Question
                id: question_1
                alwaysPrompt: true
                variable: init:Topic.Continue
                prompt: Can I help with anything else?
                entity: BooleanPrebuiltEntity
  

• ตัวแปร:

    actions:
      - kind: Question
        id: 41d42054-d4cb-4e90-b922-2b16b37fe379
        conversationOutcome: ResolvedImplied
        alwaysPrompt: true
        variable: init:Topic.SurveyResponse
        prompt: Did that answer your question?
        entity: BooleanPrebuiltEntity
  

• เงื่อนไข การใช้ Power Fx:

              - kind: ConditionGroup
                id: condition-1
                conditions:
                  - id: condition-1-item-0
                    condition: =Topic.Continue = true
                    actions:
                      - kind: SendActivity
                        id: sendMessage_4eOE6h
                        activity: Go ahead. I'm listening.
  

• โหนดอื่นๆ เช่น โหนด HTTP

• บัตรการปรับเปลี่ยนได้ (Adaptive Cards)

เครื่องมือ

เครื่องมือกําหนดการดําเนินการที่เจ้าหน้าที่ของคุณสามารถดําเนินการได้ คุณสามารถดูส่วนเหล่านั้นได้ในพื้นที่ Tools ของ Copilot Studio Agent UI

เครื่องมือ อาจรวมถึง:

• พร้อมท์
• เวิร์กโฟลว์ (โฟลว์ Power Automate)
• เครื่องมือ CUA
• ตัวเชื่อมต่อแบบกำหนดเอง
• REST API
• ตัวเชื่อมต่อ MCP

เครื่องมือจะปรากฏภายในส่วนขยายภายใต้โฟลเดอร์ของ /actions ตัวแทน แต่อาจปรากฏในโฟลเดอร์อื่นๆ ที่มีข้อมูลเมตาเพิ่มเติม ตัวอย่างเช่น เวิร์กโฟลว์ และ ทริกเกอร์มี โฟลเดอร์และ JSON ของตัวเอง

แก้ไขทริกเกอร์

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

kind: ExternalTriggerConfiguration
externalTriggerSource:
  kind: WorkflowExternalTrigger

จัดการไฟล์ความรู้ระยะไกล

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

หากคุณต้องการอัปโหลดไฟล์ใหม่ คุณสามารถใส่ไฟล์เหล่านั้นไว้ใน knowledge/files โฟลเดอร์ในข้อกําหนดของตัวแทน เมื่อคุณใช้การเปลี่ยนแปลงเหล่านั้น การเปลี่ยนแปลงเหล่านั้นจะถูกอัปโหลดผ่านคุณลักษณะการอัปโหลดเนื้อหาของตัวแทน

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

หลักการตั้งชื่อ

ไฟล์:

• ใช้ kebab-case: create-ticket.tool.yaml
• อธิบาย: product-pricing-faq.yaml ไม่ใช่ faq.yaml
• ใช้คําต่อท้ายประเภท: .topic.yaml, .tool.yaml, .trigger.yaml

รหัสและตัวแปร:

• ใช้ camelCase: userOrderNumber, productDetails
• อธิบาย: checkPaymentStatus ไม่ใช่ check1
• หลีกเลี่ยงตัวย่อ: customerEmail ไม่ใช่ custEmail

ความคิดเห็น

หากต้องการอธิบายตรรกะที่ซับซ้อน ให้เพิ่มความคิดเห็น:

nodes:
  # Check if user is within business hours and eligible for live support
  # Business hours: 9 AM - 5 PM EST, Monday-Friday
  # Eligibility: Premium tier customers only
  - id: check-live-support-availability
    type: condition

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

ตอนนี้คุณเข้าใจการแก้ไขแล้ว:

• เรียนรู้เกี่ยวกับการซิงโครไนซ์