Byg plugins til Copilot Cowork

Microsoft Copilot Cowork understøtter udvidelse via M365-apppakker – den samme distributionsmekanisme, der bruges af Teams-apps, Copilot-agenter og Office-tilføjelsesprogrammer. Du kan udvide Cowork med:

• Færdigheder: Promptbaserede arbejdsprocesser, der lærer Cowork ny domæneekspertise, f.eks. finansiel analyse, juridisk forskning eller HR-arbejdsprocesser.
• Forbindelser: Fjernservere, der giver Cowork adgang til eksterne datakilder og API'er.

Begge er pakket sammen i en standard Microsoft 365 app-pakke og distribueret via Microsoft 365 App Store.

Hvad du bygger

Et Cowork-plugin er en .zip pakke, der indeholder:

my-extension.zip
├── manifest.json          # M365 Unified App Manifest (v1.28)
├── color.png              # 192×192 full-color app icon
├── outline.png            # 32×32 outline icon
└── skills/                # Agent Skills (SKILL.md files)
    ├── skill-one/
    │   ├── SKILL.md
    │   └── references/    # Optional deep-dive docs
    └── skill-two/
        └── SKILL.md

Færdigheder bruger agentfærdighederne åben standard – det samme format, der understøttes af Claude Code, Visual Studio Code Copilot, Gemini CLI, Cursor, JetBrains Junie og 30+ andre værktøjer med kunstig intelligens.

Vælg dit udgangspunkt

Importér et eksisterende plugin

Hvis du allerede har et Claude Code- eller markør-plugin med færdigheder og MCP-servere, importerer Microsoft 365 Agents Toolkit CLI detatk () det direkte. CLI kører på Windows, macOS og Linux.

1. Installér CLI (kræver version 1.1.12 eller nyere):

   npm install -g @microsoft/m365agentstoolkit-cli
   

2. Kontrollér versionen:

   atk --version
   

3. Importer dit plugin:

   atk import openplugin --path ./my-claude-plugin --output ./my-plugin-project \
     --privacy-url https://contoso.com/privacy \
     --terms-url https://contoso.com/terms
   

Kommandoen læser dit plugins .claude-plugin/plugin.json (eller .cursor-plugin/plugin.json), .mcp.jsonog skills/ mappe og stilladser derefter et Agents Toolkit-projekt, der indeholder appPackage/manifest.jsondine færdigheder og genererede ikoner.

Du skal medtage --privacy-url , og --terms-url fordi plugin-manifester ikke har tilsvarende felter, og Microsoft 365-manifestet kræver begge dele.

Pak resultatet i et uploadbart .zip:

cd my-plugin-project
atk package --manifest-file ./appPackage/manifest.json \
  --output-package-file ./appPackage/build/appPackage.zip \
  --output-folder ./appPackage/build

Hvad der importeres?

Hvad konverteres ikke

Følgende Claude-plug-in-funktioner understøttes endnu ikke i Microsoft 365-manifestet:

Indstillinger for import

Automatisk registrering af godkendelsestype:

Hvis den automatiske registrering ikke svarer til din konfiguration, kan du tilsidesætte --default-auth-type den.

Eksportere tilbage til en plugin-mappe

Hvis du vil flytte et Agents Toolkit-projekt tilbage til en plug-in-mappe – for eksempel for at holde et Claude Code-plugin og en Cowork-pakke synkroniseret – skal du brugeatk export openplugin:

atk export openplugin --path ./my-plugin-project \
  --output ./my-claude-plugin --manifest-kind claude-plugin

Eksportér skriver en x-microsoft-365-agents-toolkit blok til det genererede plugin.json. Denne blok indeholder manifestet id, udvikler-URL-adresser og forbindelsesindstillinger, så en senere atk import openplugin rundkørsel uden behov --privacy-url--terms-url eller igen.

Ældre: PowerShell-konverteringsscript

Før atk den understøttede plug-in-import, brugte konvertering et PowerShell-script, der kun er tilgængeligt som konverteringsscript:

.\Convert-ClaudePluginToMOS3.ps1 -PluginPath ./my-claude-plugin -OutputPath ./output

Brug atk import openplugin i stedet. Det er på tværs af platforme, understøtter markører såvel som Claude Code-kilder og kan eksportere tilbage til en plugin-mappe.

Byg et plugin fra bunden

Følg disse trin for at oprette en plugin-pakke fra bunden, startende med din første færdighed og opbygning til en komplet, publicerbar pakke.

Trin 1: Opret din første færdighed

En færdighed er en mappe, der indeholder en SKILL.md fil. Opret følgende mappestruktur:

my-extension/
└── skills/
    └── contract-analysis/
        └── SKILL.md

Skriv SKILL.md med YAML-frontsag og en Markdown-brødtekst:

---
name: contract-analysis
description: |
  Analyzes contracts for key terms, risks, and obligations.
  Use when user asks to "review this contract", "find the liability clause",
  "summarize the key terms", or "compare these two agreements".
license: MIT
metadata:
  author: Contoso Legal Tech
  version: "1.0"
---

# Contract Analysis

## What This Skill Does

Guides Cowork through systematic contract review, identifying:
- Key commercial terms (pricing, payment, renewal)
- Risk clauses (indemnification, limitation of liability, IP)
- Obligations and deadlines
- Non-standard or unusual provisions

## Workflow

1. Read the uploaded contract document
2. Extract and categorize all clauses
3. Flag risk areas with severity ratings
4. Generate a structured summary with recommendations

## Output Format

Present findings in a structured table:

| Clause | Category | Risk Level | Summary |
|--------|----------|------------|---------|
| Section 4.2-Indemnification | Risk | High | Unlimited indemnification for IP claims |
| Section 7.1-Term | Commercial | Low | 12-month auto-renewal with 30-day notice |

SKILL.md frontmatter-felter

Obligatoriske felter:

Navngivningsregler (kebab-kasus): Brug kun små alfanumeriske tegn og bindestreger. Brug ikke fortløbende bindestreger, og brug ikke foranstillede eller efterstillede bindestreger.

Trin 2: Tilføje referencematerialer (valgfrit)

For komplekse færdigheder skal du sørge for, at hovedfilen SKILL.md er slank, og flytte detaljeret indhold til undermapper. Disse ekstra filer er ledsagerfiler. Færdigheden indlæser dem, når det er nødvendigt.

skills/
└── contract-analysis/
    ├── SKILL.md               # Core workflow (~1,500-2,000 words ideal)
    ├── references/            # Deep-dive docs loaded on demand
    │   ├── clause-taxonomy.md
    │   └── risk-scoring.md
    └── scripts/               # Executable utilities
        └── extract-clauses.py

Begrænsninger for ledsagende filer

Hver færdighed kan indeholde op til 20 ledsagende filer (alle andre filer end SKILL.md). Der gælder følgende begrænsninger pr. færdighed:

Regler for ledsagende filer

Ledsagende filstier skal følge disse regler:

• Brug kun relative stier (ingen absolutte stier)
• Ingen stigennemgang (.. segmenter)
• Ingen omvendte skråstreger eller null bytes i filnavne
• Ingen skjulte filer (navne, der begynder med .)
• Ingen reserverede Windows-navne (CON, PRN, AUX, COM1NUL, –COM9, –LPT9) LPT1
• Selve filen SKILL.md tæller ikke som en ledsagerfil
• Filnavne skal bruge sikre tegn: alfanumerisk, bindestreger, understregningstegn, prikker, mellemrum og !

For at holde kontekstvinduet effektivt indlæser systemet færdigheder i tre lag:

Referer eksplicit til undermapperne, SKILL.md så agenten ved, at de findes:

## Additional Resources

- **`references/clause-taxonomy.md`**-Full taxonomy of contract clause types
- **`references/risk-scoring.md`**-Risk scoring methodology and thresholds
- **`scripts/extract-clauses.py`**-Automated clause extraction utility

Trin 3: Tilføj en forbindelse (valgfrit)

Hvis din udvidelse skal have adgang til eksterne data, skal du tilføje en ekstern MCP-server. Dette trin er valgfrit. Pakker kun med færdigheder fungerer godt til promptbaserede arbejdsprocesser.

Krav til forbindelse

Retningslinjer for værktøjsdesign

• Ét værktøj pr. handling til små API'er (færre end 15 handlinger): search_case_law, get_ruling, cite_precedent
• Søg + udfør for store API'er (50+ handlinger): search_actions + execute_action
• Beskrivende navne: get_bond_price ikke getData
• Omfattende inputskemaer: Medtag en beskrivelse af hver parameter – det er, hvad agenten læser
• Struktureret output: Returner JSON, som agenten kan formatere for brugeren
• Filinput: Hvis du vil acceptere en fil fra brugerens arbejdsområde, skal du erklære parameteren med contentEncoding: base64. Få mere at vide i Acceptér filer fra Cowork-arbejdsområdet.

Beskriv din forbindelses værktøjer (mcpToolDescription)

Hver remoteMcpServer forbindelse skal indeholde et mcpToolDescription objekt. Dens indlejrede file egenskab peger på en værktøjsbeskrivelses-JSON-fil, som du pakker i din .zip og refererer til ved en relativ sti fra pakkeroden. Hvis du udelader mcpToolDescription, afviser pakketjenesten uploadet med en HTTP 400-fejl:

Påkrævede egenskaber mangler for objektet: mcpToolDescription.

"remoteMcpServer": {
  "mcpServerUrl": "https://api.contoso.com/legal/mcp",
  "mcpToolDescription": {
    "file": "./tools/contoso-legal-tools.json"
  },
  "authorization": {
    "type": "OAuthPluginVault",
    "referenceId": "A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u"
  }
}

Den fil, der refereres til (for eksempel, ) beskriver de værktøjer, som forbindelseskomponenten fremviser, tools/contoso-legal-tools.jsonog som skal være til stede i ZIP-pakken. Medtag det sammen med din manifest.json og-mappe skills/ , når du pakker plugin'et.

Understøttede godkendelsestyper

For OAuthPluginVault og ApiKeyPluginVault, peger referenceId på legitimationsoplysninger, der er gemt i Microsoft Enterprise Token Store – hemmeligheder vises aldrig i manifest- eller færdighedsfilerne. Værdien referenceId er registrerings-id'et for OAuth-klienten, som du opretter, når du registrerer en OAuth-klient med Agents Toolkit.

MCP-godkendelse

Hvis du vil bruge OAuth eller ApiKey til godkendelse, skal du se Konfigurer godkendelse for MCP- og API-plug-ins i agenter i Microsoft 365 Copilot for at få oplysninger om konfiguration og konfiguration.

Dynamisk klientregistrering

Hvis din MCP-server understøtter Dynamisk klientregistrering (DCR), kan du udelade en authentication konfiguration fra din forbindelsesdefinition, og Cowork opretter automatisk en OAuth-klient på dit plug-ins vegne.

Du kan udelade objektet authorization , men du skal stadig medtage mcpToolDescriptiondet. Konfigurer din MCP-server-URL og værktøjsbeskrivelse, så tager Cowork sig af OAuth-klienten:

"remoteMcpServer": {
  "mcpServerUrl": "https://api.contoso.com/legal/mcp",
  "mcpToolDescription": {
    "file": "./tools/contoso-legal-tools.json"
  }
}

Trin 4: Opret manifestet

Opret manifest.json i din pakkerod:

{
  "$schema": "https://developer.microsoft.com/json-schemas/teams/v1.28/MicrosoftTeams.schema.json",
  "manifestVersion": "1.28",
  "version": "1.0.0",
  "id": "YOUR-GUID-HERE",
  "developer": {
    "name": "Contoso Legal Tech",
    "websiteUrl": "https://contoso.com",
    "privacyUrl": "https://contoso.com/privacy",
    "termsOfUseUrl": "https://contoso.com/terms"
  },
  "name": {
    "short": "Contoso Legal Tools",
    "full": "Contoso Legal Tools for Copilot Cowork"
  },
  "description": {
    "short": "Contract analysis, clause extraction, and legal research",
    "full": "Comprehensive legal tools for Copilot Cowork including contract analysis, clause extraction, risk assessment, and legal research capabilities."
  },
  "icons": {
    "color": "color.png",
    "outline": "outline.png"
  },
  "accentColor": "#2B579A",
  "agentSkills": [
    { "folder": "./skills/contract-analysis" }
  ]
}

Hvis du vil tilføje en forbindelse, skal du inkludere agentConnectors:

{
  "agentConnectors": [
    {
      "id": "contoso-legal-api",
      "displayName": "Contoso Legal Database",
      "description": "Access to case law, statutes, and regulatory databases",
      "toolSource": {
        "remoteMcpServer": {
          "mcpServerUrl": "https://api.contoso.com/legal/mcp",
          "mcpToolDescription": {
            "file": "./tools/contoso-legal-tools.json"
          },
          "authorization": {
            "type": "OAuthPluginVault",
            "referenceId": "A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u"
          }
        }
      }
    }
  ]
}

I forbindelseskonfigurationen referenceId skal det være OAuth-registrerings-id'et, og mcpToolDescription.file skal pege på en JSON-fil med beskrivelsen af værktøjet, som er inkluderet i ZIP-pakken.

Trin 5: Tilføj ikoner

Opret to PNG-ikoner:

Hvis du endnu ikke har ikoner, atk import openplugin genereres pladsholdere i dækkende farver. Udskift dem før indsendelse af Store.

Trin 6: Pakke

Opret en ZIP-fil med alt indhold på rodniveau:

contoso-legal-tools.zip
├── manifest.json
├── color.png
├── outline.png
├── tools/
│   └── contoso-legal-tools.json   # Referenced by mcpToolDescription (connectors only)
└── skills/
    └── contract-analysis/
        ├── SKILL.md
        └── references/
            └── clause-taxonomy.md

Hvis pakken indeholder en agentConnectors post, skal du medtage JSON-filen med værktøjsbeskrivelsen, som refereres til af mcpToolDescription.file. Pakker, der kun gælder færdigheder, behøver ikke en tools/ mappe.

Windows (PowerShell):

Compress-Archive -Path manifest.json, color.png, outline.png, tools, skills -DestinationPath contoso-legal-tools.zip

macOS/Linux:

zip -r contoso-legal-tools.zip manifest.json color.png outline.png tools/ skills/

Brug af Microsoft 365 Agents Toolkit

 atk package --manifest-file ./appPackage/manifest.json \
       --output-package-file ./appPackage/build/appPackage.zip \
       --output-folder ./appPackage/build

Trin 7: Test

Hvis du vil teste din app, skal du uploade din app-pakke til Teams, som beskrevet i Upload din app til Teams.

Til personlig test skal du indlæse appen ved hjælp af Microsoft 365 Agents Toolkit-kommandolinjegrænsefladen:

1. Installér @microsoft/m365agentstoolkit-cli fra npm:

   npm install -g @microsoft/m365agentstoolkit-cli
   

2. Kontrollér installationen ved at køre:

   atk --version
   

3. Godkend med din Microsoft 365-arbejdskonto:

   atk auth login
   

4. Log på din arbejdskonto, og installér agentpakken. Erstat filstien med ZIP-pakkens placering:

   atk install --file-path "C:/Users/myuser/myPackage.zip" --scope Personal
   

   En vellykket installation returnerer output, der indeholder et TitleId og AppId for din konto.

5. Gem disse id'er til senere brug, når du opdaterer eller fjerner.

Få mere at vide i Microsoft 365 Agents Toolkit-kommandolinjegrænsefladen.

Trin 8: Publicer til din lejer

1. Åbn M365 Administration>Administrer apps>Upload brugerdefineret app.
2. Vælg ellipseknappen (...) >Tilføj agent.
3. Upload din .zip pakke.
4. ÅbnpluginsCowork>kilder & færdigheder>. Dit plugin vises i sektionen Opdag .

Trin 9: Publicere til offentligheden

For plug-ins, der er beregnet til offentlig distribution, skal du sende dit plug-in til Microsoft 365 App Store via Partnercenter. Få mere at vide i Publicer agenter til Microsoft 365 Copilot.

Test en forbindelse mod en lokal MCP-server

Forbindelser kræver en HTTPS, mcpServerUrlså hvis du vil teste en server, der kører på din computer, skal du eksponere den over en offentlig HTTPS URL-adresse. Udviklingstunneller leverer et relæ, der afslutter TLS for dig.

devtunnel port create <tunnel> -p <port> --protocol http

Fejlfinding

Emballagemønstre

Vælg det mønster, der passer til din udvidelse:

Kun færdigheder (ingen forbindelse)

Bedst til promptbaserede arbejdsprocesser, dokumentanalyse og skrivehjælp.

my-skills-pack.zip
├── manifest.json          # agentSkills only, no agentConnectors
├── color.png
├── outline.png
└── skills/
    ├── skill-one/SKILL.md
    └── skill-two/SKILL.md

Færdigheder + fjernforbindelse

Bedst til dataanalyse, API-integrationer og virksomhedssystemer.

my-data-skills.zip
├── manifest.json          # agentSkills + agentConnectors
├── color.png
├── outline.png
├── tools/                 # Tool-description file(s) for mcpToolDescription
│   └── my-connector.json
└── skills/
    ├── analysis-workflow/SKILL.md
    └── reporting-workflow/SKILL.md

Kun forbindelse (ingen brugerdefinerede færdigheder)

Brug denne indstilling til datakilder, som Cowork indbyggede færdigheder allerede kan bruge.

my-connector.zip
├── manifest.json          # agentConnectors only, no agentSkills
├── color.png
├── outline.png
└── tools/                 # Tool-description file(s) for mcpToolDescription
    └── my-connector.json

Importeret Claude-kode eller markør-plugin

Brug denne indstilling til eksisterende plugins fra andre værktøjer med kunstig intelligens, der er målrettet Cowork.

atk import openplugin --path ./claude-plugin --output ./my-plugin-project \
  --privacy-url https://contoso.com/privacy \
  --terms-url https://contoso.com/terms

Bedste praksis for oprettelse af færdigheder

Følg disse retningslinjer for at oprette færdigheder, der aktiveres pålideligt og giver ensartede resultater.

Skriv effektive beskrivelser

Feltet description bestemmer, hvornår agenten aktiverer din færdighed. Vær specifik:

# Good-specific trigger phrases, concrete scenarios
description: |
  Analyzes bond relative value using Z-spreads, ASW spreads, and butterfly analysis.
  Use when user asks to "analyze bond spreads", "compare bonds",
  "rich-cheap analysis", "relative value", or "Z-spread calculation".

# Bad-vague, no trigger phrases
description: Provides bond analytics capabilities.

Skriv effektive arbejdsprocesser

• Vær specifik i beskrivelsen. Medtag udløserudtryk: "Brug når brugeren beder om..." Denne beskrivelse er, hvordan agenten beslutter, hvilken færdighed der skal aktiveres.
• Struktur som en arbejdsproces. Nummerering af trin. Hvert trin skal knyttes til en konkret handling (læse en fil, kalde et værktøj, generere output).
• Definer outputformat. Vis den nøjagtige tabel-, liste- eller dokumentstruktur, som brugerne kan forvente. Denne definition forbedrer konsistensen markant.
• Referenceværktøjer efter navn. Hvis dine færdigheder afhænger af forbindelsesværktøjer, skal du navngive dem eksplicit: "Brug værktøjet search_case_law til at..."
• Hold de vigtigste SKILL.md slanke. Flyt detaljeret referencemateriale til references/ undermappen. Færdighedskroppen bør være arbejdsgangen, ikke en encyklopædi.

Undgå almindelige fejl

• Integrer ikke hemmeligheder i SKILL.md filer. Brug agentConnectors med godkendelse til API-legitimationsoplysninger.
• Dupliker ikke indbyggede færdigheder. Tjek den indbyggede færdighedsliste, før du bygger.
• Gør ikke færdighederne for brede. "Gør alt med juridiske dokumenter" er værre end specifikke færdigheder til "kontraktanalyse", "klausuludtrækning" og "juridisk forskning".
• Undlad at uddybe filstier eller systemkommandoer. Færdigheder skal være bærbare på tværs af miljøer.
• Læg ikke alt i SKILL.md. Hvis din krop overstiger ~3.000 ord, kan du flytte detaljeret indhold til references/.

Valideringsregler

Når du indsender din pakke, validerer platformen den på flere niveauer. Ret disse fejl før indsendelse for at undgå afvisning.

Validering på manifestniveau

Validering på pakkeniveau

Validering af forbindelse

Validering af ledsagende fil

Portalen validerer ledsagende filer (referencematerialer, scripts og andre filer sammen med SKILL.mdhinanden) på upload- og synkroniseringstidspunktet:

Kompatibilitet på tværs af platforme

Færdigheder bruger den åbne standard Agentfærdigheder. De samme SKILL.md filer fungerer på tværs af flere værktøjer med kunstig intelligens:

Hvis du udvikler færdigheder til både Claude Code og Cowork, skal du starte med Claude Code-plugin-strukturen - det er supersættet:

my-plugin/
├── .claude-plugin/
│   └── plugin.json        # Claude plugin manifest
├── skills/
│   ├── skill-one/
│   │   ├── SKILL.md       # Works in both Claude Code AND M365
│   │   └── references/
│   └── skill-two/
│       └── SKILL.md
└── .mcp.json              # MCP server config (optional)

Importér den derefter til et M365-projekt, når du er klar til at publicere til Microsoft 365 App Store:

atk import openplugin --path ./my-plugin --output ./my-plugin-project \
  --privacy-url https://contoso.com/privacy \
  --terms-url https://contoso.com/terms

Administration af MCP-anmærkninger og bekræftelser

Copilot Cowork læser standard MCP-objektet annotations på værktøjer, som din server returnerer fratools/list, og bruger det til at beslutte, om et værktøjskald har brug for brugerbekræftelse, og hvilken etiket der skal vises på prompten.

Tilgængelige felter

Bekræftelsesregler

Bekræftelse er påkrævet, hvis readOnlyHint == false eller destructiveHint == true.

Alle værktøjer skal have sikkerhedsanmærkninger angivet. Værktøjer uden anmærkninger behandles som destruktive og kræver bekræftelse. Få mere at vide i MCP-skemareferencen.

Eksempler på MCP

En destruktiv handling med et brugervenligt mærkat:

{
  "name": "send_email",
  "description": "Send an email message.",
  "annotations": {
    "title": "Send Email",
    "destructiveHint": true
  },
  "inputSchema": { ... }
}

En sikker læsning, der kører automatisk:

{
  "name": "search_docs",
  "annotations": {
    "title": "Search Documents",
    "readOnlyHint": true
  }
}

Hvad er tilgængeligt nu

• Microsoft-værktøjer (Graph, Dataverse og andre) er afgrænset af Cowork's indbyggede politik uanset anmærkninger.
• For MCP-servere, der ikke er fra Microsoft, udrulles annotationsdrevet bekræftelse gradvist. Angivelse af tip nu er fremadkompatibel, og en bekræftelse vises, når udrulningen udvides, uden at der kræves nogen udviklerændringer.

Acceptér filer fra Cowork-arbejdsområdet

Et forbindelsesværktøj kan tage en fil fra brugerens Cowork-session som input – et dokument, som brugeren har vedhæftet, en vedhæftet fil i en mail, som Cowork har gemt, eller en fil, som et tidligere trin har produceret. Deklarer parameteren med standardnøgleordet contentEncoding: base64 JSON Schema, og Cowork håndterer resten. Der kræves ingen Microsoft-specifik skemaudvidelse, og serverens API-overflade ændres ikke.

Cowork løser arbejdsområdefilen og base64-koder den, før du kalder din server, så filbytes aldrig kommer ind i agentens kontekst. Agenten kan kun se og udsende filstier til arbejdsområdet.

Definer en filparameter

En strengegenskab, der contentEncoding: base64 genkendes som et filinput:

{
  "name": "analyze_contract",
  "description": "Extract key terms from a contract document.",
  "annotations": {
    "title": "Analyze Contract",
    "readOnlyHint": true
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "document": {
        "type": "string",
        "contentEncoding": "base64",
        "description": "The contract file to analyze."
      },
      "jurisdiction": {
        "type": "string",
        "description": "Two-letter country code governing the contract."
      }
    },
    "required": ["document"]
  }
}

En matrix af sådanne strenge genkendes også for værktøjer, der accepterer flere filer:

"attachments": {
  "type": "array",
  "items": { "type": "string", "contentEncoding": "base64" },
  "description": "Receipt images to attach to the expense line."
}

Hvad mægleren ser

For filparametre, der er deklareret på det øverste niveau af inputSchema.properties, erstatter Cowork dem i det modelviste skema med en enkelt direct_attachment_file_paths matrix – den samme parameter, som Cowork indbyggede værktøjer bruger, så agenten ved allerede, hvordan den skal udfyldes. Skemaet ovenfor præsenteres for agenten som:

{
  "type": "object",
  "properties": {
    "direct_attachment_file_paths": {
      "type": "array",
      "items": { "type": "string" },
      "description": "Workspace file paths to attach."
    },
    "jurisdiction": { "type": "string" }
  }
}

Hvis værktøjet erklærer mere end én filparameter på øverste niveau, kollapses de alle sammen i denne enkelt direct_attachment_file_paths matrix. På kaldstidspunktet blæser Cowork de løste filer tilbage til dine oprindelige parameternavne i erklæringsrækkefølgen.

Parametre for indlejrede filer

En filparameter, der er indlejret i et objekt eller en række objekter, understøttes også, og den håndteres anderledes: I stedet for at blive skjult omskrives den til en stistreng på sin egen placering. Dette bevarer tilknytningen mellem en fil og dens sidestillede felter – f.eks. én kvittering pr. udgiftslinje:

"line_items": {
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "amount": { "type": "number" },
      "receipt": { "type": "string", "contentEncoding": "base64" }
    }
  }
}

Agenten udfyldes line_items[].receipt med en arbejdsområdesti, og Cowork bytter hver sti for base64-indhold på stedet, før opkaldet viderestilles.

Indlejringen gennemskæres til en dybde på fire niveauer under toppen af inputSchema. $ref Markører følges ikke – definer filparametre indbygget i stedet for bag en $ref.

Hvad din server modtager

Din server modtager en ordinær tools/call med dine oprindelige parameternavne udfyldt med base64-kodet indhold:

{
  "method": "tools/call",
  "params": {
    "name": "analyze_contract",
    "arguments": {
      "document": "JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5...",
      "jurisdiction": "US"
    }
  }
}

Din server behøver ikke at vide, at agenten brugte en stibaseret grænseflade, og værktøjer, der ikke erklærer contentEncoding: base64 parametre, påvirkes ikke.

Grænser

Et kald, der overstiger filantallet, eller et størrelsesloft mislykkes med en værktøjsfejl og når aldrig frem til serveren. Tilpas størrelsen på din API og dens timeouts med loftet på 150 MB i tankerne: base64 puster nyttedataene op med ca. en tredjedel i forhold til den rå filstørrelse, og det kodede indhold sendes i JSON-RPC-anmodningens brødtekst.

Anbefalinger

• Beskriv parameteren for en menneskelig læser. Agenten bruger beskrivelsen til at afgøre, hvilken fil der hører til i hvilket parameter. Fungerer f.eks. "The signed contract PDF to analyze" bedre end "file".
• Angiv de formater, du accepterer , i parameterbeskrivelsen. Cowork passerer gennem det, som brugeren vedhæfter. Valider indholdstypen på din side, og returner en tydelig værktøjsfejl, hvis den ikke kan bruges.
• Angive anmærkninger. Et værktøj, der modtager en fil og reagerer på den, er normalt ikke skrivebeskyttet, så beder om bekræftelse. Se MCP-anmærknings- og bekræftelsesadministration.
• Hold filparametrene indbygget. En parameter bag en $ref, eller indlejret dybere end fire niveauer, omskrives ikke. Serveren modtager en stistreng, når den forventer indhold.
• Definer højst én matrixfilparameter pr. værktøj. Med to eller flere kan Cowork ikke se, hvilken fil der hører til i hvilken matrix, og kaldet mislykkes med en værktøjsfejl. Brug én matrix eller flere skalarparametre eller en blanding af skalarer og en enkelt matrix.
• Forvent en nøjagtig optælling af skalarværktøjer. Hvis dit værktøj kun erklærer skalarfilparametre, skal antallet af filer, som agenten passerer, svare til det deklarerede antal. Markér valgfrie filparametre tydeligt i deres beskrivelser, så agenten ikke under- eller overforsyning.

Identificer Cowork-trafik til din server

Hvis din MCP-server porter værktøjets synlighed efter klient, eller du vil tilskrive den trafik, den modtager, kan du genkende anmodninger, der kommer fra Cowork. Cowork præsenterer en stabil softwareidentitet på to kanaler:

Forskel på præfikset copilot-cowork

Match præfiksetcopilot-cowork, hvor der ikke skelnes mellem store og små bogstaver, på en af kanalerne. Match ikke den nøjagtige copilot-cowork/1.0 streng eller en bestemt clientInfo.version. Versionen sporer klient-identitetskontrakten og forventes at blive ændret. Et præfiksmatch får din port til at fungere på tværs af versionsbump.

# Correct: case-insensitive prefix match
copilot-cowork

# Incorrect: exact match breaks when the version changes
copilot-cowork/1.0

Vælg den rigtige kanal til din gate

De to kanaler har forskellige områder, så vælg det, der passer til, hvordan serveren gennemtvinger sin gate:

• Sidehovedet User-Agent er til stede på alle anmodninger, herunder tools/list og tools/call. Hvis du gate eller attribut pr. anmodning, skal du trykke på dette hoved.
• clientInfo der kun sendes via håndtrykket initialize . Hvis du porterer pr. session på forbindelsestidspunktet, kan du læse det der, men det gentages ikke ved senere anmodninger.

Hvad identiteten omfatter, og hvad den ikke omfatter

Identiteten navngiver kun softwaren . Det er ens for alle Cowork-brugere og -forbindelser, og det bærer aldrig brugeridentitet. Brugeridentiteten forbliver i det godkendelsesflow, som din forbindelses godkendelseskonfiguration definerer.

Da der ikke er nogen kvalifikator pr. forbindelse, kan du i øjeblikket ikke bruge denne identitet til at se, hvilken forbindelse der har foretaget et kald, eller til at adskille et udgivet Microsoft-plug-in fra en sideloadet server, der peger på den samme URL-adresse. Hvis du har brug for denne sondring, skal du gennemtvinge den via din forbindelses godkendelseskonfiguration i stedet for klientidentiteten.

Almindelige spørgsmål

Kan jeg bruge færdigheder fra M365-pakken i Claude Code?

Ja. Færdighedsmapperne indeholder standardagentfærdigheder. Kopier dem til .claude/skills/ et hvilket som helst Claude Code-projekt, eller kør atk export openplugin for at konvertere hele projektet tilbage til et Claude Code-plugin.

Har jeg brug for et fjernstik?

Nej. Pakker kun med færdigheder fungerer godt til promptbaserede arbejdsprocesser. Forbindelser er kun nødvendige, når dine færdigheder kræver live-data fra et eksternt system.

Hvordan adskiller plugin-færdigheder sig fra indbyggede færdigheder?

Plug-in-færdigheder vises med kilden "package" i API'en. De kan ikke tilsidesætte indbyggede færdigheder med samme navn. Administrer-installerede pakker viser isAdminDeployed: true.

Kan it-administratorer styre, hvilke plug-ins der er tilgængelige?

Ja. Standard M365-administratorkontrolelementer gælder: tilladelses-/blokeringslister på lejerniveau, administratoradministrerede udrulninger og overholdelsespolitikker.

Hvad sker der, hvis et plugin tilbagekaldes?

I den næste synkroniseringscyklus fjernes færdigheder og forbindelser fra den pågældende pakke fra brugerens session. Aktive samtaler bliver ikke afbrudt, men nye sessioner har ikke pakkens egenskaber.

Hvad er det maksimale antal færdigheder pr. pakke?

Tyve (20) færdigheder (ifølge ASKILL-M002). For forbindelser er grænsen 10 pr. pakke.

Kan færdigheder henvise til forbindelsesværktøjer fra den samme pakke?

Ja, og det bør de. Navngiv værktøjerne eksplicit i SKILL.md arbejdsprocessen (f.eks. "Brug værktøjet search_case_law til at..."). Agenten forbinder dem på kørselstidspunktet.

Kan værktøjerne i mit plugin acceptere filer fra Cowork-arbejdsområdet?

Ja. Deklarer værktøjsparameteren med contentEncoding: base64, så løser Cowork brugerens arbejdsområdefil til base64-indhold, før serveren kaldes. Modellen overfører filstier, ikke filindhold, så store filer forbruger ikke modellens kontekst. Du kan finde oplysninger om og begrænsninger for erklæringer ved at læse mere i Acceptér filer fra Cowork-arbejdsområdet.

Hvordan genererer jeg et deterministisk GUID for min pakke?

atk import openplugin bruger UUID v5 (SHA-1-baseret) fra dit plug-in-navn. Hvis du kører importen to gange, returneres det samme GUID. Hvis du vil angive dine egne, skal du bestå --app-id. Brug en GUID-generator til manuel emballering. Sørg for at holde den stabil på tværs af versioner.

Relateret indhold

• Cowork oversigt
• Brug Cowork
• Administrer Cowork for din organisation
• Administrer plugins til Cowork