Share via


Setting up Agent 365 config

Important

You need to be part of the Frontier preview program to get early access to Microsoft Agent 365. Frontier connects you directly with Microsoft’s latest AI innovations. Frontier previews are subject to the existing preview terms of your customer agreements. As these features are still in development, their availability and capabilities may change over time.

The Agent 365 CLI needs to know your tenant, subscription and other details, to create the required agent resources like Agent Blueprint. This information is stored in a central configuration file in your working directory, called a365.config.json and this is used by all commands of the CLI.

Prerequisites

Before you begin, ensure you have the following:

Required permissions:

  • Valid Microsoft Entra tenant user with one of the following roles:
    • Global Administrator
    • Agent ID Administrator
    • Agent ID Developer
  • Access to an Azure subscription with permissions to create resources

Configure the Agent 365 CLI

The a365 config init command creates a365.config.json, the central configuration file used by all Agent 365 CLI commands, in your working directory. The CLI provides an interactive wizard with Azure CLI integration and smart defaults to minimize manual input.

Authenticate with Azure

Before initializing configuration, authenticate with Azure using the az login command:

az login

Select the appropriate subscription when prompted. The configuration wizard uses Azure CLI to query available subscriptions, resource groups, and app service plans. For smoothest development experience, please setup your tenant user account with the right role and permissions, subscription and app service plan before starting.

Initialize configuration

Run the following command to start the interactive configuration wizard:

a365 config init

The wizard uses Azure CLI integration and smart defaults to minimize manual input. You'll be prompted for:

Field Description Example
Agent name A unique identifier (alphanumeric only) myuniqueagentname123
Deployment project path Path to your agent project directory C:\MyAgent\sample-agent
Manager email Email of the manager overseeing this agent manager@AddYourTenantDomainHere.com
Azure resources Select from existing resource groups and app service plans (Interactive selection)

The wizard automatically generates related resource names, identities, and validates your project type.

Verify configuration

Use the a365 config display command to display your configuration to verify all values are correct. You can modify the values using the CLI or by directly editing the stored config file:

a365 config display

Learn more about the configuration file structure