Delen via

Naslaginformatie over cli-opdrachten 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
, , 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 gevonden problemen.

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.

Opties

Optie Description
, Pad naar configuratiebestand. De standaardwaarde is a365.config.json.
, Toont gedetailleerde uitvoer voor alle controles.
--category <category> Hiermee wordt alleen gecontroleerd op een specifieke categorie, zoals 'Azure', 'Verificatie' of 'Configuratie'.
, , Geeft help- en gebruiksgegevens weer.

setup infrastructure

Maak Azure infrastructuur.

Minimum vereiste machtigingen: Azure Abonnementsbijdrager of Eigenaar

a365 setup infrastructure [options]

Opties

Optie Description
, Pad naar configuratiebestand. De standaardwaarde is a365.config.json.
, Gedetailleerde uitvoer weergeven.
--dry-run Laat zien wat er zou gebeuren zonder uit te voeren.
, , 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]

Opties

Optie Description
, Pad naar configuratiebestand. De standaardwaarde is a365.config.json.
, Gedetailleerde uitvoer weergeven.
--dry-run Laat zien wat er zou gebeuren zonder uit te voeren.
--no-endpoint Berichteneindpunt niet registreren (alleen blauwdruk)
--endpoint-only Registreer alleen het berichteindpunt. Bestaande blauwdruk vereist
, , 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
, , 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]

Opties

Optie Description
, Pad naar configuratiebestand. De standaardwaarde is a365.config.json.
, Gedetailleerde uitvoer weergeven.
--dry-run Laat zien wat er zou gebeuren zonder uit te voeren.
, , 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 )

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

a365 setup permissions bot [options]

Opties

Optie Description
, Pad naar configuratiebestand. De standaardwaarde is a365.config.json.
, Gedetailleerde uitvoer weergeven.
--dry-run Laat zien wat er zou gebeuren zonder uit te voeren.
, , 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. Hierdoor heeft uw agent toegang tot extra Microsoft Graph bereiken (zoals aanwezigheid, bestanden, chat) of aangepaste API's die zijn geregistreerd in de Entra ID-tenant van uw organisatie.

Minimaal vereiste machtigingen: globale beheerder

Vereisten: Voer eerst uit . Voeg aangepaste machtigingen toe om deze te gebruiken 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 kunt u Microsoft Entra afstemmen met de huidige configuratie: nieuwe machtigingen toevoegen en alle machtigingen verwijderen die uit de configuratie zijn verwijderd.
  • Is idempotent en veilig om meerdere keren te worden uitgevoerd.

Opties

Optie Description
, Pad naar configuratiebestand. De standaardwaarde is a365.config.json.
, Gedetailleerde uitvoer weergeven.
--dry-run Laat zien wat er zou gebeuren zonder uit te voeren.
, , Geeft help- en gebruiksgegevens weer.

Aangepaste machtigingen configureren

Gebruik 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 en hoeft niet in de configuratie te worden opgegeven.

Aangepaste machtigingen verwijderen

Aangepaste machtigingen verwijderen uit zowel 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

Aangepaste machtigingen worden automatisch geconfigureerd wanneer u uitvoert als er aangepaste machtigingen aanwezig zijn in uw configuratie. 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 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 bereik.
  • Stelt overgenomen machtigingen in, zodat agentexemplaren Copilot Studio-copilots kunnen aanroepen.

Opties

Optie Description
, Pad naar configuratiebestand. De standaardwaarde is a365.config.json.
, Gedetailleerde uitvoer weergeven.
--dry-run Laat zien wat er zou gebeuren zonder uit te voeren.
, , 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)

Opties

Optie Description
, Pad naar configuratiebestand. De standaardwaarde is a365.config.json.
, 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.
, , Geeft help- en gebruiksgegevens weer.
  • Last updated on