Jak nainstalovat nástroj rozhraní příkazového řádku ML.NET (CLI)How to install the ML.NET Command-Line Interface (CLI) tool

ML.NET CLI (rozhraní příkazového řádku) je nástroj, který můžete spustit na jakémkoli příkazovém řádku (Windows, Mac nebo Linux) pro vytváření kvalitních ML.NET modelů a zdrojového kódu na základě školení datových sad, které poskytnete.The ML.NET CLI (command-line interface) is a tool you can run on any command-prompt (Windows, Mac, or Linux) for generating good quality ML.NET models and source code based on training datasets you provide.

Poznámka

Toto téma odkazuje na ML.NET CLI a ML.NET AutoML, které jsou momentálně ve verzi Preview, a materiál může být změněn.This topic refers to ML.NET CLI and ML.NET AutoML, which are currently in Preview, and material may be subject to change.

PředpokladyPre-requisites

Můžete buď spustit vygenerované C# projekty kódu v aplikaci Visual Studio F5 nebo pomocí dotnet run (.NET Core CLI).You can either run the generated C# code projects with Visual Studio F5 or with dotnet run (.NET Core CLI).

Poznámka: když po instalaci sady .NET Core 2,2 SDK nefunguje příkaz dotnet tool, odhlaste se z Windows a znovu se přihlaste.Note: If after installing .NET Core 2.2 SDK the dotnet tool command is not working, sign out from Windows and sign in again.

InstalaceInstall

Rozhraní příkazového řádku ML.NET je nainstalováno jako jakýkoli jiný globální nástroj dotnet.The ML.NET CLI is installed like any other dotnet Global Tool. Použijete příkaz dotnet tool install .NET Core CLI.You use the dotnet tool install .NET Core CLI command.

Následující příklad ukazuje, jak nainstalovat rozhraní příkazového řádku ML.NET ve výchozím umístění informačního kanálu NuGet:The following example shows how to install the ML.NET CLI in the default NuGet feed location:

dotnet tool install -g mlnet

Pokud nástroj není možné nainstalovat (to znamená, pokud není k dispozici ve výchozím kanálu NuGet), zobrazí se chybové zprávy.If the tool can't be installed (that is, if it is not available at the default NuGet feed), error messages are displayed. Ověřte, zda jsou kontrolovány informační kanály, které jste očekávali.Check that the feeds you expected are being checked.

Pokud je instalace úspěšná, zobrazí se zpráva s příkazem použitým pro volání nástroje a nainstalované verze, podobně jako v následujícím příkladu:If installation is successful, a message is displayed showing the command used to call the tool and the version installed, similar to the following example:

You can invoke the tool using the following command: mlnet
Tool 'mlnet' (version 'X.X.X') was successfully installed.

Instalaci můžete ověřit tak, že zadáte následující příkaz:You can confirm the installation was successful by typing the following command:

mlnet

Měli byste vidět nápovědu k dostupným příkazům pro nástroj mlnet, jako je například příkaz Auto-vlak.You should see the help for available commands for the mlnet tool such as the 'auto-train' command.

Instalace konkrétní vydané verzeInstall a specific release version

Pokud se pokoušíte nainstalovat předběžnou verzi nebo konkrétní verzi nástroje, můžete určit rozhraní pomocí následujícího formátu:If you're trying to install a pre-release version or a specific version of the tool, you can specify the framework using the following format:

dotnet tool install -g mlnet --framework <FRAMEWORK>

Můžete také zjistit, jestli je balíček správně nainstalovaný, zadáním následujícího příkazu:You can also check if the package is properly installed by typing the following command:

dotnet tool list -g

Odinstalace balíčku CLIUninstall the CLI package

Zadejte následující příkaz pro odinstalaci balíčku z místního počítače:Type the following command to uninstall the package from your local machine:

dotnet tool uninstall mlnet -g

Aktualizace balíčku CLIUpdate the CLI package

Zadáním následujícího příkazu aktualizujete balíček z místního počítače:Type the following command to update the package from your local machine:

dotnet tool update -g mlnet

Nastavení návrhů CLI (automatické dokončování založené na kartě)Set up CLI suggestions (tab-based auto-completion)

Vzhledem k tomu, že rozhraní příkazového řádku ML.NET je založené na System.CommandLine, má vestavěnou podporu pro dokončování karet.Since the ML.NET CLI is based on System.CommandLine, it has built-in support for tab completion.

Příklad toho, jak funguje automatické dokončování karet, je znázorněno v následující animaci:An example of how tab auto completion works is shown in the following animation:

obrázek

Automatické dokončování na kartě (návrhy parametrů) funguje v prostředí Windows PowerShell a MacOS/Linux bash , ale nebude fungovat na Windows CMD.'Tab-based auto-completion' (parameter suggestions) works on Windows PowerShell and macOS/Linux bash but it won't work on Windows CMD.

Aby ho bylo možné povolit, musí koncový uživatel v aktuální verzi Preview pro každé prostředí provést několik kroků, které jsou uvedené níže.To enable it, in the current preview version, the end user has to take a few steps once per shell, outlined below. Až to uděláte, dokončování budou fungovat pro všechny aplikace napsané pomocí System.CommandLine, jako je ML.NET CLI.Once this is done, completions will work for all apps written using System.CommandLine such as the ML.NET CLI.

V počítači, ve kterém chcete povolit dokončování, budete muset provést dvě věci.On the machine where you'd like to enable completion, you'll need to do two things.

  1. Pomocí následujícího příkazu nainstalujte nástroj dotnet-suggest Global:Install the dotnet-suggest global tool by running the following command:

    dotnet tool install dotnet-suggest -g
    
  2. Přidejte příslušný skript pro překrytí do profilu prostředí.Add the appropriate shim script to your shell profile. Možná budete muset vytvořit soubor profilu prostředí.You may have to create a shell profile file. Skript překrytí přepošle žádosti o dokončení z vašeho prostředí na nástroj dotnet-suggest, který se deleguje na příslušnou aplikaci založenou na System.CommandLine.The shim script will forward completion requests from your shell to the dotnet-suggest tool, which delegates to the appropriate System.CommandLine-based app.

    • V případě bash přidejte obsah pole dotnet-navrhuje-Shim. bash do ~/.bash_profile.For bash, add the contents of dotnet-suggest-shim.bash to ~/.bash_profile.

    • V případě PowerShellu přidejte do svého profilu PowerShellu obsah dotnet-Suggest-Shim. ps1 .For PowerShell, add the contents of dotnet-suggest-shim.ps1 to your PowerShell profile. Očekávanou cestu k profilu PowerShellu můžete najít spuštěním následujícího příkazu v konzole:You can find the expected path to your PowerShell profile by running the following command in your console:

    echo $profile
    

(Pro další prostředí vyhledejte nebo otevřete problém.)(For other shells, look for or open an issue.)

Instalační adresářInstallation directory

ML.NET CLI se dá nainstalovat do výchozího adresáře nebo do konkrétního umístění.The ML.NET CLI can be installed in the default directory or in a specific location. Výchozí adresáře jsou:The default directories are:

JINÉHOOS CestaPath
Linux/macOSLinux/macOS $HOME/.dotnet/tools
WindowsWindows %USERPROFILE%\.dotnet\tools

Tato umístění jsou přidána do cesty uživatele při prvním spuštění sady SDK, takže je možné nainstalovanou sadu globálních nástrojů volat přímo.These locations are added to the user's path when the SDK is first run, so Global Tools installed there can be called directly.

Poznámka: globální nástroje jsou specifické pro uživatele, ne jako globální počítač.Note: the Global Tools are user-specific, not machine global. To znamená, že nemůžete nainstalovat globální nástroj, který je k dispozici pro všechny uživatele počítače.Being user-specific means you cannot install a Global Tool that is available to all users of the machine. Nástroj je k dispozici pouze pro každý profil uživatele, ve kterém byl nástroj nainstalován.The tool is only available for each user profile where the tool was installed.

Globální nástroje je také možné nainstalovat do konkrétního adresáře.Global Tools can also be installed in a specific directory. Při instalaci do konkrétního adresáře musí uživatel ověřit, zda je příkaz k dispozici, zahrnutím tohoto adresáře do cesty, voláním příkazu se zadaným adresářem nebo voláním nástroje ze zadaného adresáře.When installed in a specific directory, the user must ensure the command is available, by including that directory in the path, by calling the command with the directory specified, or calling the tool from within the specified directory. V takovém případě .NET Core CLI nepřidá toto umístění automaticky do proměnné prostředí PATH.In this case, the .NET Core CLI doesn't add this location automatically to the PATH environment variable.

Viz také:See also