ms-ai-architect/skills/ms-ai-advisor/references/copilot-extensibility/declarative-agents-fundamentals.md
Kjell Tore Guttormsen 070141f06b chore(ms-ai-architect): refresh KB medium-bucket — 74 files [skip-docs]
KB-currency refresh (medium priority, 2026-06-19) via /architect:kb-update.
74 medium-prioritets filer re-verifisert mot Microsoft Learn (MCP) — delegert
til 15 parallelle Opus-subagenter (3 bølger) gruppert etter delt kilde, med
disjunkte fil-sett. Verifisert i hovedkontekst (scope-sjekk + diff-review av
de faktatunge gruppene + tester).

Hovedendringer (faktuelle korreksjoner + currency):
- Azure AI Search semantic ranker: TILGJENGELIG PÅ ALLE TIERS (også Free/Basic
  m/ gratis månedlig kvote) — gammel KB sa feilaktig "kun S1+". Korrigert i
  tier-tabell, anti-patterns og beslutningstabell (azure-ai-search-setup).
- APIM score-threshold = DISTANSE (lavere = strengere): tuning-tabellen i
  rag-caching-optimization hadde retningen baklengs — invertert til korrekt.
- Agentic retrieval GA/preview-nyanse presisert (hovedkontekst-korreksjon mot
  agentic-retrieval-how-to-migrate): GA via REST 2026-04-01 returnerer EKSTRAKTIV
  grounding (references + activity), IKKE syntetiserte svar. Answer synthesis,
  ikke-minimal reasoning effort (LLM query planning) og multi-turn messages
  forblir preview (2026-05-01-preview). Subagent hadde overforenklet til "hele
  kjernepipelinen GA"; rettet i agentic-rag-patterns + citation-tracking.
- Copilot Studio modell-tabeller (platforms/copilot-studio): fjernet Claude Opus
  4.5 + GPT-5.2 (borte fra kilde), lagt til Claude Sonnet 4.6/Opus 4.6 (GA),
  Opus 4.7 + Mistral Medium 3.5 (experimental); GPT-5 Reasoning/Auto = preview;
  A2A GA (apr 2026).
- Computer Use (CUA): Copilot Studio GA 2026-05-07; 4 modeller m/ tier/status
  (OpenAI CUA + Sonnet 4.5 GA, Sonnet 4.6 + Opus 4.6 experimental); 5 credits/
  steg standard, 15 premium; US-only region-krav FJERNET i GA-dok; Cloud PC pool
  + Hosted browser + bring-your-own-machine.
- Azure AI Search REST API-versjoner bumpet: 2025-09-01 -> 2026-04-01 (stabil),
  2025-11-01-preview -> 2026-05-01-preview (hybrid-search, rag-security-rbac,
  chunking).
- Power Automate-integrasjon: trigger "Run a flow from Copilot" -> "When an agent
  calls the flow"; App Service innebygd MCP (preview) lagt til.
- M365 Copilot-manifest v1.26 -> v1.28 (GA, mai) / v1.29 dokumentert (juni);
  "Tenant graph grounding" -> "Work IQ".
- Speech fast transcription 2t/300MB -> 5t/500MB; multilingual 14 -> 15 locales
  (+ pt-BR). Content Understanding reasoning preview -> GA (v1.0, 2025-11-01).
- Security Copilot E5 -> E5+E7. Død Databricks-URL ci-cd/best-practices ->
  ci-cd/flows. Prompt Flow retirement (2027-04-20 -> MAF) notert der den
  presenteres som go-forward. Gateway-topologi-tabell-feil rettet.
- Alle 74 Last updated -> 2026-06-19.

Discovery ikke kjørt (historisk kun Databricks-støy) -> 389-telling uendret,
ingen resync. validate 239 PASS, kb-integrity 115/115 (262 orphan-warnings
uendret), gitleaks clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01REiKFhP4w6xGXXqWKpPCJJ
2026-06-19 14:02:18 +02:00

534 lines
24 KiB
Markdown

# Declarative Agents - Design and Implementation
**Last updated:** 2026-06-19 | Verified: MCP 2026-06-19
**Status:** GA
**Category:** Copilot Extensibility & Integration
---
## Introduksjon
Declarative agents er konfigurasjonsbaserte utvidelser av Microsoft 365 Copilot som lar organisasjoner tilpasse Copilot til spesifikke forretningsscenarier uten å skrive custom code. De kjører på samme orkestrator, foundation models og AI-tjenester som Microsoft 365 Copilot, og arver automatisk sikkerhets-, compliance- og styringsrammeverket fra Microsoft 365-økosystemet.
**Verified:** Declarative agents er GA (Generally Available) og støttes i Microsoft 365 Copilot, Teams, Word og PowerPoint. Begrenset støtte finnes for Government Community Cloud (GCC) tenants.
En declarative agent defineres gjennom tre hovedkomponenter:
- **Instructions** — Tilpassede instruksjoner som styrer agentens oppførsel og tone
- **Knowledge** — Tilkobling til enterprise-data (SharePoint, OneDrive, Microsoft 365 Copilot connectors)
- **Actions** — API plugins som integrerer med eksterne systemer i sanntid
Typiske bruksområder inkluderer:
- Employee IT self-help med kunnskapsbase fra SharePoint
- Customer support med integrasjon til order management systemer
- Team onboarding med organisasjonsspesifikk dokumentasjon
- Dokumentasjonsassistenter med tilgang til tekniske databaser
**Baseline:** Declarative agents egner seg best for scenarioer med enkel til moderat kompleksitet der oppgaven kan løses i én eller to grounding-operasjoner. De er ikke egnet for komplekse multi-step workflows eller scenarier som krever iterativ resonnering.
---
## Kjernekomponenter
### App Package Structure
En declarative agent pakkes som en Microsoft 365-app med følgende obligatoriske komponenter:
| Komponent | Beskrivelse | Schema |
|-----------|-------------|--------|
| **App manifest** | Microsoft 365 app manifest med `copilotAgents` node | [M365 app schema](https://learn.microsoft.com/en-us/microsoft-365/extensibility/schema) |
| **Declarative agent manifest** | JSON-fil med instructions, capabilities, conversation starters | [Schema v1.6](https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/declarative-agent-manifest-1.6) |
| **App icons** | Color og outline icon (obligatorisk) | PNG format |
| **API plugin manifest** (valgfritt) | OpenAPI-basert beskrivelse av actions | [API plugin schema 2.4](https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/api-plugin-manifest-2.4) |
**Verified:** App manifest refererer til declarative agent manifest via `copilotAgents.declarativeAgents` array:
```json
"copilotAgents": {
"declarativeAgents": [
{
"id": "MyAgent",
"file": "declarativeAgent.json"
}
]
}
```
### Declarative Agent Manifest
Minimumseksempel på declarative agent manifest (schema v1.6):
```json
{
"$schema": "https://developer.microsoft.com/json-schemas/copilot/declarative-agent/v1.6/schema.json",
"version": "v1.6",
"name": "IT Support Assistant",
"description": "Hjelper ansatte med IT-problemer basert på intern dokumentasjon",
"instructions": "Du er en IT-support-spesialist. Hjelp brukere med tekniske problemer ved å søke i SharePoint-dokumentasjonen først. Hold en profesjonell og hjelpsom tone.",
"conversation_starters": [
{
"title": "Hvordan resette passord",
"text": "Hvordan resetter jeg passordet mitt?"
}
],
"capabilities": [
{
"name": "OneDriveAndSharePoint",
"items_by_url": [
{
"url": "https://contoso.sharepoint.com/sites/ITSupport"
}
]
}
]
}
```
**Verified:** Nøkkelfelter i manifest:
- `name` og `description` — Brukes av både brukere og connected agents for å finne agenten
- `instructions` — Systemmelding som styrer agentens oppførsel (støtter markdown)
- `conversation_starters` — Forhåndsdefinerte prompts som hjelper brukere i gang
- `capabilities` — Array av capabilities (SharePoint, OneDrive, GraphConnectors, CodeInterpreter, etc.)
- `actions` — Referanser til API plugin manifests
### Capabilities
**Verified:** Tilgjengelige capabilities (schema v1.6):
| Capability | Beskrivelse | Bruksområde |
|------------|-------------|-------------|
| **OneDriveAndSharePoint** | Grounding mot SharePoint sites/folders | Intern dokumentasjon, policies |
| **GraphConnectors** | Microsoft 365 Copilot connectors | Eksterne datakilder (ServiceNow, Salesforce) |
| **WebSearch** | Bing web search | Offentlig informasjon |
| **CodeInterpreter** | Python code execution | Data analysis, visualisering |
| **People** | Org chart og people data | Finn eksperter, rapporteringslinjer |
| **TeamsMessages** | Teams chat og channel messages | Historisk kommunikasjon |
**Baseline:** Alle capabilities arver Microsoft 365's sikkerhetsmodell — brukeren ser kun data de har tilgang til.
### Actions (API Plugins)
Actions defineres i separate API plugin manifest-filer og refereres fra declarative agent manifest:
```json
"actions": [
{
"id": "OrderManagementPlugin",
"file": "order-plugin.json"
}
]
```
**Verified:** API plugin manifest beskriver:
- **Functions** — Operasjoner agenten kan utføre (OpenAPI-basert)
- **Authentication** — OAuth2, API key, eller None
- **Runtimes** — Hvor API-et kjører (REST endpoint eller Office Add-in)
- **Adaptive cards** — Strukturert visning av resultater (valgfritt)
**Baseline:** Declarative agents kan bruke flere plugins samtidig. Plugins kan også deles på tvers av flere agenter.
---
## Arkitekturmønstre
### Configuration-Based Architecture
Declarative agents bruker en konfigurasjonsdrevet tilnærming i stedet for custom code:
```
┌─────────────────────────────────────────┐
│ Microsoft 365 Copilot (User-facing) │
└─────────────────┬───────────────────────┘
┌─────────────────▼───────────────────────┐
│ Declarative Agent Manifest │
│ • Instructions │
│ • Conversation Starters │
│ • Capabilities │
│ • Actions │
└─────────────────┬───────────────────────┘
┌─────────┴──────────┐
│ │
┌───────▼─────┐ ┌────────▼────────┐
│ Capabilities │ │ API Plugins │
│ • SharePoint │ │ • OpenAPI spec │
│ • OneDrive │ │ • Auth config │
│ • Connectors │ │ • Functions │
└──────────────┘ └─────────────────┘
│ │
┌───────▼────────────────────▼───────┐
│ Microsoft 365 Orchestrator │
│ • Foundation Models (GPT-4) │
│ • Grounding Pipeline │
│ • Security & Compliance │
└────────────────────────────────────┘
```
**Verified:** Utviklere kontrollerer kun instructions, knowledge sources og actions. Microsoft styrer orkestrering, modellvalg og sikkerhet.
### Data Flow Pattern
**Verified:** Declarative agents følger en sekvensiell dataflyt:
1. **User prompt** → Brukerens spørsmål mottas
2. **Instructions processing** → Custom instructions tilføyes som system context
3. **Grounding** → Søk i configured capabilities (SharePoint, connectors, etc.)
4. **Tool calling** → Kall til API plugins (hvis relevant)
5. **Response generation** → LLM genererer svar basert på grounded data
6. **Response delivery** → Svar presenteres i Copilot UI
**Viktig begrensning (Verified):** Grounding og tool calling skjer **sekvensielt**, ikke parallelt. Dette betyr:
- Agenten kan ikke iterere mellom grounding og actions
- Komplekse multi-step workflows støttes ikke
- Looped operations eller chained API calls er ikke mulig
### Technical Limits
**Verified:** Kjente tekniske begrensninger (schema v1.6):
| Limit Type | Value | Impact |
|------------|-------|--------|
| **Grounding record limit** | 50 items | Maks antall dokumenter/records fra capabilities |
| **Plugin response limit** | 25 items | Maks items fra API plugin responses |
| **Token limit** | ~4096 tokens* | Total context window inkl. instructions + data |
| **Timeout** | ~45 sekunder* | Inkluderer network latency + processing |
*Inkluderer Microsoft service overhead — design for ~66% av grensen.
**Verified:** ISV store submission krav (Microsoft 365 validation guidelines):
- Minst 3 prompt starters (conversation_starters) — Must fix
- App manifest versjon 1.13 eller nyere — Must fix (seneste GA-versjon: 1.28, mai 2026; v1.29 dokumentert juni 2026) (Verified 2026-06)
- Navn (`name`) MÅ være identisk i manifest.json, declarativeAgent.json og plugin.json — Must fix
- Responstid ≤9 sekunder (99 percentil) — Must fix
- Alle serverkall med HTTPS + TLS 1.2+ — Must fix
**Baseline:** Disse begrensningene gjør declarative agents uegnet for:
- Full-document processing (store PDF-er, lange rapporter)
- Large dataset analysis
- Long-running workflows (over 30 sekunder)
- Paginering av API-resultater
---
## Beslutningsveiledning
### Når bruke Declarative Agents?
**Optimal fit (Verified):**
- **Information retrieval** — Søk og oppsummering fra SharePoint/connectors
- **Simple workflows** — 1-2 steg operasjoner (søk → svar, eller søk → API call → svar)
- **Productivity enhancement** — Hjelp til daglige oppgaver (onboarding, IT support, dokumentasjon)
- **Microsoft 365-sentrerte use cases** — Organisasjoner som allerede bruker M365 ecosystem
**Poor fit (Verified):**
- **Complex decision trees** — Multi-step workflows med conditional branching
- **Large data processing** — Analyse av store datasett eller hele dokumenter
- **Custom AI models** — Scenarier som krever spesialiserte modeller eller fine-tuning
- **Real-time streaming** — API-er som krever streaming responses
- **On-premises integration** — Systemer uten cloud-tilgjengelige API-er
### Decision Tree: Declarative vs. Custom Engine Agent
```
Trenger du kontroll over orchestration?
├─ JA → Custom Engine Agent (Azure Bot Framework)
└─ NEI
└─ Trenger du mer enn 2-3 steg i workflow?
├─ JA → Custom Engine Agent
└─ NEI
└─ Bruker du primært M365-data?
├─ JA → Declarative Agent ✓
└─ NEI
└─ Trenger du custom model/training?
├─ JA → Custom Engine Agent
└─ NEI → Declarative Agent ✓
```
### Comparison: Declarative vs. Custom Engine Agents
| Aspekt | Declarative Agent | Custom Engine Agent |
|--------|-------------------|---------------------|
| **Utviklingsmodell** | Configuration (JSON) | Code (C#, Python, TypeScript) |
| **Orchestrator** | Microsoft-styrt | Developer-styrt |
| **Model** | GPT-4 (Microsoft-valgt) | Valgfri (inkl. custom) |
| **Hosting** | Microsoft 365 infrastructure | Azure Bot Service (kundestyrt) |
| **Kompleksitet** | Lav — ingen code | Høy — full kode-kontroll |
| **Time-to-market** | Dager-uker | Uker-måneder |
| **Maintenance** | Minimal (config changes) | Høy (code updates, deployment) |
| **Egnet for** | Business users, citizen developers | Professional developers |
| **Lisenskrav** | M365 Copilot eller Copilot Chat | M365 Copilot |
**Baseline:** Declarative agents er lavest barriere for entry, men også mest begrenset i funksjonalitet.
---
## Integrasjon med Microsoft-stakken
### Development Tools
**Verified:** Fire offisielle verktøy for å bygge declarative agents:
| Tool | Målgruppe | Approach | Styrker |
|------|-----------|----------|---------|
| **Microsoft 365 Agents Toolkit** (VS Code) | Pro developers | Pro-code | CI/CD, source control, TypeSpec support |
| **Copilot Studio** | Business users / low-code devs | Low-code | Power Platform integration, GUI-based |
| **Agent Builder** (M365 Copilot) | End users | No-code | Naturlig språk, raskest setup |
| **SharePoint** | Content managers | No-code | SharePoint-fokusert, enkel publisering |
**Verified:** Microsoft 365 Agents Toolkit støtter **TypeSpec** — et deklarativt språk som genererer manifests automatisk:
```typescript
@agent(
"IT Support Assistant",
"Hjelper ansatte med IT-problemer"
)
@instructions("""
Du er en IT-support-spesialist.
Søk alltid i SharePoint-dokumentasjonen først.
""")
@conversationStarter(#{
title: "Passord reset",
text: "Hvordan resetter jeg passordet?"
})
namespace ITSupportAgent {
op sharepoint is AgentCapabilities.OneDriveAndSharePoint<
ItemsByUrl = [{ url: "https://contoso.sharepoint.com/sites/IT" }]
>;
}
```
**Baseline:** TypeSpec reduserer risiko for manifest-feil og gjør kode mer vedlikeholdbar, men krever VS Code + toolkit.
### Deployment & Distribution
**Verified:** Declarative agents distribueres via Microsoft 365 admin center:
1. **Package** — Generer `.zip` med app manifest, agent manifest, icons, plugin manifests
2. **Upload** — Last opp til M365 admin center (Integrated Apps)
3. **Approval** — Admin godkjenner agent (inkludert Responsible AI validation)
4. **Distribution** — Publish til:
- **Personal** — Kun utvikler (testing)
- **Group** — Spesifikke brukere/grupper
- **Organization-wide** — Alle i tenant
**Verified:** Responsible AI (RAI) validation kjøres automatisk ved upload. Agents som feiler RAI må revideres (typisk instructions som bryter retningslinjer).
### Security & Compliance
**Verified:** Declarative agents arver automatisk:
- **Microsoft Entra ID** — Autentisering og identitet
- **Data Loss Prevention (DLP)** — M365 DLP policies
- **Information Protection** — Sensitivity labels, retention
- **Audit logging** — Alle agent-interaksjoner logges
- **Conditional Access** — Device compliance, location-based access
**Baseline:** Utviklere kan **ikke** disable disse kontrollene — de er innebygd i plattformen.
**Verified:** User data boundaries:
- Agenten ser kun data brukeren har tilgang til (SharePoint permissions respekteres)
- GraphConnector data følger connector-spesifikke ACLs
- API plugin calls gjøres med user's identity (delegated permissions) eller app identity (application permissions)
---
## Offentlig sektor (Norge)
### Databehandling og GDPR
**Baseline:** Declarative agents prosesserer data i Microsoft 365 cloud:
- **Data residency** — Bruk Microsoft 365 Multi-Geo for å sikre data forblir i EU/Norge-region
- **GDPR compliance** — Microsoft 365 er GDPR-compliant, men organisasjonen må fortsatt:
- Dokumentere databehandlingsavtale (DPA) med Microsoft
- Gjennomføre DPIA (Data Protection Impact Assessment) for agents med sensitive data
- Informere brukere om at Copilot prosesserer personopplysninger
**Baseline:** Microsoft Commercial Data Protection Addendum (DPA) dekker Copilot/agents, men sjekk med juridisk avdeling for offentlig sektor-spesifikke krav.
### Integrasjon med offentlige fagsystemer
**Verified:** API plugins kan integrere med:
- **Cloud-baserte API-er** — Offentlig tilgjengelige REST APIs (egnet for SaaS fagsystemer)
- **On-premises systemer** — Krever Azure API Management eller Application Gateway som mellomlag
**Baseline:** Mange norske offentlige systemer (Altinn, Folkeregisteret, osv.) har ikke moderne REST API-er. Vurder:
- **Modernisering** — Wrap legacy systemer i REST API (Azure Functions, API Management)
- **Alternative arkitekturer** — Bruk Power Automate som mellomlag (cloud flows kan kalle on-prem data gateways)
### GCC Tenant Support
**Verified:** Begrenset støtte for declarative agents i Government Community Cloud (GCC):
- **GCC** — Støttet (begrenset funksjonalitet)
- **GCC High / DoD** — Ikke støttet (per feb 2026)
**Baseline:** Norske offentlige virksomheter bruker typisk commercial M365, ikke GCC. Dette er ikke en blocker, men vær oppmerksom på at noen features kan rulle ut senere til GCC.
### Anbefalinger for offentlig sektor
| Scenario | Anbefaling |
|----------|------------|
| **Borgertjenester** | Unngå lagring av sensitive personopplysninger i agent instructions/knowledge. Bruk API plugins med dynamic data fetch. |
| **Saksbehandling** | Kombiner declarative agent med Power Automate for komplekse workflows (agent → trigger flow → fagsystem). |
| **Intern IT-support** | Lavt risikonivå — egnet for declarative agents med SharePoint knowledge base. |
| **Dokumentasjonssøk** | Ideell use case — bruk OneDriveAndSharePoint capability med site-spesifikke permissions. |
---
## Kostnad og lisensiering
### License Requirements
**Verified:** Declarative agents krever én av følgende lisenser:
| Lisens | Pris (ca. NOK/mnd/user) | Capabilities | Target User |
|--------|-------------------------|--------------|-------------|
| **Microsoft 365 Copilot** | ~3500 NOK | Full funksjonalitet (all capabilities, API plugins) | Knowledge workers |
| **Microsoft 365 Copilot Chat** | Gratis* | Begrenset (no GraphConnectors, no CodeInterpreter) | Alle M365-brukere |
*Copilot Chat er inkludert i M365 E3/E5 uten ekstrakostnad (fra 2024).
**Baseline:** For offentlig sektor: Vurder om alle brukere trenger full Copilot-lisens, eller om mange kan bruke Copilot Chat-baserte agents.
### Cost Components
**Verified:** Kostnadskomponenter for declarative agents:
| Komponent | Kostnad | Modell |
|-----------|---------|--------|
| **Microsoft 365 Copilot license** | ~3500 NOK/mnd/user | Per-user subscription |
| **Microsoft 365 Copilot Chat** | Inkludert i M365 E3/E5 | No extra cost |
| **API plugin hosting** | Varierer | Azure consumption (Functions, API Management) |
| **GraphConnector data** | Varierer | Connector-spesifikk (ServiceNow, Salesforce, etc.) |
| **Storage (SharePoint)** | Inkludert i M365 | No extra cost (innenfor tenant quota) |
**Baseline:** Den største kostnaden er Copilot-lisenser. API plugin hosting er typisk minimal (Azure Functions consumption er billig for lav-moderate volumer).
### ROI Considerations
**Baseline:** ROI-beregning for declarative agents:
**Gevinster:**
- **Tidsbesparelse** — Ansatte finner informasjon raskere (estimat: 5-10% produktivitetsøkning)
- **Redusert support load** — Selvbetjening via agent reduserer tickets til IT/HR
- **Raskere onboarding** — Nye ansatte finner svar selv
**Kostnader:**
- **Lisensiering** — M365 Copilot lisens per user
- **Utvikling** — Lavt for no-code/low-code, høyere for pro-code med API plugins
- **Vedlikehold** — Minimal (config updates, knowledge base refresh)
**Anbefaling:** Start med pilot (10-50 brukere) for å måle faktisk tidsbesparelse før full utrulling.
---
## For arkitekten (Cosmo)
### Assessment Framework
Når en kunde spør om declarative agents, vurder disse dimensjonene:
**1. Workflow Complexity**
-**Lavt** — Single-step retrieval (søk i SharePoint → svar)
-**Moderat** — Two-step (søk → API call → svar)
- ⚠️ **Høyt** — Multi-step med conditional logic → Vurder Custom Engine Agent
**2. Data Sources**
-**M365-native** — SharePoint, OneDrive, Teams → Perfekt fit
-**Cloud APIs** — REST APIs med OpenAPI spec → Bruk API plugins
- ⚠️ **On-premises** — Legacy systemer → Krever modernisering/gateway
-**Custom corpus** — Egne embeddings/vector DB → Bruk Copilot Studio med custom knowledge
**3. User Base**
-**M365 Copilot licensed** — Full funksjonalitet
- ⚠️ **Mixed licensing** — Noen brukere har kun Copilot Chat → Design for laveste felles nevner
-**External users** — Declarative agents støtter ikke B2C scenarios
**4. Development Maturity**
-**Citizen developers** — Bruk Agent Builder eller Copilot Studio
-**Pro developers** — Bruk Agents Toolkit + TypeSpec
- ⚠️ **Complex requirements** — Vurder om declarative er tilstrekkelig, eller om Custom Engine Agent trengs
### Common Pitfalls
**Verified:** Vanlige feil ved implementering:
| Feil | Symptom | Løsning |
|------|---------|---------|
| **For generiske instructions** | Agent gir irrelevante svar | Bruk spesifikke, scenario-fokuserte instructions med eksempler |
| **For mange capabilities** | Agent er treg, gir for brede svar | Begrens til 2-3 capabilities som er nødvendige |
| **Manglende conversation starters** | Brukere vet ikke hva agenten kan | Legg til 3-5 representative starters |
| **API plugin timeouts** | Agent feiler med 45-sek timeout | Optimaliser API for raskere response (<30 sek) |
| **Overveldende grounding data** | Agent overskrider 50-item limit | Pre-filter data i API plugin, eller bruk mer spesifikke SharePoint-paths |
### Testing Strategy
**Baseline:** Anbefalte testfaser:
1. **Developer testing** — Personal deployment, test med egen bruker
2. **Pilot testing** — 5-10 testbrukere, samle feedback på nøyaktighet og brukervennlighet
3. **Limited rollout** — 50-100 brukere, monitor for RAI violations og performance issues
4. **Full deployment** — Organization-wide, med kontinuerlig monitoring
**Verified:** Bruk developer mode i Copilot for debugging:
- Skriv `debug on` i Copilot chat for å se agent title ID og grounding sources
- Nyttig for å verifisere at riktig SharePoint-site er i scope
### Integration Patterns
**Baseline:** Vanlige integrasjonsmønstre:
**Pattern 1: SharePoint Knowledge Base**
```
User → Declarative Agent → SharePoint capability → Grounding → Response
```
Bruk når: Intern dokumentasjon, policies, FAQ
**Pattern 2: API Plugin for Real-Time Data**
```
User → Declarative Agent → API Plugin → External API → Response
```
Bruk når: Live data (order status, ticket status, inventory)
**Pattern 3: Hybrid (Knowledge + Action)**
```
User → Agent → SharePoint grounding → Context
API Plugin → External system → Enriched response
```
Bruk når: Trenger både statisk knowledge og live data (f.eks. "finn policy + sjekk om bruker har tilgang")
**Pattern 4: Power Automate Bridge**
```
User → Agent → API Plugin → Power Automate HTTP trigger → Complex workflow → Response
```
Bruk når: Declarative agent trenger multi-step workflow (workaround for sekvensiell begrensning)
### Governance Checklist
**Baseline:** Før production deployment:
- [ ] **Responsible AI validation** passert
- [ ] **Security review** — Verifiser at agent ikke eksponerer sensitive data
- [ ] **DPA/DPIA** — Dokumenter databehandling (hvis personopplysninger)
- [ ] **User training** — Informer brukere om hva agenten kan/ikke kan gjøre
- [ ] **Naming convention** — Bruk tydelige, beskrivende navn (ikke generiske som "AI Assistant")
- [ ] **Monitoring plan** — Definer KPIer (bruk, tilfredshet, tidsbesparelse)
- [ ] **Update cadence** — Plan for hvordan knowledge base oppdateres (SharePoint content refresh)
---
## Kilder og verifisering
**Verified sources (MCP microsoft-learn):**
- [Declarative agents for Microsoft 365 Copilot — Overview](https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/overview-declarative-agent)
- [Declarative agent architecture](https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/declarative-agent-architecture)
- [Declarative agent manifest schema 1.6](https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/declarative-agent-manifest-1.6)
- [Build declarative agents using Microsoft 365 Agents Toolkit](https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/build-declarative-agents)
- [Choose the right tool to build your declarative agent](https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/declarative-agent-tool-comparison)
- [Agents for Microsoft 365 Copilot](https://learn.microsoft.com/en-us/microsoft-365-copilot/extensibility/agents-overview)
**Baseline (modellkunnskap):**
- Cost estimates (Microsoft publiserer ikke offisielle priser — estimater fra offentlige sources)
- ROI-beregninger (bransjestandarder)
- Offentlig sektor-anbefalinger (basert på generell kunnskap om norsk forvaltning)
**Sist verifisert:** 2026-06-19