Redigera din Microsoft Copilot Studio-agent i Microsoft Visual Studio Code

När du klonar Microsoft Copilot Studio agenten till den lokala datorn kan du redigera dess komponenter med hjälp av Microsoft Visual Studio Code textredigeringsfunktioner. Tillägget Copilot Studio ger intelliSense-, validerings- och YAML-språkstöd för att göra redigeringen effektiv och felfri.

Agentfilstruktur

Att förstå filstrukturen är nyckeln till effektiv redigering.

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

Redigera huvudagentens konfiguration

IntelliSense-funktioner

När du skriver visas förslag och ogiltiga värden markeras. Dessa förslag varierar beroende på vilken nivå av nod du är på.

• Använd Ctrl+Space den för att få förslag baserat på nodens nivå.
• Använd Ctrl+F den för att söka efter variabelnamn och annan information över hela din agent för att snabbt uppdatera

Visningsproblem

Du kan visa problem med filer i fönstret Problems i Visual Studio Code. Dessutom, när du öppnar en fil kan du se en röd understrykning som identifierar problem.

Problempanel

1. Använd Ctrl+Shift+M för att öppna panelen Problemen (eller gå till Visa>problem).

2. Se alla fel och varningar.

3. Välj vilket problem som helst för att hoppa till platsen.

Att arbeta med förändringar

När en ändring görs och sparas visas den i en annan färg i Visual Studio så att du enkelt kan identifiera den.

Redigeringsagentkomponenter

Topics

Ämnen definierar samtalsflöden och dialoger. De är en typ av AdaptiveDialog.

Du kan använda GitHub Copilot eller andra agenter för att skapa nya komponenter, eller, om du vill, skriva egna ämnen.

Ämnesmappstruktur

Här är ett exempel på ett enkelt hälsningsämne:

# 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}.

Avancerade ämnesfunktioner

Du kan använda andra komponenter i ämnen som:

• Företag:

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

• Variabler:

    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
  

• Villkor med 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.
  

• Andra noder, till exempel HTTP-noder

• Adaptiva kort

Tools

Verktyg definierar handlingar som din agent kan utföra. Du kan se dem i området Tools i användargränssnittet för Copilot Studio Agent.

Verktyg kan inkludera:

• Uppmaningar
• Arbetsflöden för Power Automate
• CUA-verktyg
• Anpassade kopplingar
• REST-API:er
• MCP-kontakter

Verktyg visas i tillägget under en agents /actions mapp men kan också finnas i andra mappar med extra metadata. Till exempel har arbetsflöden och triggers egna mappar och JSON.

Redigera utlösare

Triggers avgör när ämnen eller handlingar aktiveras. Du kan ställa in dem som scheman, händelser eller villkorstyper. Triggers refererar vanligtvis till ett arbetsflöde.

kind: ExternalTriggerConfiguration
externalTriggerSource:
  kind: WorkflowExternalTrigger

Hantera fjärrkunskapsfiler

Om du laddar upp dokument med uppladdningsfunktionen i Copilot Studio kan du ladda ned dokumenten genom att klicka på namnet i fönstret Remote Knowledge Files. Dokumenten laddas inte ner automatiskt utan måste väljas för nedladdning i fönstret. Du ser en notis när nedladdningen lyckas.

Om du vill ladda upp nya filer kan du lägga dem i knowledge/files mappen i agentdefinitionen. När du gör dessa ändringar laddas de upp via funktionen för uppladdning av agentinnehåll.

Regelverk

Namngivningskonventioner

Filer:

• Använd kebab-case: create-ticket.tool.yaml
• Var beskrivande: product-pricing-faq.yaml inte faq.yaml
• Använd typsuffixet: .topic.yaml, .tool.yaml, .trigger.yaml

ID:n och variabler:

• Använd camelCase: userOrderNumber, productDetails
• Var beskrivande: checkPaymentStatus inte check1
• Undvik förkortningar: customerEmail not custEmail

Comments

För att förklara komplex logik, lägg till kommentarer:

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

Nästa steg

Nu när du förstår redigering:

• Lär dig om synkronisering.