Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
[Denne artikel er foreløbig dokumentation og kan ændres.]
Vigtigt!
- Du skal være en del af Frontier-prøveversionsprogrammet for at få tidlig adgang til Microsoft 365 Copilot Cowork. Frontier forbinder dig direkte med Microsofts seneste AI-innovationer. Grænseeksempler er underlagt de eksisterende prøveversionsbetingelser i dine kundeaftaler. Da disse funktioner stadig er under udvikling, kan deres tilgængelighed og funktioner ændre sig over tid.
- Hvis Cowork ikke er synlig i Administration af Center Agent i Microsoft Administration, skal du sørge for, at administratorkontoen også er tilmeldt Frontier (Copilot –> Indstillinger –> Frontier).
- Dette er en prøveversionsfunktion.
- Prøveversionsfunktioner kan have begrænset funktionalitet. Disse funktioner er tilgængelige før en officiel version, så kunderne kan få tidlig adgang og give feedback.
- Du kan få flere oplysninger ved at gå til vores Microsoft-produktvilkår.
Microsoft 365 Copilot Cowork understøtter udvidelse via M365 App Packages – den samme distributionsmekanisme, der bruges af Teams-apps, copilotagenter og Office-tilføjelsesprogrammer. Du kan udvide samarbejdet med:
- Færdigheder: Promptbaserede arbejdsprocesser, der underviser i ny domæneekspertise i samarbejde, f.eks. økonomisk analyse, juridisk forskning eller HR-arbejdsprocesser.
- Connectors: Fjernservere, der giver cowork adgang til eksterne datakilder og API'er.
Begge pakkes sammen i en Microsoft 365-standardapppakke og distribueres via Microsoft 365 App Store.
Det opretter du
En cowork-plug-in 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 brug Agentfærdigheder åbner standardformatet, der understøttes af Claude Code, Visual Studio Code Copilot, Gemini kommandolinjegrænsefladen, markøren, JetBrains Junie og mere end 30 andre AI-værktøjer.
Vælg dit startpunkt
| Udgangspunkt | Sti | Tid til første pakke |
|---|---|---|
| Jeg har en eksisterende Claude Code-plug-in | Konvertér den | Ca. 5 minutter |
| Jeg starter fra bunden | Opret fra bunden | Ca. 30 minutter |
Konvertér en eksisterende Claude-plug-in
Hvis du allerede har en Claude Code-plug-in med færdigheder og MCP-servere, håndterer konverteringsscriptet oversættelsen:
.\Convert-ClaudePluginToMOS3.ps1 -PluginPath ./my-claude-plugin -OutputPath ./output
Dette script læser plug-in'ens .claude-plugin/plugin.json, .mcp.jsonog mappe og skills/ producerer derefter en gyldig M365-pakke .zip med en genereret manifest.json.
Hvad bliver konverteret
| Claude plug-in-artefakt | M365-ækvivalent | Bemærkninger |
|---|---|---|
.claude-plugin/plugin.json |
manifest.json |
Navn, beskrivelse og forfatter tilknyttet; GUID genereret automatisk (deterministisk UUID v5) |
skills/*/SKILL.md |
agentSkills[] poster + skills/ mappe |
Kopieret ordret - identisk format |
.mcp.json Servere |
agentConnectors[] Poster |
Automatisk registrering af URL-adresse og godkendelsestype |
color.png / outline.png |
Ikoner i pakke | Bruges, hvis den findes. pladsholdere, der genereres, hvis de mangler |
Hvad konverteres ikke
Følgende Claude plug-in-funktioner understøttes endnu ikke i Microsoft 365-manifestet:
| Claude plug-in-funktion | Status |
|---|---|
commands/ (skråstregskommandoer) |
Understøttes endnu ikke |
agents/ (underagenter) |
Understøttes endnu ikke |
hooks/ (hændelseshandlere) |
Understøttes endnu ikke |
settings.json |
Ikke relevant |
bin/ (eksekverbare filer) |
Ikke relevant |
Indstillinger for konverteringsscript
.\Convert-ClaudePluginToMOS3.ps1
-PluginPath <path> # Required: Claude plugin directory
-OutputPath <path> # Output directory (default: current)
-AppId <guid> # Override auto-generated GUID
-DefaultAuthType <type> # Auto | None | OAuthPluginVault | ApiKeyPluginVault
-DetailedOutput # Show step-by-step progress
Automatisk registrering af godkendelsestype:
| Kilde | Standardgodkendelsestype | Grund |
|---|---|---|
| Eksterne HTTPS-URL-adresser | OAuthPluginVault |
De fleste eksterne API'er skal have godkendelse |
Hvis automatisk registrering ikke stemmer overens med din konfiguration, kan du bruge -DefaultAuthType til at tilsidesætte den.
Byg en plug-in fra bunden
Følg disse trin for at oprette en plug-in-pakke fra bunden, startende med dine første færdigheder og opbygning af en komplet pakke, der kan publiceres.
Trin 1: Opret dine første færdigheder
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-frontmatter 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 frontmatterfelter
Obligatoriske felter:
| Feltet | Begrænsninger | Beskrivelse |
|---|---|---|
name |
1-64 tegn, kebab-case | Kompetence-id-skal matche mappenavnet præcist |
description |
1-1024 tegn | Hvornår skal du bruge denne kompetence-include udløserudtryk? |
Vigtigt!
Mappenavnet skal stemme overens med feltet name i frontmatteren. Denne uoverensstemmelse er den mest almindelige årsag til kompetencefejl.
| Mappesti |
name Feltet |
Gyldig? | Hvorfor |
|---|---|---|---|
skills/contract-analysis/SKILL.md |
contract-analysis |
Ja | Mappe- og navnematch |
skills/contract-analysis/SKILL.md |
ContractAnalysis |
Nej | Name bruger PascalCase i stedet for en tilsvarende mappe |
skills/my-skill/SKILL.md |
contract-analysis |
Nej | Mappen er my-skill , men navnet er contract-analysis |
Navngivningsregler (kebab-case): Brug kun alfanumeriske tegn og bindestreger med små bogstaver. Brug ikke efter hinanden følgende bindestreger, og brug ikke foranstillede eller efterstillede bindestreger.
| Eksempel | Gyldig? | Problem |
|---|---|---|
bond-relative-value |
Ja | Små bogstaver med bindestreger |
fx-carry-trade |
Ja | Små bogstaver med bindestreger |
email |
Ja | Enkelt ord, ingen bindestreger er nødvendige |
Bond_Relative_Value |
Nej | Understregningstegn og store bogstaver |
--my-skill-- |
Nej | Foranstillede og efterstillede bindestreger |
my--skill |
Nej | Efter hinanden følgende bindestreger |
Trin 2: Tilføj referencematerialer (valgfrit)
Hvis du vil have komplekse færdigheder, skal du holde dig SKILL.md slank og flytte detaljeret indhold til undermapper. Disse ekstra filer kaldes medfølgende filer og indlæses sammen med færdighederne, 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
Grænser for medfølgende filer
Hver færdighed kan indeholde op til 20 medfølgende filer (andre filer end SKILL.md). Følgende grænser gælder pr. færdighed:
| Grænse | Værdi |
|---|---|
| Maksimalt antal medfølgende filer | 20 |
| Maksimal størrelse pr. medfølgende fil | 5 MB |
| Maksimal samlet størrelse af medfølgende | 10 MB |
| Timeout for download (alle ledsagere) | 15 sekunder |
Medfølgende filregler
Stierne til de medfølgende filer skal følge disse regler:
- Brug kun relative stier (ingen absolutte stier)
- Ingen sti gennemløb (
..segmenter) - Der er ingen omvendte skråstreger eller null-byte i filnavne
- Ingen skjulte filer (navne, der starter med
.) - Ingen reserverede Windows-navne (
CON,PRN,AUX,NUL–COM1COM9–LPT1–LPT9) - Selve filen
SKILL.mdtæller ikke som en medfølgende fil - Filnavne skal bruge sikre tegn: alfanumeriske tegn, bindestreger, understregningstegn, prikker, mellemrum og
!
Systemet indlæser færdigheder i tre lag for at holde kontekstvinduet effektivt:
| Lag | Ved indlæsning | Målstørrelse |
|---|---|---|
Frontmatter (name + description) |
Altid - ved opstart | ~100 tokens |
SKILL.md Kroppen |
Når kompetence udløses | Mindre end 5.000 tokens (1.500-2.000 ord) |
Referencer (references/) |
Efter anmodning fra agenten | Ubegrænset |
Scripts (scripts/) |
Udført, ikke indlæst i kontekst | NIELSEN |
Referer eksplicit til undermapperne i 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 connector (valgfrit)
Hvis din udvidelse skal have adgang til eksterne data, skal du tilføje en ekstern MCP-server. Dette trin er valgfrit. Pakker, der kun indeholder færdigheder, fungerer godt i forbindelse med promptbaserede arbejdsprocesser.
Connectorkrav
| Krav | Detaljer |
|---|---|
| Transport | Streamable HTTP (HTTPS påkrævet, TLS 1.2+) |
| Protokollen | JSON-RPC 2.0-meddelelsesformat |
| Værktøjsregistrering | Understøttelse af tools/list dynamisk registrering (anbefales) |
| Værktøjsudførelse | Understøttelse tools/call af aktivering |
| Tilgængelighed | 99,9 % oppetid SLA anbefales til butiksudgivne apps |
| Svartid | Mindre end 30 sekunder pr. værktøjskald |
Retningslinjer for værktøjsdesign
-
Ét værktøj pr. handling for små API'er (færre end 15 handlinger):
search_case_law, ,get_rulingcite_precedent -
Søg og udfør for store API'er (mere end 50 handlinger):
search_actions+execute_action -
Beskrivende navne:
get_bond_priceikkegetData - Omfattende inputskemaer: Medtag en beskrivelse for hver parameter – dette er, hvad agenten læser
- Struktureret output: Returner JSON, som agenten kan formatere for brugeren
Understøttede godkendelsestyper
| Godkendelsestype | Hvornår skal du bruge? | Brugeroplevelse |
|---|---|---|
None |
Offentlige eller anonyme API'er, interne tjenester | Gennemsigtig – ingen godkendelsesprompt |
OAuthPluginVault |
OAuth 2.0 API'er (anbefales til produktion) | Brugeren fuldfører OAuth-samtykket én gang |
ApiKeyPluginVault |
API-nøglebaserede tjenester | Brugeren angiver nøglen én gang |
For OAuthPluginVault og ApiKeyPluginVaultpeger på referenceId legitimationsoplysninger, der er gemt i Microsoft Enterprise Token Store – hemmeligheder vises aldrig i manifest- eller kvalifikationsfilerne. Værdien referenceId er det OAuth-klientregistrerings-id, du opretter, når du registrerer en OAuth-klient med Agents Toolkit.
Vigtigt!
Når du registrerer din OAuth-klient, skal du angive brugen af organisationen til Enhver Microsoft 365-organisation for at sikre, at dit plug-in fungerer på tværs af lejere.
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.
Trin 4: Opret manifestet
Opret manifest.json i pakkeroden:
{
"$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 connector, 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",
"authorization": {
"type": "OAuthPluginVault",
"referenceId": "A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u"
}
}
}
}
]
}
I connectorkonfigurationen referenceId skal være OAuth-registrerings-id'et.
Trin 5: Tilføj ikoner
Opret to PNG-ikoner:
| Ikon | Størrelse | Formål |
|---|---|---|
color.png |
192×192 px | Ikon for appen i fuld farve, der vises på butiks- og applisten |
outline.png |
32×32 px | Konturikon med en enkelt farve til kompakte visninger |
Hvis du endnu ikke har ikoner, genererer konverteringsscriptet pladsholdere med udfyldte farver. Erstat dem, før du gemmer afsendelse.
Trin 6: Pakke
Opret en ZIP-fil med alt indhold på rodniveau:
contoso-legal-tools.zip
├── manifest.json
├── color.png
├── outline.png
└── skills/
└── contract-analysis/
├── SKILL.md
└── references/
└── clause-taxonomy.md
Windows (PowerShell):
Compress-Archive -Path manifest.json, color.png, outline.png, skills -DestinationPath contoso-legal-tools.zip
macOS/Linux:
zip -r contoso-legal-tools.zip manifest.json color.png outline.png skills/
Trin 7: Test
Sideload til test:
- Åbn M365 Administration Center>Administrer apps>Upload brugerdefineret app.
- Upload din
.zippakke. - Åbne kollegakilder >& Færdigheder – dine færdigheder skal vises.
Du kan også sideloade via API:
POST /users/titles
Content-Type: application/zip
Body: <your-package.zip>
Trin 8: Publicer
Send til Microsoft 365 App Store via Partnercenter.
Emballagemønstre
Vælg det mønster, der passer til din udvidelse:
Kun færdigheder (ingen connector)
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 og fjernconnector
Bedst til dataanalyse, API-integrationer og virksomhedssystemer.
my-data-skills.zip
├── manifest.json # agentSkills + agentConnectors
├── color.png
├── outline.png
└── skills/
├── analysis-workflow/SKILL.md
└── reporting-workflow/SKILL.md
Kun connector (ingen brugerdefinerede færdigheder)
Brug denne indstilling til datakilder, som Coworks indbyggede færdigheder allerede kan bruge.
my-connector.zip
├── manifest.json # agentConnectors only, no agentSkills
├── color.png
└── outline.png
Konverteret Claude-plug-in
Brug denne indstilling til eksisterende Claude økosystem-plug-ins, der er målrettet Cowork.
.\Convert-ClaudePluginToMOS3.ps1 -PluginPath ./claude-plugin -OutputPath ./output
Bedste praksis for oprettelse af færdigheder
Følg disse retningslinjer for at skabe færdigheder, der aktiverer pålideligt og giver ensartede resultater.
Skriv effektive beskrivelser
Feltet description bestemmer, hvornår agenten aktiverer dine færdigheder. 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: "Bruges, når brugeren beder om..." Denne beskrivelse er, hvordan agenten beslutter, hvilke færdigheder der skal aktiveres.
- Struktur som en arbejdsproces. Nummerer trinnene. Hvert trin skal kort til en konkret handling (læs en fil, kalde et værktøj, generere output).
- Definer outputformat. Vis den nøjagtige tabel, liste eller dokumentstruktur, som brugerne skal forvente. Denne definition forbedrer konsekvensen dramatisk.
-
Referenceværktøjer efter navn. Hvis dine færdigheder afhænger af connectorværktøjer, skal du udtrykkeligt navngive dem: "Brug værktøjet
search_case_lawtil..." -
Hold hoved SKILL.md slank. Flyt detaljeret referencemateriale til
references/undermappen. Kompetencebrødteksten skal være arbejdsprocessen og ikke et leksikon.
Undgå almindelige fejl
-
Integrer ikke hemmeligheder i
SKILL.mdfiler. BrugesagentConnectorssammen med godkendelse for API-legitimationsoplysninger. - Dupliker ikke indbyggede færdigheder. Tjek listen over indbyggede færdigheder , før du bygger.
- Gør ikke færdighederne for brede. "Do everything with legal documents" is worse than specific skills for "contract analysis", "clause extraction" og "legal research".
- Hardcode ikke filstier eller systemkommandoer. Færdigheder skal kunne overføres på tværs af miljøer.
-
Sæt ikke alt i SKILL.md. Hvis din brødtekst overstiger ca. 3.000 ord, skal du flytte detaljeret indhold til
references/.
Valideringsregler
Når du indsender din pakke, validerer platformen den på flere niveauer. Ret disse fejl før afsendelse for at undgå afvisning.
Validering på manifestniveau
| Kode | Regel | Sværhedsgraden |
|---|---|---|
| ASKILL-M001 |
folder er påkrævet for hver agentSkills post |
Error |
| ASKILL-M002 | Maks. 20 elementer i agentSkills matrix |
Error |
| ASKILL-M003 |
folder maks. 256 tegn for sti |
Error |
Validering på pakkeniveau
| Kode | Regel | Almindelig rettelse | Sværhedsgraden |
|---|---|---|---|
| ASKILL-P001 | Den mappe, der henvises til i manifestet, findes i ZIP | Kontrollér din ZIP-struktur | Error |
| ASKILL-P002 | Mappen indeholder en SKILL.md fil |
Tilføj mangler SKILL.md |
Error |
| ASKILL-P003 |
SKILL.md har en gyldig YAML-frontmatter mellem --- afgrænsere |
Ret YAML-syntaks | Error |
| ASKILL-P004 | Frontmatter indeholder name felt |
Føj name: til frontmatter |
Error |
| ASKILL-P005 | Frontmatter indeholder description felt |
Føj description: til frontmatter |
Error |
| ASKILL-P006 |
name svarer til mappenavnet (segmentet for sidste sti) |
Omdøb mappe, eller ret name: |
Error |
| ASKILL-P007 |
name er kebab-case |
Brug my-skill ikke MySkill eller my_skill |
Error |
| ASKILL-P008 | Der er ingen dubletværdier folder i matrixen |
Fjern dubletter | Error |
Validering af forbindelse
| Regel | Sværhedsgraden |
|---|---|
id og displayName påkrævet på hver connector |
Error |
Alle connectorværdier id er entydige i manifestet |
Error |
Præcis en af plugin eller remoteMcpServer |
Error |
mcpServerUrl skal være en gyldig HTTPS-URL-adresse |
Error |
authorization.referenceId påkrævet, medmindre typen er None |
Error |
authorization.referenceId må IKKE være til stede, når typen er None |
Error |
Validering af medfølgende fil
Medfølgende filer (referencematerialer, scripts og andre filer ved siden SKILL.mdaf ) valideres på upload- og synkroniseringstidspunktet:
| Regel | Sværhedsgraden |
|---|---|
Maksimalt 20 medfølgende filer pr. færdighed (undtagen SKILL.md) |
Error |
| Hver medfølgende fil skal være 5 MB eller mindre | Error |
| Det samlede antal medfølgende filer skal være 10 MB eller mindre pr. færdighed | Error |
| Filstier skal være relative (ingen absolutte stier) | Error |
Ingen gennemløbssegmenter for stier (..) |
Error |
| Der er ingen omvendte skråstreger eller null-byte i filnavne | Error |
Ingen skjulte filer (navne, der starter med .) |
Error |
Ingen reserverede Windows-navne (CON, PRN, AUX, NUL– COM1COM9– LPT1–LPT9 ) |
Error |
Filnavne må kun bruge sikre tegn (alfanumeriske, bindestreger, understregningstegn, prikker, !mellemrum) |
Error |
Kompatibilitet på tværs af platforme
Færdigheder bruger den åbne standard Agent Skills. De samme SKILL.md filer fungerer på tværs af flere AI-værktøjer:
| Platform | Kompatibilitet |
|---|---|
| Claude kode | Fuld-samme SKILL.md format |
| Claude.ai-projekter | Fulde færdigheder kan uploades som projektfiler |
| VS Code/GitHub Copilot | Full-Agent færdigheder, der understøttes i agenttilstand |
| Gemini kommandolinjegrænsefladen | support til Full-Agent færdigheder |
| JetBrains Junie | support til Full-Agent færdigheder |
| OpenAI Codex | support til Full-Agent færdigheder |
| Markøren | support til Full-Agent færdigheder |
Hvis du udvikler færdigheder til både Claude Code og Cowork, skal du starte med Claude Code-pluginstrukturen – 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)
Konvertér derefter til en M365-pakke, når du er klar til at publicere til Microsoft 365 App Store:
.\Convert-ClaudePluginToMOS3.ps1 -PluginPath ./my-plugin -OutputPath ./output
MCP-anmærkning og administration af bekræftelse
Copilot Cowork læser standard-MCP-objektet annotations på værktøjer, som serveren returnerer fra tools/list, og bruger det til at beslutte, om et værktøjskald skal have bekræftelse, og hvilket mærkat der skal vises i prompten.
Tilgængelige felter
| Feltet | Type | Effekt |
|---|---|---|
readOnlyHint |
Bool |
false: Bekræftelse kræves, før værktøjet kører. |
destructiveHint |
Bool |
true: Bekræftelse kræves, før værktøjet kører. |
title |
Streng | Mærkat, der kan læses af mennesker, og som vises i bekræftelsesdialogboksen. Går tilbage til værktøjsnavnet, når der ikke er noget. |
Bekræftelsesregler
Bekræftelse er kun påkrævet, hvis readOnlyHint == false eller destructiveHint == true.
Værktøjer uden anmærkninger eller uden disse specifikke tip er som standard ingen prompt. Copilot Cowork antager, at det er sikkert som standard i stedet for at blokere som standard, så eksisterende MCP-servere fortsætter med at fungere.
MCP-eksempler
En destruktiv handling med et brugervenligt navn:
{
"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 lukket af Coworks indbyggede politik, uanset anmærkninger.
- For ikke-Microsoft MCP-servere udrulles anmærkningsdrevet bekræftelse gradvist. Angivelse af tip nu er fremadkompatibel, og bekræftelsesprompter vises, efterhånden som udrulningen udvides, uden at det er nødvendigt at ændre udvikleren.
Almindelige spørgsmål
Kan jeg bruge færdigheder fra M365-pakken i Claude Kode?
Ja. Kompetencemapperne indeholder standardagentfærdigheder. Kopiér dem til .claude/skills/ i et Claude kodeprojekt, eller strukturér dit projekt som en Claude plug-in først, og brug konverteringsscriptet til M365.
Har jeg brug for en fjernforbindelse?
Nej. Pakker, der kun indeholder færdigheder, fungerer godt i forbindelse med promptbaserede arbejdsprocesser. Connectors er kun nødvendige, når dine færdigheder kræver dynamiske data fra et eksternt system.
Hvordan adskiller plug-in-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 af samme navn. Administration udrullede pakker viser isAdminDeployed: true.
Kan it-administratorer styre, hvilke plug-ins der er tilgængelige?
Ja. Standard M365-administratorkontrolelementer gælder: lister over tilladte/blokerede lejere, administratoradministrerede installationer og politikker for overholdelse af angivne standarder.
Hvad sker der, hvis en plug-in tilbagekaldes?
I den næste synkroniseringscyklus fjernes færdighederne og connectorerne fra denne pakke fra brugerens session. Aktive samtaler afbrydes ikke, men nye sessioner har ikke pakkens funktioner.
Hvad er det maksimale antal færdigheder pr. pakke?
20 færdigheder (pr. ASKILL-M002). For forbindelser er grænsen 10 pr. pakke.
Kan færdigheder henvise til connectorværktøjer fra den samme pakke?
Ja, og det burde de. Navngiv værktøjerne eksplicit i SKILL.md arbejdsprocessen (f.eks. "Brug værktøjet search_case_law til..."). Agenten forbinder dem på kørselstidspunktet.
Hvordan gør jeg generere et deterministisk GUID for min pakke?
Konverteringsscriptet bruger UUID v5 (SHA-1-baseret) fra dit plug-in-navn. Hvis du kører konverteringen to gange, oprettes det samme GUID. Til manuel pakning skal du bruge en hvilken som helst GUID-generator. Sørg for at holde den stabil på tværs af versioner.