次の方法で共有

Agent 365 CLI config コマンド リファレンス

Important

Microsoft Agent 365 の早期アクセスを利用するには、フロンティア プレビュープログラムに参加する必要があります。 Frontierはマイクロソフトの最新のAIイノベーションと直接つながります。 Frontierプレビューは既存の顧客契約のプレビュー条件の対象となります。 これらの機能はまだ開発段階であるため、利用可能性や機能は時間とともに変化する可能性があります。

エージェント 365 CLI 構成を管理します。 エージェント 365 CLI 構成設定を管理するためのオプションを提供します。 新しい構成は対話形式で初期化することも、現在の構成設定を表示することもできます。

最低限必要なロール: なし (ローカル構成)

構文

a365 config [command] [options]

オプション

Option Description
-?、-h、--help ヘルプと使用状況の情報を表示する

config init

エージェント 365 CLI を対話形式で構成するか、ファイルからインポートします。

a365 config init [options]

このコマンドを使用して、対話型プロセスまたは既存の構成ファイルから設定をインポートして、Agent 365 CLI 構成を設定します。

init のオプション

Option Description
-c、--configfile <configfile> インポートする既存の構成ファイルへのパス
-g、--global 現在のディレクトリではなくグローバル ディレクトリ (AppData) に構成を作成する
-?、-h、--help ヘルプと使用状況の情報を表示する

注釈

config init コマンドは、手動入力を最小限に抑える対話型ウィザードを起動します。

  • Azure CLI 統合: サブスクリプション、テナント、リソース グループ、App Service プラン、リージョンを自動的に検出します。
  • スマート既定値: エージェント名とタイムスタンプ (たとえば、 myagent-webapp-11140916) からリソース名を生成します。 保存する前に、これらの名前をカスタマイズできます。
  • Platform 検出: 展開プロジェクト パスからプロジェクトの種類 (.NET、Node.js、Python) を検出し、サポートされている種類が見つからない場合は警告を表示します。
  • クライアント アプリの検証: Entra テナントに対してクライアント アプリ ID を検証し、必要なアクセス許可が構成され、管理者の同意が付与されていることを確認します。 ウィザードが終了する前に、最大 3 回試行します。

Custom ブループリントのアクセス許可 (省略可能): ウィザードには、Teams の存在やOneDriveファイルなどの追加の外部リソースのアクセス許可を構成するオプションの手順が含まれています。 ほとんどのエージェントでは、この操作は必要ありません。 a365 config permissionsを使用して、初期セットアップ後にアクセス許可を構成することもできます。

既存の構成の更新: a365 config init 再実行すると、現在の a365.config.json が既定値として読み込まれます。 各プロンプトで Enter キー を押して現在の値を保持するか、新しい値を入力して更新します。

config display

現在の Agent 365 CLI 構成を表示します。

a365 config display [options]

このコマンドは、現在のセットアップを確認できるように、Agent 365 CLI の現在の構成設定を表示します。

display のオプション

Option Description
-g、--generated 生成された構成を表示する (a365.generated.config.json)
-a、--all 静的構成と生成された構成の両方を表示する
-?、-h、--help ヘルプと使用状況の情報を表示する

構成ファイルの構造

CLI では、次の主要なプロパティを含む JSON 構成ファイル (a365.config.json) が使用されます。

{
  "$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"
}
  • Last updated on