Naslaginformatie over cli-opdrachten setup voor agent 365

Stel uw Agent 365-omgeving in met gedetailleerde controle over elke stap. Met deze opdracht wordt de initiële werkstroom voor agent 365-blauwdrukken beheerd.

Minimum-rol vereist: Azure Inzender + Agent ID Developer

Syntax

a365 setup [command] [options]

Options

Aanbevolen uitvoeringsvolgorde

# 0. Check prerequisites (optional)
a365 setup requirements

# 1. Create blueprint
a365 setup blueprint

# 2. Configure MCP permissions
a365 setup permissions mcp

# 3. Configure bot permissions
a365 setup permissions bot

# 4. Configure CopilotStudio permissions (if needed)
a365 setup permissions copilotstudio

# 5. Configure custom permissions (if needed)
a365 setup permissions custom

Of voer alle stappen tegelijk uit:

# Full setup using config file (a365.config.json)
a365 setup all

# Config-free: no a365.config.json needed
a365 setup all --agent-name "MyAgent"

Als u als agent-id-beheerder of agent-id-ontwikkelaar (niet globale beheerder) werkt, voert u alle stappen uit, a365 setup all met uitzondering van OAuth2-machtigingen. Wanneer het klaar is, bevat de output de volgende stappen voor een Global Administrator om de toekenningen te voltooien — inclusief een directe link of toestemmings-URL die ze kunnen openen.

setup requirements

Valideer de vereisten voor de installatie van agent 365. Voert modulaire vereistecontroles uit en biedt richtlijnen voor eventuele problemen die worden gevonden.

a365 setup requirements [options]

Met deze opdracht worden de volgende stappen uitgevoerd:

• Controleert alle vereisten die nodig zijn voor het instellen van agent 365.
• Rapporteert eventuele problemen met gedetailleerde oplossingsrichtlijnen.
• Hiermee kunt u doorgaan met het controleren van alle vereisten, zelfs als sommige controles mislukken.
• Geeft een overzicht van alle controles aan het einde.

requirements Opties

setup blueprint

Een agentblauwdruk maken (Entra ID toepassingsregistratie).

Minimaal vereiste machtigingen: rol agent-id-ontwikkelaar

a365 setup blueprint [options]

blueprint Opties

setup permissions

OAuth2-machtigingen verlenen en overnemende machtigingen configureren.

Minimaal vereiste machtigingen: globale beheerder

a365 setup permissions [command] [options]

Options

Subcommands

setup permissions mcp

Configureer DE OAuth2-machtigingen voor MCP-server en overgenomen machtigingen.

Minimaal vereiste machtigingen: globale beheerder

a365 setup permissions mcp [options]

This command:

• Leesbewerkingen ToolingManifest.json van de deploymentProjectPath opgegeven in a365.config.json.
• Verleent gedelegeerde OAuth2-machtigingen voor elk MCP-serverbereik aan de agentblauwdruk.
• Hiermee configureert u overgenomen machtigingen, zodat agentexemplaren toegang hebben tot MCP-hulpprogramma's.
• Is idempotent en veilig om meerdere keren te worden uitgevoerd.

permissions mcp Opties

Migreren naar MCP-machtigingen per server

Gebruiken --remove-legacy-scopes bij het migreren van het verouderde model voor gedeelde machtigingen naar machtigingen per server:

• Verouderd gedeeld model: één resource-app-id (ea9ffc3e-8a23-4a7d-836d-234d7c7565c1) met gedeelde bereiken, zoals McpServers.Mail.All en McpServers.Teams.All.
• Model per server: Elke MCP-server heeft een eigen app-id met het bereik Tools.ListInvoke.All.

In het volgende voorbeeld ziet u hoe machtigingen per server worden weergegeven in de Microsoft Entra-beheercentrum nadat de blauwdruk is toegepast. Elke MCP-server, zoals Work IQ Calendar MCP en Work IQ Mail MCP, heeft een eigen gedelegeerd Tools.ListInvoke.All bereik. Een gedeeld McpServersMetadata.Read.All bereik biedt toegang tot metagegevens van MCP-servers.

setup permissions bot

Configureer de Messaging Bot API OAuth2 verleent en neemt machtigingen over.

Minimaal vereiste machtigingen: globale beheerder

Vereisten: Blauwdruk- en MCP-machtigingen (eerst uitvoeren a365 setup permissions mcp )

a365 setup permissions bot [options]

permissions bot Opties

setup permissions custom

Past aangepaste API-machtigingen toe op uw agentblauwdruk die verder gaan dan de standaardmachtigingen die vereist zijn voor agentbewerking. Met deze opdracht verleent u uw agent toegang tot aanvullende Microsoft Graph bereiken, zoals Aanwezigheid, Bestanden en Chat, of aan aangepaste API's die zijn geregistreerd in de Microsoft Entra ID-tenant van uw organisatie.

Minimaal vereiste machtigingen: globale beheerder

Vereisten: Voer eerst uit a365 setup blueprint .

a365 setup permissions custom [options]

This command:

• Hiermee configureert u gedelegeerde OAuth2-machtigingen met beheerderstoestemming voor elke geconfigureerde resource.
• Hiermee stelt u overgenomen machtigingen in, zodat agentgebruikers de toegang van de blauwdruk kunnen overnemen.
• Hiermee kunt u Microsoft Entra met de huidige configuratie afstemmen door nieuwe machtigingen toe te voegen en machtigingen te verwijderen die u uit de configuratie hebt verwijderd.
• Is idempotent en veilig om meerdere keren te worden uitgevoerd.

permissions custom Opties

Configureer aangepaste permissies inline

Gebruik --resource-app-id en --scopes om aangepaste permissies direct toe te passen zonder te bewerken a365.config.json:

# Add Microsoft Graph extended permissions
a365 setup permissions custom `
  --resource-app-id 00000003-0000-0000-c000-000000000000 `
  --scopes Presence.ReadWrite,Files.Read.All,Chat.Read

# Add custom API permissions
a365 setup permissions custom `
  --resource-app-id <your-api-app-id> `
  --scopes CustomScope.Read,CustomScope.Write

De naam van de bron wordt automatisch opgelost door Microsoft Entra. Je hoeft het niet te specificeren.

Configureer aangepaste permissies via een configuratiebestand

Of voeg het commando toe customBlueprintPermissionsa365.config.json en voer het uit zonder inline vlaggen:

a365 setup permissions custom

Dit commando verzoent Microsoft Entra met de geconfigureerde permissies - het voegt nieuwe machtigingen toe en verwijdert alle rechten die je uit de configuratie hebt verwijderd.

Integratie met setup all

Wanneer uw configuratie aangepaste machtigingen bevat, a365 setup all worden deze automatisch geconfigureerd als onderdeel van één batchmachtigingsfase. De volledige installatievolgorde is:

1. Blueprint
2. Machtigingenbatch (MCP, Bot API, Aangepaste blauwdrukmachtigingen, allemaal geconfigureerd)

setup permissions copilotstudio

Hiermee configureert u OAuth2-machtigingen die kunnen worden verleend en overgenomen voor de blauwdruk van de agent om Copilot Studio copilots aan te roepen via de Power Platform-API.

Minimaal vereiste machtigingen: globale beheerder

Vereisten: Voer eerst uit a365 setup blueprint .

a365 setup permissions copilotstudio [options]

This command:

• Controleert of de Service-principal van de Power Platform-API bestaat in uw tenant.
• Hiermee maakt u een OAuth2-machtigingstoestemming van de blauwdruk naar de Power Platform-API met het CopilotStudio.Copilots.Invoke bereik.
• Stelt overgenomen machtigingen in, zodat agentexemplaren Copilot Studio copilots kunnen aanroepen.

permissions copilotstudio Opties

Gebruik deze opdracht wanneer uw agent tijdens runtime Copilot Studio copilots moet aanroepen of Power Platform-API's moet aanroepen waarvoor CopilotStudio-machtigingen zijn vereist.

setup all

Voer alle installatiestappen uit om uw Agent 365-omgeving in te stellen

a365 setup all [options]

Voert de volledige agent 365-installatie uit, alle stappen in volgorde.

Omvat: Blauwdruk en machtigingen.

Welke stappen u moet uitvoeren, is afhankelijk van uw rol:

Wanneer u zonder globale beheerder uitvoert a365 setup all , gebruikt u de CLI:

1. Voltooit alle stappen die het kan (blauwdruk maken en overnemende machtigingen).
2. Hiermee worden URL's voor toestemming per resourcebeheerder gegenereerd en opgeslagen in a365.generated.config.json.
3. Toont de volgende stappen in de output voor een Global Administrator om de OAuth2-toekenningen te voltooien, inclusief een directe link of toestemmings-URL.

Minimaal vereiste machtigingen:

• Rol agent-id-ontwikkelaar (voor het maken van een blauwdruk)
• Global Administrator (voor OAuth2-toestemmingen — indien niet beschikbaar, print de CLI de volgende stappen in de output)
• Agent ID Administrator, Application Administrator of Global Administrator (voor S2S (Server-to-Server) agentidentiteit verleent — --authmode s2s of both; indien niet beschikbaar, print de CLI een PowerShell-fallback in de setup-samenvatting)

setup all Opties

Agent setup

Standaard draait het a365 setup all de blueprint agent flow. Met deze stroom wordt een agent gemaakt zonder een Dataverse- of AI-teamgenootafhankelijkheid. Het werkt voor agenten die direct communiceren met het Agent 365-platform.

# Default: uses a365.config.json
a365 setup all

# Or explicitly (same result)
a365 setup all --aiteammate false

Om in plaats daarvan de AI-teamgenoot-agentenflow te laten lopen, geef --aiteammateje .

Met deze stroom worden de volgende stappen op volgorde uitgevoerd:

1. Validatie : controleert Azure rollen en vereisten.
2. Blueprint maken : maakt of hergebruikt de Entra ID Agent Blueprint-toepassing.
3. Batch-machtigingen: configureert gedelegeerde machtigingen voor de blauwdruk voor Microsoft Graph, Agent 365 Tools, Messaging Bot-API, Waarneembaarheid-API, Power Platform en eventuele aangepaste resources.
4. Agent Identity creation — maakt een agent-id in Entra ID via de agentidentiteit Graph API.
5. Agentregistratie : registreert de agent via de AgentX V2 Agent Registration-API.
6. Configuratiesynchronisatie : schrijft de instellingen voor de runtimeverbinding en de configuratie van waarneembaarheid naar uw projectbestanden (appsettings.json, .env).

Configuratievrij instellen met --agent-name

Als u geen bestand hebt a365.config.json , gebruikt --agent-name u om setup zonder bestand uit te voeren. De CLI detecteert uw tenant automatisch en lost de client-app op door de bekende Agent 365 CLI app-registratie in uw tenant op te zoeken.

# Preview what would happen (no changes made)
a365 setup all --agent-name "MyAgent" --dry-run

# Run the full setup
a365 setup all --agent-name "MyAgent"

Wanneer u het volgende gebruikt --agent-name:

• TenantId wordt automatisch gedetecteerd vanuit az account show. Geef --tenant-id door om te overschrijven.
• ClientAppId wordt opgelost door te zoeken naar een Entra-app met de naam Agent 365 CLI in uw tenant. Als deze niet wordt gevonden, wordt de CLI afgesloten met een fout. Zie Registratie van aangepaste client-apps voor het registreren van deze app.
• Weergavenamen worden afgeleid als "<name> Agent" (identiteit) en "<name> Blueprint" (blauwdruk).
• De infrastructuur wordt altijd overgeslagen (externe hosting wordt ervan uitgegaan).
• Configuratiesynchronisatie (schrijven appsettings.json) wordt overgeslagen omdat er geen projectpad is geconfigureerd.

Beheerderstoestemming tijdens de installatie

Als uw client-app geen beheerderstoestemming heeft AllPrincipals voor de vereiste machtigingen, detecteert de CLI dit en wordt u gevraagd om interactief toestemming te verlenen:

The following permissions require admin consent:
  AgentIdentity.ReadWrite.All
  AgentIdentity.Create.All
  ...
Grant admin consent for these permissions now? [y/N]:

Voer in y om toestemming in de regel te verlenen. Als je geen Global Administrator bent, weiger dan — de CLI zal de volgende stappen voor een Global Administrator in de setup-samenvatting afgeven.

Agentidentiteit verleent (--authmode)

Standaard creëert a365 setup all principal-scoped gedelegeerde toekenningen op de agent identity service principal (obo modus). Deze subsidies vereisen geen administratieve functie.

Gebruik --authmode om het type subsidie te regelen:

# Default — OBO delegated grants (no admin role needed)
a365 setup all

# S2S app role assignments
a365 setup all --authmode s2s

# Both OBO and S2S
a365 setup all --authmode both

Wanneer de ingelogde gebruiker niet de vereiste rol voor S2S-toekenningen heeft, print de CLI een PowerShell-fallbackblok in de setup-samenvatting. Een beheerder kan het uitvoeren om de opdrachten te voltooien.

authMode Kan ook worden ingesteld a365.config.json zodat het bij elke run zonder de vlag geldt:

{
  "authMode": "s2s"
}

Config sync

Na een geslaagde uitvoering schrijft de CLI automatisch runtime-instellingen naar uw projectbestanden:

De CLI maakt het bestand als het niet bestaat en werkt afzonderlijke velden bij zonder de rest van uw configuratie te overschrijven.

Een mislukte registratie opnieuw proberen

Als de installatie de blauwdruk en machtigingen heeft voltooid, maar mislukt tijdens de registratie van de agent, kunt --agent-registration-only u deze stap opnieuw proberen zonder eerder werk te herhalen:

a365 setup all --agent-registration-only