Kom igång med utvecklingen av Agent 365

Agent 365 fungerar med en rad olika agentimplementationer. En agent kan assistera användare vid behov, arbeta självständigt i bakgrunden eller ha en egen användaridentitet i Microsoft 365. Att förstå vilken modell som bäst beskriver din agent är viktigt eftersom det avgör agentens identitetsmodell, vilken åtkomst den har till Microsoft 365-resurser och vilka livscykelsteg som gäller.

Agenttyper

Innan du börjar, fråga dig själv: Vilken typ av agent ska jag skapa?

Det finns två typer av agenter beroende på vilken typ av åtkomst de har:

Agenttyp Översikt
Agenter Arbeta på uppdrag av en användare med delegerad åtkomst, eller arbeta som en applikation med behörigheter med begränsad räckvidd. Registrerat som Microsoft Entra-applikationer eller agentidentitetsritningar.
AI-teammedlem Fungerar med sin egen användaridentitet i Microsoft 365, inklusive brevlåda, Teams-närvaro och katalogpost. Denna typ av agent är endast tillgänglig för organisationer som deltar i Frontier förhandsversionsprogrammet.

Agent

En agent arbetar på uppdrag av en användare. Den svarar på förfrågningar, utför bakgrundsuppgifter, ansluter till API:er, bearbetar data och genomför åtgärder.

Agenter finns i många olika former. Vissa är samtalsbaserade – en användare frågar något och agenten svarar. Vissa körs diskret i bakgrunden – utlösta av ett schema, en händelse eller ett inkommande meddelande – utan att någon behöver göra något. Vissa gör både och.

Exempelscenarier:

  • En användare ber en agent att sammanfatta sina olästa mejl och skapa utkast till svar. Agenten utför arbetet, har endast tillgång till de resurser som användaren har tillgång till, och lämnar tillbaka resultatet.
  • En kundtjänstagent hjälper en supportingenjör att söka i intern kunskapsbas och skriva svar under en live-supportsession.
  • En compliance-övervakningsagent kör varje natt, skannar SharePoint-webbplatser som agenten har tillgång till för policyöverträdelser och lämnar in revisionsrapporter – utan att någon tittar på.
  • En orderhanteringsagent hämtar nya försäljningsorder från en kö, uppdaterar ett CRM och skickar bekräftelsemejl – allt utan att någon behöver starta processen.

Identitetsbas:

Traditionellt brukar man registrera agenter som Microsoft Entra-applikationer. Den metoden fungerar fortfarande. Framöver kan du också skapa agenter på ett Microsoft Entra agent-ID via en agent identity blueprint – den IT-godkända, styrda definitionen av agentens funktioner, tillåten verktygsåtkomst och efterlevnadsbegränsningar. Att bygga på en ritning är den rekommenderade vägen för nya agenter. Det möjliggör styrd åtkomst till Work IQ-verktyg, dataskydd i Microsoft Purview, övervakning av hot i Microsoft Defender och styrning av Entra ID – vilket gör din agent till en helt styrd företagsidentitet från första dagen. Om din agents användare loggar in via en tredjepartsidentitetsleverantör, se Integrera Microsoft Entra agent-ID med tredjepartsidentitetsleverantörer.

AI-teammedlem

Viktigt

För att få tidig tillgång till den här typen av agent måste du vara en del av Frontier förhandsversionprogram. Frontier kopplar dig direkt till Microsofts senaste AI-innovationer. Frontier-förhandsversioner omfattas av befintliga förhandsversionsvillkor i dina kundavtal. Eftersom dessa funktioner fortfarande är under utveckling kan deras tillgänglighet och kapacitet förändras över tid.

En AI-teammedlem opererar i Microsoft 365 med sin egen agentidentitet. Du kan förse den med möjligheter såsom att skicka och ta emot e-post via en egen brevlåda, delta i Teams 1:1- och gruppkonversationer samt synas i katalog- och organisationsmetadata med en tilldelad chefsrelation. Personer kan interagera med den via välbekanta Microsoft 365-ingångspunkter såsom @mentions, e-post, kalenderinbjudningar och Teams-chatt.

Skapa dessa agenter från en agent blueprint, vilket är den IT-godkända och styrningsstyrda definitionen av agentens funktioner, tillåten verktygsåtkomst och efterlevnadsrestriktioner. Varje agentinstans ärver identitetsmodellen, behörigheter och policyer från sin moderagent identitetsblueprint.

Vad agenten gör – om den är konversationell, arbetar i bakgrunden eller båda – beror på hur du designar den. Vissa agenter är mycket interaktiva, svarar på meddelanden och stödjer arbetet i realtid. Andra hanterar uppgifter i bakgrunden och bearbetar e-post eller händelser utan direkt användarengagemang. Agenten använder sin egen användaridentitet, och dess aktiviteter styrs och kan spåras genom den identiteten.

Om du redan har en agent behöver du inte börja om. Du kan utöka befintliga agenter så att de fungerar med sin egen identitet genom att lägga till identitets- och blueprintkonfigurationen som beskrivs senare i denna guide.

Exempelscenarier:

  • Lägg till en HR-onboarding AI-teamkamrat i en nyanställds onboarding-kanal i Teams. Den skickar välkomstmejl från sin egen brevlåda, schemalägger introduktionsmöten i sin egen kalender och besvarar frågor med hjälp av de kapabiliteter som konfigurerats för den agentinstansen.
  • Tilldela en chefsrelation i katalogmetadata till en AI-teamkamrat för inköp. Anställda skickar inköpsförfrågningar till agentens brevlåda via e-post. Agenten behandlar förfrågan, hämtar information från ERP- och ekonomisystem med sitt styrda Work IQ-verktyg och svarar med godkännande eller eskalering från sin identitet.
  • Lägg till en forsknings-AI-lagkamrat på ett projektteams SharePoint-sida och Teams-kanal. Den kan visa relevanta dokument under möten, svara i samtalstrådar och utarbeta veckovisa statusrapporter genom att använda de behörigheter och verktyg som är konfigurerade för den agenten.

Identitetsbas:

Byggt på en agentidentitetsmall, vilket skapar ett Microsoft Entra agent-ID och tillhörande användarkonto: krävs alltid.

Lägga till Agent 365-funktioner stegvis

Agent 365 är inte allt eller inget. Du behöver inte skapa en AI-kollega redan första dagen – eller alls, om ditt scenario inte kräver det. Inför funktioner stegvis, med början från vad din agent behöver nu och utöka i takt med att dina krav utvecklas.

Varför bygga på en agent identity-plan?

När du skapar en agent identity blueprint tillhandahåller Agent 365 CLI ett Microsoft Entra agent-ID för din agent – en förstklassig identitet i din tenant, med samma företagsstyrningspolicys som mänskliga användare. Denna enda identitet utgör grunden för de säkerhetsfördelar som automatiskt gäller för varje blueprint-baserad agent:

Fördel Vad det innebär för din agent
Microsoft Entra ID governance Agentens identitets- och åtkomstlivscykel hanteras genom samma villkorliga åtkomst, identitetsskydd och åtkomstgranskningar som gäller för mänskliga användare.
Microsoft Purview Varje datainteraktion som agenten utför är föremål för organisationens känslighetsetiketter, DLP-policyer och bevarandepolicyer – automatiskt, utan extra kod.
Microsoft Defender ATP Agentens beteende övervakas kontinuerligt för avvikelser och hot. Misstänkt aktivitet utlöser samma varningar och svarsflöden som för alla användare i klientorganisationen.

Dessa fördelar gäller alla blueprint-baserade agenter, inklusive både agenter med användardelegerad åtkomst och agenter som verkar med egen identitet, så snart blueprinten har skapats. Du behöver inte konfigurera dem separat.

De fyra kapabilitetsnivåerna nedan representerar nivåer som du kan införa successivt. Följande tabell visar vad som finns tillgängligt för Agent 365 baserat på din utgångspunkt:

Funktion Anpassad motoragent för Microsoft 365 Alla andra agenter1
Registrera ✓ 2 ✓
Överskådlighet ✓ ✓
Work IQ ✓ ✓
AI-teammedlem ✓ 3 ✓ 3

1 Agenter som för närvarande är registrerade som Microsoft Entra-applikationer måste först skapa en agentidentitetsplan innan de kan använda någon funktionalitet i denna kolumn.

2 Microsoft 365 skräddarsydda agenter är redan registrerade med sin befintliga Microsoft Entra-applikationsregistrering – ingen ytterligare konfiguration krävs.

3 AI-lagkamrat för Microsoft 365:s anpassade motoragenter kräver en agent identity blueprint. Endast tillgänglig för deltagare i Frontier-programmet.

Kassaapparat

När du registrerar din agent gör du den synlig och administrerbar i Administrationscenter för Microsoft 365. Administratörer kan hitta den och se den i organisationens agentinventarie.

Det här får du:

  • Din agent visas i Administrationscenter för Microsoft 365; administratörer kan hitta den och se den i organisationens agentinventarie.
  • Blueprintbaserade agenter får också de fullständiga fördelarna med Entra ID-styrning, Purview och Defender som beskrivs i Why build on an agent identity blueprint?

Vad du bygger:

Registrera din agent genom din befintliga Microsoft Entra-applikationsregistrering eller en identitetsmall.

Kommentar

Om du skapar dina agenter på Google Vertex AI eller Amazon Bedrock krävs inget utvecklingsarbete för registreringen. Googles och Amazons API:er hämtar automatiskt agenter. Ingen SDK-integration, ingen blueprint och inga kodändringar krävs. Efter registrering kan du använda Agent 365 SDK för att successivt lägga till överskådlighet, åtkomst till Work IQ-verktyget och andra funktioner. För att komma igång, se Registrering av Google Vertex AI- och Amazon Bedrock-agenter.

Så här gör du:

Använd AI-styrd konfiguration och besvara frågorna om agenttyp därefter. Den AI-styrda konfigurationen utför de nödvändiga stegen för denna nivå. Microsoft 365:s anpassade engine-agenter är redan upptäckbara idag med hjälp av deras befintliga Microsoft Entra-applikationsregistrering.

Överskådlighet

När du har registrerat din agent, investera i överskådlighet. Denna investering ger IT-, säkerhetsteam och ingenjörsteamet insyn i vad din agent faktiskt gör. Varje inferensanrop, verktygsanrop och interaktion registreras, spåras och görs granskbara.

Överskådligheten är grunden för förtroende. Utan detta har administratörer inget sätt att verifiera beteende, granska efterlevnad eller diagnostisera problem i stor skala. Med detta blir din agent en företags tillgång snarare än en svart låda.

Kommentar

Om din agent är en super agent – det innebär att den internt anropar en eller flera underagenter för att slutföra en uppgift – kan dessa underagentanrop också loggas i överskådlighetspipeline. Logga dem som ett verktygssamtal eller ett agent-till-agent (A2A)-samtal, beroende på vad som är tillämpligt, så att hela delegeringskedjan är synlig och granskabar.

Det här får du:

  • Full [OpenTelemetry (OTel) (OTel)](https://opentelemetry.io/docs/specs/otel/protocol/)-baserad spårning av varje agentinteraktion: indata, utdata, verktygsanrop och modellanrop.
  • Aktivitet synlig i Administrationscenter för Microsoft 365 och anslutna övervakningsytor.
  • Revisionsspår som matas in i Microsoft Entra, Microsoft Purview och Microsoft Defender, och stödjer krav på efterlevnad, dataskydd och hothantering.

Vad du bygger:

Instrumentering med Agent 365 SDK:s överskådlighets-API:er: antingen autoinstrumentering (om du använder OpenAI, LangChain eller Agent Framework) eller manuell instrumentering för annan stack.

Kommentar

För de flesta nya integreringer, använd Microsoft OpenTelemetri-distributionen — den AI-styrda uppsättningen kan automatiskt konfigurera överskådlighet åt dig.

Om du redan har en OpenTelemetry-pipeline, om ditt agentramverk inte kan använda Agent 365 SDK, eller om din agent är byggd i ett språk som ännu inte stöds av SDK (t.ex. Java), kan du skicka telemetri direkt till Agent 365 via rå OTLP/HTTP utan SDK-beroende. Se Integrera med överskådlighet för Agent 365 med direkt OTel.

Så här gör du:

Använd AI-styrd konfiguration och besvara frågorna om överskådlighet därefter. Den AI-styrda konfigurationen utför de nödvändiga stegen för denna kapacitet. Det här använder Microsoft OpenTelemetry-distributionen för att instrumentera din agent.

Work IQ

När du har registrerat och gjort din agent observerbar, ge den åtkomst till data och åtgärder i Microsoft 365 via Work IQ. Work IQ är en kontrollerad uppsättning verktyg som gör det möjligt för din agent att arbeta med E-post, Kalender, OneDrive, SharePoint, Teams och mer.

Work IQ-verktyg kräver administratörens samtycke, granskas och kan återkallas. Agenten anropar dem med de behörigheter som anges i blueprinten – inga ytterligare OAuth-flöden eller egna anslutningsprogram behövs.

Det här får du:

  • Tillgång till hela Work IQ-verktygskatalogen – Mail, Kalender, OneDrive, SharePoint, Teams och mer.
  • Behörigheter som administratörer styr och anpassar efter din agents exakta behov.
  • Alla verktygsanrop spåras och är granskningsbara genom överskådlighetspipelinen.

Vad du bygger:

agentkod som anropar Work IQ-verktyg med hjälp av Agent 365 SDK:s verktygs-API:er.

Så här gör du:

Använd Agent 365 SDK:s verktygs-API:er för att manuellt lägga till Work IQ-verktygsanrop i din agentkod. Den AI-styrda konfigurationen stöder för närvarande inte denna kapacitet.

AI-teammedlem

AI-teammedlemmar är tillgängliga för deltagare i Frontierprogrammet.

Den sista fasen gör det möjligt för din agent att arbeta i Microsoft 365 med sin egen identitet. Beroende på konfiguration kan den ha en brevlåda, närvaro i Teams, katalogpost och chefsrelation. Personer kan interagera med den via välbekanta Microsoft 365-upplevelser såsom e-post, chatt, möten och appytor.

Kommentar

Skifte av identitets- och behörighetsmodell

Att gå över till en AI-teammedlem innebär en grundläggande förändring i hur din agent får åtkomst till resurser. Din befintliga agent kan använda delegerad användaråtkomst, där agenten agerar för en inloggad användare och endast kan komma åt de resurser som användaren har tillgång till, eller applikationsbehörigheter som är kopplade till en service principal. En agent med en användaridentitet ärver inte den anropande användarens åtkomst vid körning. Istället fungerar den under sin egen användaridentitet, med egna åtkomsträttigheter, styrningspolicyer och revisionsspår.

Den här ändringen innebär:

  • Vid delegerad användaråtkomst agerar agenten på uppdrag av den inloggade användaren och är begränsad till den användarens åtkomst. Med en agents egen identitet ger du tillgång till Microsoft 365-resurser som brevlåda, kalender, Teams och SharePoint direkt till agentidentiteten.
  • Du hanterar och granskar behörigheter som tilldelats agentidentiteten som agentens egen åtkomst. De är inte samma sak som användardelegerade behörigheter som skickas vidare från den anropande användaren.
  • Om din nuvarande implementation bygger på ombud eller applikationsbehörigheter, se över och justera dessa behörigheter för agentidentiteten innan du aktiverar denna funktion.

Det här får du:

  • allt från upptäckbarhet, observerbarhet och Work IQ.
  • En agentanvändaridentitet med egen e-postlåda – personer kan e-posta den direkt och den kan skicka e-post från sin egen adress.
  • En närvaro över Microsoft 365-appar – folk kan chatta med den, den, @mention lägga till den i kanaler och bjuda in den till möten i Teams; och interagera direkt med den i Word, Excel, PowerPoint och andra M365-ytor.
  • En post i organisationsschemat under en utsedd chef – agenten syns i organisationens katalog.
  • Administratörsstyrd livscykel – agenten skapas, hanteras och tas bort via administrationscenter för Microsoft 365, med full kontroll över varje instans.

Vad du bygger:

Alla funktioner, plus instansskapande och (valfritt) Marketplace-publicering.

Så här gör du:

Använd den AI-guidade installationen och besvara AI teammate-frågorna enligt instruktionerna. Den AI-styrda konfigurationen utför de nödvändiga stegen för denna nivå.

AI-guidad konfiguration

Använd en AI-programmeringsagent för att automatisera installationen och konfigurationen av din agent för Agent 365. Den AI-styrda installationen guidar dig genom de nödvändiga kontrollerna, konfigurationsstegen och kodintegreringen som krävs för att möjliggöra funktioner som registrering, överskådlighet, åtkomst till Work IQ-verktyget och funktionalitet för AI-teamkamrat.

AI-styrda installationskrav

Kontrollera att du har följande innan du börjar:

Krav Detaljer
AI-kodningsagent Visual Studio Code med GitHub Copilot och GitHub Copilot Chat-tillägg , eller en annan AI-kodagent med terminalåtkomst
Agentkod Ett fungerande agentprojekt i Python, Node.js eller .NET. Om du inte har något, börja med ett snabbstartsexempel.
Entra-roll Global administratör - slutför alla steg inklusive godkännande av OAuth2-behörigheter. Agent ID Developer – slutför alla steg utom OAuth2-behörighet; installationen genererar en överlämning för en Global Administrator.

AI-styrda uppsättningssteg

Dessa steg gäller oavsett om du möjliggör en enskild agent eller en agentfabrik. AI-agenten identifierar de verktyg som krävs och hanterar installation, autentisering och validering automatiskt.

Öppna ditt agentprojekt och kopiera denna prompt till din AI-agent. Om du använder GitHub Copilot, byt först till agentläge – Fråga- och Redigeringslägen har inte terminalåtkomst.

Follow the steps at aka.ms/agent365enable to enable my agent for Agent 365.

AI-agenten inleder med att ställa tre frågor för att avgöra vilka kapabiliteter som gäller för din agent.

Fråga 1: Är din agent redan tillgänglig i Teams eller Copilot?

  • Ja
  • Nej

Fråga 2: Hur autentiserar din agent sig när den anropar nedströms API:er?

  • On-behalf-of (OBO) — agenten agerar å den inloggade användarens vägnar (delegerade behörigheter)
  • Service-to-service (S2S) — agenten agerar som sin egen identitet (applikationsbehörigheter)
  • Både (OBO och S2S)

Fråga 3: Vilka Agent 365-kapabiliteter vill du aktivera?

Installationen inkluderar automatiskt alla förkunskaper för ditt val.

AI-agenten arbetar sedan automatiskt igenom de tillämpliga nivåerna och pausar bara för att be om din inmatning:

Funktion Vad AI-agenten gör 1
Registrera Kontrollerar om .NET och Agent 365 CLI finns (installerar eller uppdaterar vid behov), installerar Azure CLI om det saknas, kör az login om du inte är autentiserad, validerar din anpassade klientappregistrering, samlar in agentnamn och chefens e-postadress, konfigurerar din agent i Teams Developer Portal, och registrerar din agent blueprint
Överskådlighet Lägger till instrumentering för överskådlighet från Agent 365 SDK i din agentkod
AI-teammedlem Kör a365 publish och guidar dig genom stegen efter distribution, inklusive skapande av agentinstans

1 Vilka steg som utförs beror på agenttypen och de faser du valde i början av installationen.

Viktigt

För Överskådlighet skriver AI-agenten kod direkt in i ditt projekt. AI-kodningsagenter kan göra misstag. Granska alltid ändringarna innan du distribuerar dem till produktion.

Information som krävs för att slutföra

AI-agenten pausar för att samla in konfigurationsuppgifter under uppsättningen:

Prompt Vad som ska anges
agentens namn, ansvarigs e-postadress Agentens grundläggande metadata
Bekräftelse av härledda värden Granska de automatiskt genererade namnen för agentidentitet, blueprint och användarprincipal
Manifestgranskning Bekräfta att din manifest.json är uppdaterad så att den innehåller namn, beskrivning och utvecklarinformation för din agent

Steg efter distribution

När de automatiserade nivåerna är slutförda pausar AI-agenten för två steg som kräver webbläsarinteraktion:

  1. Skapa en agentinstans

    (endast AI-lagkamrat) — I Microsoft Teams, gå till Appar, sök efter din agent och välj Lägg till. Om administratörsgodkännande krävs får din Microsoft 365-administratör förfrågan. När det är godkänt visas din agent i ditt organisationsschema. För ytterligare instanser, se Create agent instances. Det kan ta några minuter för en nypublicerad agent att dyka upp i Teams sök.

  2. Testa din agent

    Skicka ett meddelande till din agent i Teams för att verifiera att den fungerar.

Klart — din agent är utplacerad, publicerad och live. Se Skapa agentinstanser om du behöver ytterligare instanser.

Om något inte fungerade, erbjuder AI-agenten riktad felsökning. Du kan också se Agent 365 Felsökningsguide.

Manuell referensväg

Använd denna referens endast om du felsöker ett steg, bygger CI/CD-automation eller arbetar utan en AI-kodningsagent.

Steg Vad den gör Guide
Konfigurationsinställning Skapar a365.config.json med dina klientorganisations-, prenumerations- och projektdetaljer. Om du har en befintlig driftsättning, ange endpoint för meddelanden här. Konfigurera Agent 365-konfiguration
Konfigurera blueprint Registrerar din agentidentitet i Entra och skapar Azure-resurser (resursgrupp, App Service Plan, Web App) Konfigurera agent blueprint
Distribuera Distribuerar din agentkod till Azure App Service. Valfritt om det redan är hostat någon annanstans. Azure · AWS · GCP
Publicera Skapar manifest.zip och laddar upp till Administrationscenter för Microsoft 365 Publicera agent

För CLI-installation, kommandon och felsökning, se Agent 365 CLI.

Publicera din agent på Microsoft Marketplace

När du har utvecklat och testat din agent fullt ut inom din egen tenant eller dina egna tenants, publicera den i Microsoft Marketplace.

För att göra detta behöver du ett Microsoft AI Cloud Partner Program-konto i Microsoft Partnercenter. Om du inte har ett, skapa ett konto för att få ditt PartnerID. Nästa steg är att anmäla dig till Microsoft 365 och Copilot-programmet, vilket ger dig tillgång till de resurser och det stöd som behövs för att publicera agenterbjudanden. När du har registrerat dig, gå igenom checklistan för inskickning och valideringsriktlinjerna och skicka därefter in din agent via Partnercentrets steg-för-steg-guide för inskickning.

Lär dig hur du skickar in din agent till Microsoft Marketplace med hjälp av Partnercenter.

När du är klar publiceras din agent på Microsoft Marketplace och finns tillgänglig för kunder att upptäcka och distribuera.

Felsökning av AI-styrd installation

Om du stöter på problem under den AI-styrda installationen, se följande vanliga problem och deras lösningar.

Problem beskrivning
AI-agenten kör inte terminalkommandon AI-agenten beskriver kommandon men utför dem inte
AI-agenten hoppar över steg Installationen verkar hoppa över nödvändiga steg
CLI-kommandon misslyckas med behörighetsfel Auktoriseringsfel vid körning av a365 CLI-kommandon
Konfigurationsvärden är felaktiga Behöver ändra konfiguration efter att ha skapat a365.config.json

AI-agenten kör inte terminalkommandon

Om AI-agenten beskriver kommandon men inte utför dem, kontrollera att du använder agentläge i GitHub Copilot Chat. Lägena Fråga och Redigera har inte terminalåtkomst.

AI-agenten hoppar över steg

Instruktionsfilen upprätthåller strikt stegordning. Om AI-agenten verkar hoppa över ett steg, be den att börja om:

Please start from Step 1 in the setup instructions and work through each step in order.

CLI-kommandon misslyckas med behörighetsfel

Om a365 CLI-kommandon misslyckas med auktorisationsfel är den vanligaste orsaken en saknad eller ofullständig registrering av en anpassad klientapp. AI-agenten validerar denna registrering under konfigurationen, men om valideringen utlämnades, se Custom client app registration.

För allmän felsökning, se Agent 365 felsökningsguide.

Konfigurationsvärden är felaktiga

Om du behöver ändra konfigurationsvärden efter att du har skapat a365.config.json, antingen:

  • Redigera filen direkt och kör om a365 config init -c ./a365.config.json
  • Be AI-agenten om att uppdatera specifika värden
  • Last updated on