Narzędzia serwera MCP Azure dla rozszerzeń Microsoft Foundry

Serwer Azure MCP umożliwia zarządzanie zasobami rozszerzenia Microsoft Foundry, w tym tworzenie czatu i uzupełniania tekstu, generowanie osadzania, wyświetlanie listy modeli i praca z indeksami wiedzy przy użyciu monitów języka naturalnego.

Microsoft Foundry to platforma do wdrażania niestandardowych modeli sztucznej inteligencji i zarządzania nimi w Azure. Udostępnia ona narzędzia i usługi do trenowania, dostrajania, wdrażania i monitorowania modeli sztucznej inteligencji w środowiskach produkcyjnych.

Polecenia dotyczące indeksu wiedzy wymagają punktu końcowego projektu Microsoft Foundry. Polecenia OpenAI wymagają nazwy zasobu i grupy zasobów. Polecenie get dla zasobów może wyświetlić listę zasobów bez podawania nazwy zasobu.

Note

parametry Tool: narzędzia Azure MCP Server definiują parametry danych potrzebnych do wykonywania zadań. Niektóre z tych parametrów są specyficzne dla każdego narzędzia i zostały opisane tutaj. Inne parametry są globalne i współużytkowane przez wszystkie narzędzia. Aby uzyskać więcej informacji, zobacz Parametry narzędzia.

Wiedza: Wyświetlanie listy indeksów wiedzy

Pobierz listę indeksów wiedzy z usługi Foundry:

  • Znajdź indeksy wiedzy utworzone w projektach foundry.
  • Użyj tych indeksów z agentami sztucznej inteligencji do pobierania wiedzy i aplikacji RAG.
  • Lista zostanie zaktualizowana podczas tworzenia nowych indeksów lub aktualizowania istniejących.

Przykładowe polecenie CLI

azmcp foundryextensions knowledge index list \
  --endpoint <endpoint>
Parameter Typ Required Description
endpoint ciąg Yes Adres URL punktu końcowego dla projektu lub usługi Microsoft Foundry. Punkt końcowy jest zgodny ze wzorcem: https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>.

Wskazówki dotyczące adnotacji narzędzia:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ✅ ❌ ✅ ❌ ❌

Wiedza: Uzyskiwanie schematu indeksu

Uzyskaj szczegółową konfigurację schematu określonego indeksu wiedzy z witryny Foundry.

Ta operacja przedstawia kompleksowe informacje o strukturze i konfiguracji indeksu wiedzy, w tym definicje pól, typy danych, atrybuty z możliwością wyszukiwania i inne właściwości schematu. Dzięki tym informacjom o schemacie możesz zrozumieć, jak struktury indeksów organizują i indeksują dane do wyszukiwania.

Przykładowe polecenie CLI

azmcp foundryextensions knowledge index schema \
  --index <index> \
  --endpoint <endpoint>
Parameter Typ Required Description
index ciąg Yes Nazwa indeksu wiedzy.
endpoint ciąg Yes Adres URL punktu końcowego dla projektu lub usługi Microsoft Foundry. Punkt końcowy jest zgodny ze wzorcem: https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>.

Wskazówki dotyczące adnotacji narzędzia:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ✅ ❌ ✅ ❌ ❌

OpenAI: tworzenie kompletnych odpowiedzi na czaty

Tworzenie uzupełniania czatu przy użyciu Azure OpenAI w narzędziu Foundry. Wysyłaj wiadomości do modeli czatu Azure OpenAI wdrożonych w zasobie Foundry i odbieraj odpowiedzi konwersacyjne generowane przez sztuczną inteligencję. Obsługuje konwersacje wieloturnowe z historią wiadomości, instrukcjami systemowymi i dostosowywaniem odpowiedzi.

Przykładowe polecenie CLI

azmcp foundryextensions openai chat-completions-create \
  --resource-name <resource-name> \
  --deployment <deployment> \
  --message-array <message-array> \
  --resource-group <resource-group> \
  [--max-tokens <max-tokens>] \
  [--temperature <temperature>] \
  [--top-p <top-p>] \
  [--frequency-penalty <frequency-penalty>] \
  [--presence-penalty <presence-penalty>] \
  [--stop <stop>] \
  [--stream <TRUE|FALSE>] \
  [--seed <seed>] \
  [--user <user>]
Parameter Typ Required Description
resource-name ciąg Yes Nazwa zasobu Microsoft Foundry.
deployment ciąg Yes Nazwa wdrożenia.
message-array ciąg Yes Tablica JSON zawierająca wiadomości w rozmowie. Każdy komunikat powinien mieć właściwości role i content.
resource-group ciąg Yes Nazwa grupy zasobów platformy Azure.
max-tokens liczba całkowita No Maksymalna liczba tokenów do wygenerowania w zakończeniu.
temperature number No Steruje losowością w danych wyjściowych. Niższe wartości sprawiają, że jest bardziej deterministyczny.
top-p number No Kontroluje różnorodność poprzez próbkowanie jądra (od 0,0 do 1,0). Wartość domyślna to 1.0.
frequency-penalty number No Karze nowe tokeny na podstawie ich częstotliwości (-2.0 do 2.0). Wartość domyślna to 0.
presence-penalty number No Karze nowe tokeny na podstawie obecności (-2.0 do 2.0). Wartość domyślna to 0.
stop ciąg No Maksymalnie 4 sekwencje, w których interfejs API przestaje generować kolejne tokeny.
stream boolean No Czy należy przesyłać strumieniowo częściowy postęp. Wartość domyślna to „false”. Jeśli przełącznik jest dołączany bez wartości, wartość domyślna to true.
seed liczba całkowita No Jeśli zostanie określony, system dokłada wszelkich starań, aby próbkować deterministycznie.
user ciąg No Identyfikator użytkownika do śledzenia i monitorowania nadużyć.

Wskazówki dotyczące adnotacji narzędzia:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ❌ ❌ ✅ ❌ ❌

OpenAI: tworzenie osadzeń

Tworzenie osadzeń przy użyciu Azure OpenAI w Foundry. Generowanie osadzania wektorów na podstawie tekstu przy użyciu wdrożeń platformy OpenAI Azure w zasobie rozwiązania Foundry na potrzeby wyszukiwania semantycznego, porównań podobieństw, klastrowania lub uczenia maszynowego.

Przykładowe polecenie CLI

azmcp foundryextensions openai embeddings-create \
  --resource-name <resource-name> \
  --deployment <deployment> \
  --input-text <input-text> \
  --resource-group <resource-group> \
  [--user <user>] \
  [--encoding-format <encoding-format>] \
  [--dimensions <dimensions>]
Parameter Typ Required Description
resource-name ciąg Yes Nazwa zasobu Microsoft Foundry.
deployment ciąg Yes Nazwa wdrożenia.
input-text ciąg Yes Tekst wejściowy do generowania osadzonych obiektów.
resource-group ciąg Yes Nazwa grupy zasobów platformy Azure.
user ciąg No Identyfikator użytkownika do śledzenia i monitorowania nadużyć.
encoding-format ciąg No Format zwracania osadzeń (float lub base64).
dimensions liczba całkowita No Liczba wymiarów dla wyjściowych danych osadzania. Obsługiwane tylko w niektórych modelach.

Wskazówki dotyczące adnotacji narzędzia:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ❌ ❌ ✅ ❌ ❌

OpenAI: tworzyć uzupełnienia

Twórz uzupełnienia tekstu przy użyciu usługi Azure OpenAI w Foundry. Wyślij monit lub pytanie do modeli Azure OpenAI wdrożonych w zasobie Foundry i otrzymuj wygenerowane odpowiedzi tekstowe. Użyj tej funkcji, gdy musisz utworzyć uzupełnienia, pobrać zawartość wygenerowaną przez sztuczną inteligencję, wygenerować odpowiedzi na pytania lub utworzyć uzupełnianie tekstu z Azure interfejsu OpenAI na podstawie dowolnego monitu wejściowego. Obsługuje dostosowywanie za pomocą parametrów: temperatury i maksymalnej liczby tokenów.

Przykładowe polecenie CLI

azmcp foundryextensions openai create-completion \
  --deployment <deployment> \
  --prompt-text <prompt-text> \
  --resource-name <resource-name> \
  --resource-group <resource-group> \
  [--max-tokens <max-tokens>] \
  [--temperature <temperature>]
Parameter Typ Required Description
deployment ciąg Yes Nazwa wdrożenia.
prompt-text ciąg Yes Tekst polecenia do wysłania do modelu uzupełniania.
resource-name ciąg Yes Nazwa zasobu Microsoft Foundry.
resource-group ciąg Yes Nazwa grupy zasobów platformy Azure.
max-tokens liczba całkowita No Maksymalna liczba tokenów do wygenerowania w zakończeniu.
temperature number No Steruje losowością w danych wyjściowych. Niższe wartości sprawiają, że jest bardziej deterministyczny.

Wskazówki dotyczące adnotacji narzędzia:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ❌ ❌ ✅ ❌ ❌

OpenAI: wyświetlanie listy modeli i wdrożeń

Wyświetl wdrożenia modeli Azure OpenAI w zasobie Microsoft Foundry. To narzędzie pobiera informacje o wdrożonych modelach, w tym nazwy modeli, wersje, możliwości i stan wdrożenia.

Przykładowe polecenie CLI

azmcp foundryextensions openai models-list \
  --resource-name <resource-name> \
  --resource-group <resource-group>
Parameter Typ Required Description
resource-name ciąg Yes Nazwa zasobu Microsoft Foundry.
resource-group ciąg Yes Nazwa grupy zasobów platformy Azure.

Wskazówki dotyczące adnotacji narzędzia:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ✅ ❌ ✅ ❌ ❌

Zasoby: Pobierz zasób usługi Foundry

Wyświetl lub pobierz zasoby Microsoft Foundry i zwraca szczegóły na poziomie zasobu, takie jak adres URL punktu końcowego, lokalizacja, jednostka SKU, rodzaj i stan aprowizacji. Jeśli podasz nazwę zasobu, narzędzie zwróci ten pojedynczy zasób. W przeciwnym razie zwraca inwentaryzację zasobów objętych zakresem. Aby uzyskać spis wdrożeń modeli w zasobie Foundry, użyj narzędzia OpenAI do wyświetlania listy modeli.

Przykładowe polecenie CLI

azmcp foundryextensions resource get \
  [--resource-name <resource-name>]
Parameter Typ Required Description
resource-name ciąg No Nazwa zasobu Microsoft Foundry.

Wskazówki dotyczące adnotacji narzędzia:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ✅ ❌ ✅ ❌ ❌