Naslaginformatie over cli-opdrachten `setup` voor agent 365

Belangrijk

U moet deel uitmaken van het Frontier Preview-programma om vroegtijdige toegang te krijgen tot Microsoft Agent 365. Frontier verbindt u rechtstreeks met de nieuwste AI-innovaties van Microsoft. Grensvertoningen zijn onderhevig aan de bestaande preview-voorwaarden van uw klantovereenkomsten. Omdat deze functies nog in ontwikkeling zijn, kunnen hun beschikbaarheid en mogelijkheden na verloop van tijd veranderen.

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.

Minimale rol vereist: Azure Contributor + Agent ID Developer

Opmerking

De rol die u hebt, bepaalt hoeveel van de installatie in één uitvoering is voltooid. Globale beheerder kan alle stappen tegelijk uitvoeren. Agent-id-beheerder en agent-id-ontwikkelaar kunnen alle stappen voltooien, met uitzondering van OAuth2-machtigingstoestemming (beheerderstoestemming), waarvoor een afzonderlijke stap van een globale beheerder is vereist. Zie setup adminvoor meer informatie over de handoff-werkstroom.

Syntaxis

a365 setup [command] [options]

Options

Optie	Description
`-?`, , `-h--help`	Help- en gebruiksgegevens weergeven.

Aanbevolen uitvoeringsvolgorde

# 0. Check prerequisites (optional)
a365 setup requirements

# 1. Create infrastructure (or skip if infrastructure exists)
a365 setup infrastructure

# 2. Create blueprint
a365 setup blueprint

# 3. Configure MCP permissions
a365 setup permissions mcp

# 4. Configure bot permissions
a365 setup permissions bot

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

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

Of voer alle stappen tegelijk uit:

# Full setup (includes infrastructure)
a365 setup all

# Skip infrastructure if it already exists
a365 setup all --skip-infrastructure

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. Nadat deze is voltooid, moet een globale beheerder de subsidies voltooien:

# Non-admin path: run setup, then hand off to Global Administrator
a365 setup all

# Global Administrator completes OAuth2 grants
a365 setup admin --config-dir "<path-to-config-folder>"

`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

Optie	Description
`-c`, `--config <config>`	Pad naar configuratiebestand. De standaardwaarde is `a365.config.json`.
`-v`, `--verbose`	Toont gedetailleerde uitvoer voor alle controles.
`--category <category>`	Hiermee worden alleen controles uitgevoerd voor een specifieke categorie, zoals `Azure`, `Authentication` of `Configuration`.
`-?`, , `-h--help`	Help- en gebruiksgegevens weergeven.

`setup infrastructure`

Maak Azure infrastructuur.

Minimum vereiste machtigingen: Azure Abonnementsbijdrager of Eigenaar

a365 setup infrastructure [options]

`infrastructure` Opties

Optie	Description
`-c`, `--config <config>`	Pad naar configuratiebestand. De standaardwaarde is `a365.config.json`.
`-v`, `--verbose`	Gedetailleerde uitvoer weergeven.
`--dry-run`	Weergeven wat de opdracht zou doen zonder deze uit te voeren.
`-?`, , `-h--help`	Help- en gebruiksgegevens weergeven.

`setup blueprint`

Een agentblauwdruk maken (Registratie van entra-id-toepassing).

Minimaal vereiste machtigingen: rol agent-id-ontwikkelaar

a365 setup blueprint [options]

`blueprint` Opties

Optie	Description
`-c`, `--config <config>`	Pad naar configuratiebestand. De standaardwaarde is `a365.config.json`.
`-v`, `--verbose`	Gedetailleerde uitvoer weergeven.
`--dry-run`	Weergeven wat de opdracht zou doen zonder deze uit te voeren.
`--no-endpoint`	Registreer het berichteindpunt niet (alleen blauwdruk).
`--endpoint-only`	Registreer alleen het berichteindpunt. Hiervoor is een bestaande blauwdruk vereist.
`-?`, , `-h--help`	Help- en gebruiksgegevens weergeven.

`setup permissions`

OAuth2-machtigingen verlenen en overnemende machtigingen configureren.

Minimaal vereiste machtigingen: globale beheerder

a365 setup permissions [command] [options]

Options

Optie	Description
`-?`, , `-h--help`	Help- en gebruiksgegevens weergeven.

Subcommands

Subcommand	Description
`mcp`	Configureer DE OAuth2-machtigingen voor MCP-server en overgenomen machtigingen.
`bot`	Configureer de Messaging Bot API OAuth2 verleent en neemt machtigingen over.
`custom`	Past aangepaste API-machtigingen toe op uw agentblauwdruk die verder gaan dan de standaardmachtigingen die vereist zijn voor agentbewerking.
`copilotstudio`	Hiermee configureert u OAuth2-machtigingen voor en overnemende machtigingen voor de blauwdruk van de agent om Copilot Studio-copilots aan te roepen via de Power Platform-API.

`setup permissions mcp`

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

Minimaal vereiste machtigingen: globale beheerder

a365 setup permissions mcp [options]

Deze opdracht:

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.

Belangrijk

Voordat u deze opdracht uitvoert, voert u uit a365 config display om te controleren of deploymentProjectPath deze verwijst naar de projectmap die de bijgewerkte ToolingManifest.jsonmap bevat. Als de ontwikkelaar MCP-servers toevoegt op een andere computer, deelt u de bijgewerkte ToolingManifest.json server eerst met de globale beheerder. Als u niet het juiste uitvoert ToolingManifest.json , worden de nieuwe MCP-servermachtigingen niet toegevoegd aan de blauwdruk.
Voer deze opdracht uit nadat de ontwikkelaar is uitgevoerd a365 develop add-mcp-servers. Het toevoegen van MCP-servers aan het manifest en het verlenen van machtigingen aan de blauwdruk zijn twee afzonderlijke stappen. Nadat deze opdracht is voltooid, zijn de MCP-servermachtigingen zichtbaar in de blauwdruk van de agent.

`permissions mcp` Opties

Optie	Description
`-c`, `--config <config>`	Pad naar configuratiebestand. De standaardwaarde is `a365.config.json`.
`-v`, `--verbose`	Gedetailleerde uitvoer weergeven.
`--dry-run`	Weergeven wat de opdracht zou doen zonder deze uit te voeren.
`-?`, , `-h--help`	Help- en gebruiksgegevens weergeven.

`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 )

Volgende stap: Implementeer uw agent (voer a365 deploy uit als u host op Azure)

a365 setup permissions bot [options]

`permissions bot` Opties

Optie	Description
`-c`, `--config <config>`	Pad naar configuratiebestand. De standaardwaarde is `a365.config.json`.
`-v`, `--verbose`	Gedetailleerde uitvoer weergeven.
`--dry-run`	Weergeven wat de opdracht zou doen zonder deze uit te voeren.
`-?`, , `-h--help`	Help- en gebruiksgegevens weergeven.

`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 . Voeg aangepaste machtigingen toe aan door deze opdracht te a365.config.json gebruiken a365 config permissions voordat u deze opdracht uitvoert.

a365 setup permissions custom [options]

Deze opdracht:

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 wordt Microsoft Entra afgestemd op de huidige configuratie door nieuwe machtigingen toe te voegen en eventuele machtigingen te verwijderen die u uit de configuratie hebt verwijderd.
Is idempotent en veilig om meerdere keren te worden uitgevoerd.

`permissions custom` Opties

Optie	Description
`-c`, `--config <config>`	Pad naar configuratiebestand. De standaardwaarde is `a365.config.json`.
`-v`, `--verbose`	Gedetailleerde uitvoer weergeven.
`--dry-run`	Weergeven wat de opdracht zou doen zonder deze uit te voeren.
`-?`, , `-h--help`	Help- en gebruiksgegevens weergeven.

Aangepaste machtigingen configureren

Gebruik a365 config permissions deze opdracht om aangepaste machtigingen toe te voegen aan uw configuratie voordat u deze opdracht uitvoert:

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

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

# Apply all configured custom permissions
a365 setup permissions custom

Tijdens de installatie wordt de resourcenaam automatisch omgezet vanuit Azure. U hoeft deze niet op te geven in de configuratie.

Aangepaste machtigingen verwijderen

Aangepaste machtigingen verwijderen uit zowel de configuratie als Microsoft Entra:

# Step 1: Remove from config
a365 config permissions --reset

# Step 2: Reconcile Microsoft Entra with updated config
a365 setup permissions custom

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:

Infrastructuur
Blueprint
Machtigingenbatch (MCP, Bot API, Aangepaste blauwdrukmachtigingen, allemaal geconfigureerd)

`setup permissions copilotstudio`

Hiermee configureert u OAuth2-machtigingen voor en overnemende machtigingen 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]

Deze opdracht:

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

Optie	Description
`-c`, `--config <config>`	Pad naar configuratiebestand. De standaardwaarde is `a365.config.json`.
`-v`, `--verbose`	Gedetailleerde uitvoer weergeven.
`--dry-run`	Weergeven wat de opdracht zou doen zonder deze uit te voeren.
`-?`, , `-h--help`	Help- en gebruiksgegevens weergeven.

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: Infrastructuur, Blauwdruk en Machtigingen.

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

Stap	Globale beheerder	Agent-id-beheerder	AgentID-ontwikkelaar
Controle van vereisten	Ja	Ja	Ja
Azure-infrastructuur	Ja	Ja	Ja
Blauwdruk voor agent maken	Ja	Ja	Ja
Overgenomen machtigingen	Ja	Ja	Ja
OAuth2-machtigingen verlenen (beheerderstoestemming)	Ja	Vereist ga-stap	Vereist ga-stap

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

Voltooit alle stappen die het kan (infrastructuur, blauwdruk maken en overnemende machtigingen).
Hiermee worden URL's voor toestemming per resourcebeheerder gegenereerd en opgeslagen in a365.generated.config.json.
Geeft de volgende stappen weer die laten zien hoe een globale beheerder de OAuth2-toekenningen kan voltooien met behulp van a365 setup admin of de gegenereerde toestemmings-URL's.

Aanbeveling

Als u een globale beheerder bent, a365 setup all voltooit u alles in één uitvoering zonder hand-off nodig.

Minimaal vereiste machtigingen:

Inzender of eigenaar van Azure-abonnement (voor infrastructuur)
Rol agent-id-ontwikkelaar (voor het maken van een blauwdruk)
Globale beheerder (voor OAuth2-machtigingen verleent - indien niet beschikbaar, gebruik setup admin handoff)

`setup all` Opties

Optie	Description
`-c`, `--config <config>`	Pad naar configuratiebestand. De standaardwaarde is `a365.config.json`.
`-v`, `--verbose`	Gedetailleerde uitvoer weergeven.
`--dry-run`	Weergeven wat de opdracht zou doen zonder deze uit te voeren.
`--skip-infrastructure`	Sla het maken van Azure infrastructuur over (gebruik deze optie als de infrastructuur al bestaat). Met deze optie wordt nog steeds gemaakt: Blauwdruk en machtigingen.
`--skip-requirements`	Validatiecontrole van vereisten overslaan. Wees voorzichtig: de installatie kan mislukken als niet aan de vereisten wordt voldaan.
`-?`, , `-h--help`	Help- en gebruiksgegevens weergeven.

`setup admin`

Hiermee wordt de OAuth2-machtiging verleend (beheerderstoestemming) waarvoor globale beheerder is vereist. Voer deze opdracht uit nadat een agent-id-beheerder of agent-id-ontwikkelaar wordt uitgevoerd a365 setup all.

Minimaal vereiste machtigingen: globale beheerder

a365 setup admin [options]

Wanneer gebruikt u `setup admin`

Gebruik deze opdracht wanneer:

Nadat een agent-id-beheerder of agent-id-ontwikkelaar is uitgevoerd a365 setup all.
In het installatieoverzicht ziet u dat OAuth2-subsidies in behandeling zijn en geeft de globale beheerder de opdracht om deze opdracht uit te voeren.
U wilt toestemming opnieuw uitvoeren nadat u de machtigingen in de configuratie hebt gewijzigd.

Typische handoff-werkstroom

# Step 1: Agent ID Admin or Developer runs setup
a365 setup all

# The CLI displays next steps, for example:
# "ACTION REQUIRED — Global Administrator must complete OAuth2 grants"
# "Option 1: a365 setup admin --config-dir '<path-to-config-folder>'"
# "Option 2: Share the consent URL displayed above with your Global Administrator"

# Step 2: Agent ID Admin shares config folder with Global Administrator
# (contains a365.config.json and a365.generated.config.json)

# Step 3: Global Administrator completes the grants
a365 setup admin --config-dir "<path-to-config-folder>"

Deze opdracht:

Laadt standaard de configuratie van de agent uit de opgegeven map of de huidige map.
Leest de blauwdruk-id van de agent en geconfigureerde resourcemachtigingen van de gegenereerde configuratie.
Hiermee maakt u AllPrincipals OAuth2-machtigingen voor alle geconfigureerde resources, waaronder:
- Microsoft Graph (gedelegeerde bereiken)
- Agent 365 Tools (MCP-serverbereiken)
- Berichtenbot-API
- Waarneembaarheids-API
- Power Platform-API
- Aangepaste machtigingen die zijn gedefinieerd in uw configuratie
Geeft een bevestigingsprompt weer voordat u wijzigingen aanbrengt. Gebruik --yes dit om de prompt te omzeilen.

Waarschuwing

OAuth2-subsidies die met deze opdracht zijn gemaakt, zijn tenantbreed (consentType=AllPrincipals). Deze configuratie betekent dat alle gebruikers in de tenant de gedelegeerde machtigingen van de agent kunnen gebruiken. Controleer de vermelde bereiken zorgvuldig voordat u dit bevestigt.

`setup admin` Opties

Optie	Description
`-d`, `--config-dir <dir>`	Map met `a365.config.json` en `a365.generated.config.json`. Standaard ingesteld op huidige map.
`-v`, `--verbose`	Gedetailleerde uitvoer weergeven.
`--dry-run`	Weergeven wat de opdracht zou doen zonder deze uit te voeren.
`--skip-requirements`	Validatiecontrole van vereisten overslaan. Wees voorzichtig.
`-y`, `--yes`	Sla de bevestigingsprompt over en ga automatisch door.
`-?`, , `-h--help`	Help- en gebruiksgegevens weergeven.

In plaats van uit te voeren a365 setup admin, kan de globale beheerder de gecombineerde toestemmings-URL openen die a365 setup all wordt opgeslagen in a365.generated.config.json. Deze URL heeft betrekking op alle vereiste resources in één browserbezoek.

# Display the generated config to find the consent URL
a365 config display -g
# Look for: combinedAdminConsentUrl

Feedback

Is deze pagina nuttig?

Last updated on 2026-03-25

Delen via

Naslaginformatie over cli-opdrachten setup voor agent 365

Syntaxis

Options

Aanbevolen uitvoeringsvolgorde

setup requirements

requirements Opties

setup infrastructure

infrastructure Opties

setup blueprint

blueprint Opties

setup permissions

Options

Subcommands

setup permissions mcp

permissions mcp Opties

setup permissions bot

permissions bot Opties

setup permissions custom

permissions custom Opties

Aangepaste machtigingen configureren

Aangepaste machtigingen verwijderen

Integratie met setup all

setup permissions copilotstudio

permissions copilotstudio Opties

setup all

setup all Opties

setup admin

Wanneer gebruikt u setup admin

Typische handoff-werkstroom

setup admin Opties

Alternatief: toestemmings-URL

Feedback

Aanvullende resources

Naslaginformatie over cli-opdrachten `setup` voor agent 365

`setup requirements`

`requirements` Opties

`setup infrastructure`

`infrastructure` Opties

`setup blueprint`

`blueprint` Opties

`setup permissions`

`setup permissions mcp`

`permissions mcp` Opties

`setup permissions bot`

`permissions bot` Opties

`setup permissions custom`

`permissions custom` Opties

Integratie met `setup all`

`setup permissions copilotstudio`

`permissions copilotstudio` Opties

`setup all`

`setup all` Opties

`setup admin`

Wanneer gebruikt u `setup admin`

`setup admin` Opties