Dela via

Agentskiss och instanskonfiguration

Viktigt

Du måste vara en del av förhandsversionen av Frontier för att få tidig åtkomst till Microsoft Agent 365. Frontier ansluter dig direkt till Microsofts senaste AI-innovationer. Förhandsversioner av Gräns omfattas av de befintliga förhandsversionsvillkoren för dina kundavtal. Eftersom dessa funktioner fortfarande är under utveckling kan deras tillgänglighet och funktioner ändras över tid.

Obs

Agentidentitetsautentisering är ett av de två autentiseringsflöden som du kan använda. Det andra är OBO-flödet (On-Behalf-Of).

Det agentiska autentiseringsflödet gör det möjligt för en agent att agera med sin egen identitet. I det här flödet:

  • Agenten autentiserar med sina egna autentiseringsuppgifter (autentiseringsuppgifter för agentritning)
  • Agenten fungerar oberoende av varandra med sina egna tilldelade behörigheter
  • Agenten har en egen identitet, separat från alla användare
  • Det här flödet är perfekt för autonoma agentåtgärder som inte kräver användarkontext

Användningsfall:

  • Autonoma agentåtgärder (schemalagda uppgifter, övervakning)
  • Skicka e-post eller skapa möten från agentens postlåda
  • Skapa och hantera agentägda resurser
  • Bakgrundsbearbetning utan användarinteraktion

Skapa din agentiska identitet

För att utveckla och testa din agent med agentisk autentisering måste du skapa agentidentiteten och registrera den med Microsoft 365. Med den här identiteten kan du testa agentens funktioner som verktyg, observerbarhet och meddelanden när du skapar dem.

Processen för att skapa agenten omfattar tre viktiga steg:

  1. Konfigurera – Initiera Agent 365 CLI-konfigurationen
  2. Installation – Skapa Azure-resurser och agentritning
  3. Skapa instans – Skapa agentiskt app-ID och användare

Förutsättningar

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

Behörigheter som krävs:

  • Giltig klientanvändare med någon av följande roller:
    • Global administratör för
    • Agent-ID-administratör
    • Agent-ID-utvecklare
  • Åtkomst till en Azure-prenumeration med behörighet att skapa resurser

Steg 1: Konfigurera Agent 365 CLI

Kommandot a365 config init skapar a365.config.json, den centrala konfigurationsfilen som används av alla Agent 365 CLI-kommandon. CLI tillhandahåller en interaktiv guide med Azure CLI-integrering och smarta standardvärden för att minimera manuella indata.

Autentisera med Azure AD

Innan du initierar konfigurationen autentiserar du med Azure med kommandot az login:

az login

Välj lämplig prenumeration och projekt. Konfigurationsguiden använder Azure CLI för att fråga efter tillgängliga prenumerationer, resursgrupper och App Service-planer.

Initiera; Bas; Konfiguration

Kör följande kommando för att starta guiden för interaktiv konfiguration:

a365 config init

Guiden använder Azure CLI-integrering och smarta standardvärden för att minimera manuella indata. Du uppmanas att:

Fält Description Exempel
Agentens namn En unik identifierare (endast alfanumeriskt) myagent
Distributionsprojektsökväg Sökväg till din agentprojektkatalog C:\MyAgent\sample-agent
E-post för chef E-post till chefen som övervakar den här agenten manager@yourtenant.onmicrosoft.com
Azure-resurser Välj från befintliga resursgrupper och App Service-planer (Interaktivt val)

Guiden genererar automatiskt relaterade resursnamn, identiteter och verifierar projekttypen.

Tillgänglighetsbegränsning

För närvarande är de enda Azure-regioner som stöds:

  • centralindia
  • westeurope
  • westus

Om du väljer en annan region, eller om du redigerar location egenskapen manuellt i a365.config.json filen, visas följande fel när du försöker skapa en agentritning.

The selected region ('{location}') is not supported by the Agent 365 CLI. Choose a supported region and ensure your web app name ('{webAppName}') is globally unique

Läs mer om konfigurationsfilstrukturen

Verifiera konfiguration

a365 config display Använd kommandot för att visa konfigurationen för att kontrollera att alla värden är korrekta:

a365 config display

Steg 2: Skapa agentritning

Kommandot a365 setup skapar Azure-resurser och registrerar agentritningen. Skissen definierar agentens identitets-, behörighets- och infrastrukturkrav. Det här steget etablerar grunden för att distribuera och köra din agent i Azure.

Kör -konfiguration

Kör kommandot: .

a365 setup

Konfigurationsprocessen utför följande åtgärder:

  1. Skapar Azure-infrastruktur (om den inte redan finns):

    • Resursgrupp
    • App Service-plan med angiven SKU
    • Azure Web App med hanterad identitet aktiverad

  2. Registrerar agentritning:

    • Skapar agentritningen i din Microsoft Entra-klientorganisation
    • Skapar Microsoft Entra-programregistreringar
    • Konfigurerar agentidentiteten med nödvändiga behörigheter

  3. Konfigurera API-behörigheter

    • Konfigurerar Microsoft Graph API-omfång
    • Konfigurerar API-behörigheter för meddelanderobot
    • Tillämpar ärvbara behörigheter för agentinstanser

  4. Uppdaterar konfigurationsfiler:

    • Sparar genererade ID:t och slutpunkter till a365.generated.config.json
    • Registrerar hanterad identitet och resursinformation

Obs

Under installationen öppnas webbläsarfönster för administratörsmedgivande. Slutför dessa medgivandeflöden för att fortsätta. Installationen tar vanligtvis 3–5 minuter och sparar konfigurationen automatiskt till a365.generated.config.json.

Verifiera konfigurationen

När installationen har slutförts bör du se en sammanfattning som visar alla slutförda steg. Kontrollera de skapade resurserna:

  1. Visa genererad konfiguration:

    a365 config display -g

    Bekräfta att dessa värden finns:

    • agentBlueprintId – Agentritningens program-ID
    • agentBlueprintObjectId – Skissens Microsoft Entra-ID
    • managedIdentityPrincipalId – Systemtilldelade huvudnamns-ID för hanterad identitet

  2. Granska Azure-resurser i Azure-portalen:

    Kontrollera att följande resurser har skapats:

    • Resursgrupp:

      • Välj Resursgrupper och öppna din resursgrupp.
      • Kontrollera att den innehåller din App Service-plan och webbapp

    • App Service-plan

      • App Service-planer – Azure App Service
      • Hitta din plan och kontrollera att prisnivån matchar din konfigurations-SKU

    • Webbapp

      • Gå till App Services>Web Apps
      • Leta reda på din webbapp och gå sedan till Inställningar>Identitetssystem tilldelat>
      • Kontrollera att statusen är På
      • Observera att objekt-ID:t (huvudnamn) matchar managedIdentityPrincipalId

  3. Verifiera Microsoft Entra-program i Azure-portalen:

    Gå till Azure Active DirectoryAppregistreringar.

    • Sök efter din agentritning med hjälp av agentBlueprintId
    • Öppna programmet och välj API-behörigheter
    • Kontrollera att behörigheter beviljas med gröna bockmarkeringar:
      • Microsoft Graph (delegerade behörigheter och programbehörigheter)
      • Api-behörigheter för meddelanderobot
    • Alla behörigheter ska visa "Beviljad för [din klient]"

Steg 3: Skapa agentinstans

Kommandot a365 create-instance skapar det agentiska app-ID:t och agentanvändaren för din agentritning, vilket aktiverar autentisering och behörigheter. Detta skapar en specifik instans av din agent med sin egen identitet och sina autentiseringsuppgifter, så att den kan autentisera och arbeta i din Microsoft 365-miljö.

Skapa instans

Kör följande kommando:

a365 create-instance

Vad den gör:

  1. Skapar agentiskt app-ID – Microsoft Entra-ID för den här agentinstansen
  2. Skapar agentisk användare – Tjänstens huvudnamn för agentinstansen
  3. Använder agentens skiss-ID – från den genererade konfigurationen (a365.generated.config.json)
  4. Beviljar administratörsmedgivande – Tillämpar ärvda behörigheter från skissen automatiskt
  5. Uppdateringskonfiguration – Sparar nya agentiska autentiseringsuppgifter i den lokala miljön

Förväntad utdata:

Förloppsmeddelanden visas för varje fas:

  • Fas 1: Skapa agentidentitet och agentanvändare
  • Begäranden om administratörsmedgivande (webbläsarfönster öppnas)
  • Fas 2: Licenstilldelning
  • Konfigurationen har uppdaterats

Verifiera instans

  1. Visa genererad konfiguration:

    a365 config display -g

    Kontrollera att följande värden finns:

    • AgenticAppId – Ditt agentinstansprogram-ID
    • AgenticUserId – Ditt agentanvändar-ID

  2. Verifiera i Azure-portalen:

    • Gå till Azure Active Directory>Appregistreringar.
    • Hitta ditt agentiska app-ID (kontrollera den genererade konfigurationen för ID:t)
    • Kontrollera att API-behörigheter beviljas och godkänns

Gå vidare

Din agentidentitet är nu registrerad och klar. Nästa:

  1. Lägg till verktygsfunktioner – Aktivera Microsoft 365-verktyg (rekommenderas för testning av autentisering)
  2. Testa din agent – Verifiera med Agent Playground
  • Last updated on