Skip to content

Commit 88ca656

Browse files
Merge pull request #260734 from eric-urban/eur/ai-cli-update
update ai cli
2 parents 47ea34b + d996e07 commit 88ca656

File tree

1 file changed

+32
-9
lines changed

1 file changed

+32
-9
lines changed

articles/ai-studio/how-to/cli-install.md

Lines changed: 32 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ ms.author: eur
1818

1919
The Azure AI command-line interface (CLI) is a cross-platform command-line tool to connect to Azure AI services and execute control-plane and data-plane operations without having to write any code. The Azure AI CLI allows the execution of commands through a terminal using interactive command-line prompts or via script.
2020

21-
You can easily use the Azure AI CLI to experiment with key Azure AI service features and see how they work with your use cases. Within minutes, you can set up all the required Azure resources needed, and build a customized Copilot using OpenAI's chat completions APIs and your own data. You can try it out interactively, or script larger processes to automate your own workflows and evaluations as part of your CI/CD system.
21+
You can easily use the Azure AI CLI to experiment with key Azure AI features and see how they work with your use cases. Within minutes, you can set up all the required Azure resources needed, and build a customized copilot using Azure OpenAI chat completions APIs and your own data. You can try it out interactively, or script larger processes to automate your own workflows and evaluations as part of your CI/CD system.
2222

2323
## Prerequisites
2424

@@ -36,29 +36,52 @@ The following set of commands are provided for a few popular operating systems.
3636

3737
# [Windows](#tab/windows)
3838

39-
To install the .NET SDK, Azure CLI, and Azure AI CLI, run the following commands in a PowerShell terminal. Skip any that you don't need.
39+
To install the .NET SDK, Azure CLI, and Azure AI CLI, run the following command.
4040

4141
```bash
4242
dotnet tool install --prerelease --global Azure.AI.CLI
4343
```
4444

45+
To update the Azure AI CLI, run the following command:
46+
47+
```bash
48+
dotnet tool update --prerelease --global Azure.AI.CLI
49+
```
50+
4551
# [Linux](#tab/linux)
4652

47-
On Debian and Ubuntu, run:
53+
To install the .NET SDK, Azure CLI, and Azure AI CLI on Debian and Ubuntu, run the following command:
4854

4955
```
5056
curl -sL https://aka.ms/InstallAzureAICLIDeb | bash
5157
```
5258

53-
# [macOS](#tab/macos)
59+
Alternatively, you can run the following command:
60+
61+
```bash
62+
dotnet tool install --prerelease --global Azure.AI.CLI
63+
```
5464

55-
On macOS, you can use *homebrew* and *wget*. For example, run the following commands in a terminal:
65+
To update the Azure AI CLI, run the following command:
5666

67+
```bash
68+
dotnet tool update --prerelease --global Azure.AI.CLI
69+
```
70+
71+
# [macOS](#tab/macos)
72+
73+
To install the .NET SDK, Azure CLI, and Azure AI CLI on macOS 10.14 or later, run the following command:
5774

5875
```bash
5976
dotnet tool install --prerelease --global Azure.AI.CLI
6077
```
6178

79+
To update the Azure AI CLI, run the following command:
80+
81+
```bash
82+
dotnet tool update --prerelease --global Azure.AI.CLI
83+
```
84+
6285
---
6386

6487
## Run the Azure AI CLI without installing it
@@ -109,8 +132,8 @@ The following table describes the scenarios for each flow.
109132

110133
| Scenario | Description |
111134
| --- | --- |
112-
| Initialize a new AI project | Choose if you don't have an existing AI project that you have been working with in the Azure AI Studio. `ai init` walks you through creating or attaching resources. |
113-
| Initialize an existing AI project | Choose if you have an existing AI project you want to work with. `ai init` checks your existing linked resources, and ask you to set anything that hasn't been set before. |
135+
| Initialize a new AI project | Choose if you don't have an existing AI project that you have been working with in the Azure AI Studio. The `ai init` command walks you through creating or attaching resources. |
136+
| Initialize an existing AI project | Choose if you have an existing AI project you want to work with. The `ai init` command checks your existing linked resources, and ask you to set anything that hasn't been set before. |
114137
| Initialize standalone resources| Choose if you're building a simple solution connected to a single AI service, or if you want to attach more resources to your development environment |
115138

116139
Working with an AI project is recommended when using the Azure AI Studio and/or connecting to multiple AI services. Projects come with an AI Resource that houses related projects and shareable resources like compute and connections to services. Projects also allow you to connect code to cloud resources (storage and model deployments), save evaluation results, and host code behind online endpoints. You're prompted to create and/or attach Azure AI Services to your project.
@@ -151,11 +174,11 @@ The following resources can be initialized standalone, or attached to projects:
151174

152175
## Project connections
153176

154-
When working the Azure AI CLI, you'll want to use your project's connections. Connections are established to attached resources and allow you to integrate services with your project. You can have project-specific connections, or connections shared at the Azure AI resource level. For more information, see [Azure AI resources](../concepts/ai-resources.md) and [connections](../concepts/connections.md).
177+
When working the Azure AI CLI, you want to use your project's connections. Connections are established to attached resources and allow you to integrate services with your project. You can have project-specific connections, or connections shared at the Azure AI resource level. For more information, see [Azure AI resources](../concepts/ai-resources.md) and [connections](../concepts/connections.md).
155178

156179
When you run `ai init` your project connections get set in your development environment, allowing seamless integration with AI services. You can view these connections by running `ai service connection list`, and further manage these connections with `ai service connection` subcommands.
157180

158-
Any updates you make to connections in the AI CLI will be reflected in the AI Studio, and vice versa.
181+
Any updates you make to connections in the Azure AI CLI is reflected in [Azure AI Studio](https://ai.azure.com), and vice versa.
159182

160183
## ai dev
161184

0 commit comments

Comments
 (0)