Dokumentacja poleceń interfejsu wiersza polecenia develop agenta 365

Ważne

Aby uzyskać wczesny dostęp do programu Microsoft Agent 365, musisz być częścią programu Frontier w wersji zapoznawczej. Usługa Frontier łączy Cię bezpośrednio z najnowszymi innowacjami firmy Microsoft dotyczącymi sztucznej inteligencji. Wersje zapoznawcze platformy Frontier podlegają istniejącym warunkom obowiązywania wersji zapoznawczej umów klienta. Ponieważ te funkcje są nadal opracowywane, ich dostępność i możliwości mogą ulec zmianie w miarę upływu czasu.

Zarządzanie serwerami narzędzi MCP na potrzeby tworzenia agentów. Polecenie develop udostępnia opcje zarządzania serwerami narzędzi MCP (Model Context Protocol) na potrzeby tworzenia agentów. Możesz wyświetlić listę dostępnych serwerów, wyświetlić skonfigurowane serwery i dodać lub usunąć serwery MCP z konfiguracji agenta.

Wymagana minimalna rola: Brak (lokalne zarządzanie manifestem)

Składnia

a365 develop [command] [options]

Opcje

Option	Description
-c, --config <config>	Ścieżka pliku konfiguracji. Ustawienie domyślne: a365.config.json
-v, --verbose	Włącz szczegółowe logowanie
-?, , -h--help	Pokaż informacje o pomocy i użyciu.

develop list-available

Wyświetl listę wszystkich serwerów MCP dostępnych w katalogu (co można zainstalować).

a365 develop list-available [options]

To polecenie wyświetla wszystkie serwery MCP, które są dostępne w katalogu i można je zainstalować do użycia z programowaniem agenta.

list-available Opcje

Option	Description
-c, --config <config>	Ścieżka pliku konfiguracji. Ustawienie domyślne: a365.config.json
--dry-run	Pokaż, co można zrobić za pomocą polecenia bez jego wykonania.
--skip-auth	Pomiń uwierzytelnianie. Tylko do testowania. Polecenie prawdopodobnie kończy się niepowodzeniem bez prawidłowego uwierzytelniania.
-?, , -h--help	Pokaż informacje o pomocy i użyciu.

develop list-configured

Lista aktualnie skonfigurowanych serwerów MCP z lokalnego ToolingManifest.jsonprogramu .

a365 develop list-configured [options]

To polecenie pokazuje wszystkie serwery MCP, które są obecnie skonfigurowane w lokalnym pliku ToolingManifest.json.

list-configured Opcje

Option	Description
-c, --config <config>	Ścieżka pliku konfiguracji. Ustawienie domyślne: a365.config.json
--dry-run	Pokaż, co można zrobić za pomocą polecenia bez jego wykonania.
-?, , -h--help	Pokaż informacje o pomocy i użyciu.

develop add-mcp-servers

Dodaj serwery MCP do bieżącej konfiguracji agenta.

a365 develop add-mcp-servers [<servers>...] [options]

To polecenie dodaje określone serwery MCP do ToolingManifest.json folderu projektu. Nie udziela uprawnień do strategii agenta.

Ważne

To polecenie aktualizuje ToolingManifest.json tylko — nie udziela uprawnień do strategii agenta. Sposób stosowania uprawnień zależy od tego, gdzie jesteś w procesie instalacji:

• Przed początkową konfiguracją: przejdź do a365 setup all. Uprawnienia mcP są stosowane w ramach początkowego tworzenia strategii.
• Po utworzeniu strategii: administrator globalny musi uruchomić a365 setup permissions mcp oddzielnie. Administrator musi najpierw uruchomić polecenie a365 config display , aby sprawdzić, czy deploymentProjectPath w swoich a365.config.json punktach do folderu projektu zawierającego zaktualizowany ToolingManifest.jsonelement .

add-mcp-servers Argumenty

Określ co najmniej jedną nazwę serwera MCP, aby dodać je do konfiguracji agenta. Można podać wiele nazw serwerów rozdzielonych spacjami.

Argument	Description
<servers>	Nazwy serwerów MCP do dodania

add-mcp-servers Opcje

Użyj tych opcji, aby dostosować zachowanie add-mcp-servers polecenia, w tym wybór pliku konfiguracji i testowanie w trybie suchym.

Option	Description
-c, --config <config>	Ścieżka pliku konfiguracji. Ustawienie domyślne: a365.config.json
--dry-run	Pokaż, co można zrobić za pomocą polecenia bez jego wykonania.
-?, , -h--help	Pokaż informacje o pomocy i użyciu.

develop remove-mcp-servers

Usuń serwery MCP z bieżącej konfiguracji agenta.

a365 develop remove-mcp-servers [<servers>...] [options]

To polecenie usuwa określone serwery MCP z bieżącej konfiguracji agenta.

remove-mcp-servers Argumenty

Argument	Description
<servers>	Nazwy serwerów MCP do usunięcia

remove-mcp-servers Opcje

Option	Description
-c, --config <config>	Ścieżka pliku konfiguracji. Ustawienie domyślne: a365.config.json
--dry-run	Pokaż, co można zrobić za pomocą polecenia bez jego wykonania.
-?, , -h--help	Pokaż informacje o pomocy i użyciu.

develop add-permissions

Dodaj uprawnienia interfejsu API serwera MCP do Microsoft Entra aplikacji na potrzeby scenariuszy programowania, w których należy skonfigurować aplikacje niestandardowe w celu uzyskiwania dostępu do serwerów MCP.

a365 develop add-permissions [options]

add-permissions Opcje

Użyj tych opcji, aby dodać wymagane uprawnienia interfejsu API i zakresy do rejestracji aplikacji, korzystając z wartości z manifestu narzędzi.

Option	Description
-c, --config <config>	Ścieżka pliku konfiguracji (wartość domyślna: a365.config.json)
-m, --manifest <manifest>	Ścieżka do ToolingManifest.json (wartość domyślna: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id>	Identyfikator aplikacji (klienta) w celu dodania uprawnień do (ustawienie domyślne: clientAppId z konfiguracji)
--scopes <scopes>	Określone zakresy do dodania (oddzielone spacjami) (ustawienie domyślne: Wszystkie zakresy z ToolingManifest.json)
--dry-run	Pokaż, co można zrobić za pomocą polecenia bez wprowadzania zmian
-v, --verbose	Pokaż szczegółowe dane wyjściowe
-?, , -h--help	Pokaż informacje o pomocy i użyciu.

Ważne

Aplikacja określona przez --app-id lub clientAppId musi mieć uprawnienie Application.ReadWrite.All w Microsoft Entra. To polecenie dotyczy niestandardowych aplikacji klienckich. Aby skonfigurować uprawnienia dla strategii agentów, użyj a365 setup permissions mcp zamiast tego.

develop get-token

Pobieranie tokenów elementu nośnego na potrzeby testowania serwerów MCP podczas programowania przy użyciu uwierzytelniania interakcyjnego przeglądarki.

a365 develop get-token [options]

get-token Opcje

Użyj tych opcji, aby zażądać tokenu dostępu, zakresów kontroli, zachowania odświeżania i wybrać format danych wyjściowych.

Option	Description
-c, --config <config>	Ścieżka pliku konfiguracji (wartość domyślna: a365.config.json)
--app-id <app-id>	Identyfikator aplikacji (klienta) na potrzeby uwierzytelniania (ustawienie domyślne: clientAppId z konfiguracji)
-m, --manifest <manifest>	Ścieżka do ToolingManifest.json (wartość domyślna: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes>	Określone zakresy do żądania (oddzielone spacjami) (ustawienie domyślne: Odczyt z ToolingManifest.json)
-o, --output <output>	Format danych wyjściowych: table, jsonlub raw (wartość domyślna: table)
--force-refresh	Wymuszanie odświeżania tokenu przez pomijanie pamięci podręcznej
--resource <resource>	Słowo kluczowe zasobu do pobrania tokenu dla: mcp (ustawienie domyślne) lub powerplatform
--resource-id <resource-id>	Niestandardowy identyfikator aplikacji zasobów (GUID) dla zasobów, które nie są objęte --resource słowami kluczowymi
-v, --verbose	Pokaż szczegółowe dane wyjściowe, w tym pełny token
-?, , -h--help	Pokaż informacje o pomocy i użyciu.

get-token opcje zasobu

Użyj opcji --resource i --resource-id, aby uzyskać tokeny dla różnych zasobów Azure:

• --resource: Użyj słowa kluczowego, aby wybrać wstępnie zdefiniowany zasób:
  • mcp (ustawienie domyślne): Agent 365 Tools for MCP servers (Domyślnie): Agent 365 Tools for MCP servers (domyślnie): Agent 365 Tools for MCP
  • powerplatform: Interfejs API platformy Power Platform
• --resource-id: Wprowadź niestandardowy identyfikator aplikacji zasobu (GUID) dla zasobów, które nie są objęte słowami kluczowymi

Ważne

--resource i --resource-id nie można ich używać razem. Jeśli używasz jednej z opcji, uwzględnij element --scopes. Tylko domyślny przepływ MCP obsługuje rozpoznawanie zakresu opartego na manifeście.

develop start-mock-tooling-server

Uruchom pozorny serwer narzędzi na potrzeby testowania i programowania.

a365 develop start-mock-tooling-server [options]

To polecenie uruchamia pozorny serwer narzędzi na potrzeby testowania i programowania. Korzystając z tego serwera, można symulować interakcje serwera MCP bez konieczności rzeczywistych implementacji serwera.

start-mock-tooling-server Opcje

Użyj tych opcji, aby dostosować zachowanie start-mock-tooling-server polecenia.

Option	Description	Default
-p, --port <port>	Numer portu dla makiety serwera	5309
-v, --verbose	Włącz szczegółowe logowanie	false
-?, -h, --help	Pokaż informacje pomocy i użycia	-
-bg	Uruchamianie serwera w nowym terminalu	-