Delen via

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.

Minimumrol vereist: Azure Inzender + Global Administrator

Syntaxis

a365 setup [command] [options]

Options

Optie Description
-?, , -h--help Geeft help- en gebruiksgegevens weer. 
# 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

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 Geeft help- en gebruiksgegevens weer.

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 Laat zien wat er zou gebeuren zonder uit te voeren.
-?, , -h--help Geeft help- en gebruiksgegevens weer.

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 Laat zien wat er zou gebeuren zonder 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 Geeft help- en gebruiksgegevens weer.

setup permissions

OAuth2-machtigingen verlenen en overnemende machtigingen configureren.

Minimaal vereiste machtigingen: globale beheerder

a365 setup permissions [command] [options]

Options

Optie Description
-?, , -h--help Geeft help- en gebruiksgegevens weer.

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 Laat zien wat er zou gebeuren zonder uit te voeren.
-?, , -h--help Geeft help- en gebruiksgegevens weer.

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 Laat zien wat er zou gebeuren zonder uit te voeren.
-?, , -h--help Geeft help- en gebruiksgegevens weer.

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 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 worden Microsoft Entra met de huidige configuratie afgestemd door nieuwe machtigingen toe te voegen en machtigingen te verwijderen die zijn verwijderd uit de configuratie.
  • 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 Laat zien wat er zou gebeuren zonder uit te voeren.
-?, , -h--help Geeft help- en gebruiksgegevens weer.

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

De resourcenaam wordt automatisch omgezet vanuit Azure tijdens de installatie. 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. De volledige installatievolgorde is:

  1. Infrastructuur
  2. Blueprint
  3. MCP-machtigingen
  4. Bot-API-machtigingen
  5. Aangepaste blauwdrukmachtigingen (indien geconfigureerd)
  6. Berichtverzendingspunt

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 Laat zien wat er zou gebeuren zonder uit te voeren.
-?, , -h--help Geeft help- en gebruiksgegevens weer.

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, Machtigingen en Eindpunt.

Minimaal vereiste machtigingen (globale beheerder heeft al deze machtigingen):

  • Azure Inzender voor abonnementen (voor infrastructuur en eindpunt)
  • Rol agent-id-ontwikkelaar (voor het maken van een blauwdruk)
  • Globale beheerder (voor machtigingstoestemming en beheerderstoestemming)

setup all Opties

Optie Description
-c, --config <config> Pad naar configuratiebestand. De standaardwaarde is a365.config.json.
-v, --verbose Gedetailleerde uitvoer weergeven.
--dry-run Laat zien wat er zou gebeuren zonder 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, machtigingen en eindpunt.
--skip-requirements Validatiecontrole van vereisten overslaan. Wees voorzichtig: de installatie kan mislukken als niet aan de vereisten wordt voldaan.
-?, , -h--help Geeft help- en gebruiksgegevens weer.
  • Last updated on