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.

Agent 365 CLI-configuratie beheren. Biedt opties voor het beheren van configuratie-instellingen voor agent 365 CLI. U kunt nieuwe configuraties interactief initialiseren of huidige configuratie-instellingen weergeven.

Minimale rol vereist: Geen (lokale configuratie)

Syntaxis

a365 config [command] [options]

Options

Optie	Description
, ,	Help- en gebruiksgegevens weergeven

config init

Configureer agent 365 CLI interactief of importeer uit een bestand.

a365 config init [options]

Gebruik deze opdracht om uw Agent 365 CLI-configuratie in te stellen via een interactief proces of door instellingen te importeren uit een bestaand configuratiebestand.

Opties

Optie	Description
,	Pad naar een bestaand configuratiebestand dat moet worden geïmporteerd
,	Configuratie maken in globale map (AppData) in plaats van in de huidige map
, ,	Help- en gebruiksgegevens weergeven

Opmerkingen

Met de opdracht wordt een interactieve wizard gestart waarmee handmatige invoer wordt geminimaliseerd:

• Azure CLI integratie: detecteert automatisch uw abonnement, tenant, resourcegroepen, App Service-plannen en regio's.
• Slimme standaardinstellingen: genereert resourcenamen op basis van uw agentnaam en een tijdstempel (bijvoorbeeld ). U kunt deze namen aanpassen voordat u opslaat.
• Platformdetectie: Detecteert uw projecttype (.NET, Node.js, Python) uit het pad van het implementatieproject en waarschuwt als er geen ondersteund type wordt gevonden.
• Validatie van client-app: valideert uw client-app-id voor uw Entra-tenant, waarbij wordt gecontroleerd of de vereiste machtigingen zijn geconfigureerd en beheerderstoestemming wordt verleend. U hebt maximaal drie pogingen voordat de wizard wordt afgesloten.

Custom-blauwdrukmachtigingen (optioneel): de wizard bevat een optionele stap voor het configureren van machtigingen voor aanvullende externe resources, zoals aanwezigheids- of OneDrive-bestanden van Teams. De meeste agents hebben dit niet nodig. U kunt ook machtigingen configureren na de eerste installatie met behulp van .

Bestaande configuratie bijwerken: de huidige wordt opnieuw geladen als standaardwaarde. Druk op Enter bij elke prompt om de huidige waarde te behouden of typ een nieuwe waarde om deze bij te werken.

config display

Huidige configuratie van agent 365 CLI weergeven.

a365 config display [options]

Met deze opdracht worden de huidige configuratie-instellingen voor de Agent 365 CLI weergegeven, zodat u uw huidige installatie kunt controleren.

Opties

Optie	Description
,	Gegenereerde configuratie weergeven (a365.generated.config.json)
,	Zowel statische als gegenereerde configuratie weergeven
, ,	Help- en gebruiksgegevens weergeven

Structuur van configuratiebestand

De CLI maakt gebruik van een JSON-configuratiebestand () met de volgende sleuteleigenschappen:

{
  "$schema": "./a365.config.schema.json",
  "tenantId": "your-tenant-id",
  "subscriptionId": "your-subscription-id",
  "resourceGroup": "rg-Agent 365-example",
  "location": "westus",
  "appServicePlanName": "asp-Agent 365-example",
  "appServicePlanSku": "B1",
  "webAppName": "webapp-Agent 365-example",
  "agentBlueprintDisplayName": "My Agent 365 Blueprint",
  "agentIdentityDisplayName": "My Agent 365 Agent",
  "agentUserPrincipalName": "agent@contoso.onmicrosoft.com",
  "agentUserDisplayName": "My Agent 365 User",
  "managerEmail": "manager@contoso.onmicrosoft.com",
  "agentUserUsageLocation": "US",
  "agentIdentityScopes": [
    "User.Read",
    "Mail.Send",
    "Calendars.ReadWrite",
    "Files.ReadWrite"
  ],
  "agentApplicationScopes": [
    "Mail.ReadWrite",
    "Chat.ReadWrite",
    "Sites.Read.All"
  ],
  "deploymentProjectPath": ".",
  "deploymentProjectFile": "YourProject.csproj",
  "botName": "my-Agent 365-bot",
  "botDescription": "My AI-powered agent for Microsoft 365 tasks"
}