nástroje Azure MCP Server pro rozšíření Microsoft Foundry

Server Azure MCP umožňuje spravovat prostředky Microsoft Foundry Extensions, včetně vytváření chatu a dokončování textu, generování vkládání, výpis modelů a práce s indexy znalostí s výzvami v přirozeném jazyce.

Microsoft Foundry je platforma pro nasazování a správu vlastních modelů AI v Azure. Poskytuje nástroje a služby pro trénování, vyladění, nasazování a monitorování modelů AI v produkčních prostředích.

Při připojování k prostředku Microsoft Foundry vyžaduje Azure MCP Server endpoint nebo skupinu zdroj prostředku Microsoft Foundry. U operací, které nevyžadují konkrétní prostředek, jako je výpis dostupných modelů, se nevyžaduje ani koncový bod ani skupina prostředků.

Note

Parametry nástrojů: Nástroje Azure MCP Server definují parametry potřebné pro data k dokončení úkolů. Některé z těchto parametrů jsou specifické pro každý nástroj a jsou zde popsané. Ostatní parametry jsou globální a sdílejí všechny nástroje. Další informace naleznete v tématu Parametry nástroje.

Znalost: Výpis indexů znalostí

Získejte seznam indexů znalostí z Foundry:

  • Najděte si indexy znalostí vytvořené v projektech Foundry.
  • Tyto indexy můžete použít s agenty AI pro načítání znalostí a aplikace RAG.
  • Seznam se aktualizuje při vytváření nových indexů nebo při aktualizaci existujících indexů.

Mezi ukázkové výzvy patří:

  • Zobrazit všechny indexy: Zobrazit všechny indexy znalostí na koncovém boduhttps://my-example-resource.services.ai.azure.com/api/projects/my-project
  • Filtrovat podle projektu: Seznam indexů znalostí na koncovém boduhttps://my-example-resource.services.ai.azure.com/api/projects/support-bot
  • Vyhledejte podle názvu: "Vyhledání indexu znalostí s názvem product-faqs na koncovém bodu "https://my-example-resource.services.ai.azure.com/api/projects/my-project".
  • Filtrovat podle značky: Seznam indexů znalostí označených příznakem security u koncového boduhttps://my-example-resource.services.ai.azure.com/api/projects/my-project
  • Zobrazit podrobnosti indexu: "Zobrazit podrobnosti pro index znalostí 'customer-service' na koncovém bodu 'https://my-example-resource.services.ai.azure.com/api/projects/my-project'"
Parameter Povinné nebo volitelné Description
Koncový bod Required Adresa URL koncového bodu pro projekt nebo službu Foundry ve formátu https://<resource>.services.ai.azure.com/api/projects/<project-name>

Tipy k anotacím nástroje:

Destruktivní Idempotentní Open World Jen pro čtení Secret Vyžadováno místní
❌ ✅ ❌ ✅ ❌ ❌

Znalost: Získání schématu indexu

Získejte podrobnou konfiguraci schématu konkrétního indexu znalostí z Foundry.

Tato operace ukazuje komplexní informace o struktuře a konfiguraci indexu znalostí, včetně definic polí, datových typů, prohledávatelných atributů a dalších vlastností schématu. Tyto informace o schématu vám pomohou pochopit, jak struktury a indexy indexují vaše data pro vyhledávání.

Mezi ukázkové výzvy patří:

  • Zobrazit schéma indexu: "Ukaž mi schéma pro index znalostí 'product-facts' při koncovém bodě 'https://my-example-resource.services.ai.azure.com/api/projects/my-project'"
Parameter Povinné nebo volitelné Description
Koncový bod Required Adresa URL koncového bodu pro projekt nebo službu Foundry ve formátu https://<resource>.services.ai.azure.com/api/projects/<project-name>
Index Required Název indexu znalostí.

Tipy k anotacím nástroje:

Destruktivní Idempotentní Open World Jen pro čtení Secret Vyžadováno místní
❌ ✅ ❌ ✅ ❌ ❌

OpenAI: Vytváření odpovědí v chatu

Vytvářejte dokončování chatu pomocí Azure OpenAI v Foundry. Odesílat zprávy do modelů OpenAI pro chatování na Azure nasazených ve vašem prostředku Foundry a přijímat AI-generované konverzační odpovědi. Podporuje více konverzací pomocí historie zpráv, systémových pokynů a přizpůsobení odpovědí.

Mezi ukázkové výzvy patří:

  • Jednoduchý pozdrav: "Vytvořte dokončení chatu s polem zpráv '[{"role":"user","content":"Ahoj, jak se dnes máte?"}]' pomocí nasazení 'gpt-35-turbo' na prostředku 'openai-prod'"
  • Se zprávou systému: "Vytvořte dokončení chatu se systémovou zprávou 'Jste užitečný asistent' a uživatelskou zprávou 'Vysvětlit kvantové výpočty' použitím nasazení 'gpt-35-turbo' na prostředku 'openai-west'"
  • Kontrola kreativity: "Generování zhotovení chatu pro 'psaní kreativního příběhu' pomocí modelu gpt-4 s teplotou 0,8 a max. 150 tokenů na zdroji 'ai-central'"
  • Deterministická odpověď: "Vytvořte dokončení chatu se zprávou “Seznam 5 faktů o Marsu” s použitím nasazení 'gpt-35-turbo' s teplotou 0.1 a se startovacím klíčem 12345 u prostředku 'ai-services-prod'"
  • Konverzace s historií: "Pokračovat v dokončování chatu se zprávami: systém 'Jsem váš asistent pro kódování', uživatel 'Jak vytvořím funkci v Pythonu?', asistent 'Tady je návod...', uživatel 'Můžete zobrazit příklad?'" pomocí nasazení 'gpt-4' na prostředku 'dev-openai'
  • S sankcemi za opakování: "Vytvořit dokončení pro 'Popis výhod cloud computingu' pomocí nasazení 'gpt-35-turbo' s penále za frekvenci 0,5 a penále za přítomnost 0,3 na zdroji 'ai-services-main'".
  • Streamovaná odpověď: Generování streamovaného dokončení chatu pro 'Vysvětlení strojového učení krok za krokem' pomocí nasazení 'gpt-4' s aktivním streamováním na prostředku 'openai-research'.
  • S sekvencemi zastavení: "Vytvoření dokončení pro 'Počítejte od 1 do 10' s nasazením 'gpt-35-turbo' s použitím sekvencí zastavení ['5', 'STOP'] na zdroji 'ai-test'"
  • Sledování uživatelů: "Vygenerovat dokončení pro 'Co je Azure AI?'" pomocí nasazení 'gpt-4' s uživatelským identifikátorem 'user-123' na zdroji 'prod-openai'
  • Jemné vyladění kontroly: Vytvoření dokončování chatu pro "Shrnutí tohoto článku" s využitím nasazení 'gpt-35-turbo' s teplotou 0.2, top_p 0.9, maximálním počtem tokenů 200 a ověřováním AAD u prostředku 'secure-ai'
Parameter Povinné nebo volitelné Description
Skupina zdrojů Required Název skupiny prostředků.
Název prostředku Required Název prostředku Azure OpenAI.
Nasazení Required Název nasazení modelu Foundry.
Pole zpráv Required Pole zpráv v konverzaci (formát JSON) Každá zpráva by měla mít role a content vlastnosti.
Maximální počet tokenů Optional Maximální počet tokenů, které se mají vygenerovat v dokončení.
Teplota Optional Řídí náhodnost ve výstupu. Nižší hodnoty z něj činí determinističtější.
Horní p Optional Řídí rozmanitost odběrem vzorků z jádra (0,0 až 1,0). Výchozí hodnota je 1.0.
Penalizace četnosti Optional Penalizuje nové tokeny na základě jejich frekvence (-2.0 až 2.0). Výchozí hodnota je 0.
Trest přítomnosti Optional Penalizuje nové tokeny na základě přítomnosti (-2.0 až 2.0). Výchozí hodnota je 0.
Stop Optional Až 4 sekvence, ve kterých rozhraní API přestane generovat další tokeny.
Stream Optional Zda se má streamovat zpět částečný průběh. Výchozí hodnota je false.
Semeno Optional Pokud je zadáno, systém se bude snažit vzorkovat deterministicky.
User Optional Volitelný identifikátor uživatele pro sledování a sledování zneužití

Tipy k anotacím nástroje:

Destruktivní Idempotentní Open World Jen pro čtení Secret Vyžadováno místní
❌ ❌ ❌ ✅ ❌ ❌

OpenAI: Vytváření embeddingů

Vytváření vložených objektů pomocí Azure OpenAI v Foundry Generování vektorových embeddingů z textu pomocí nasazení OpenAI v Azure ve vašem prostředku Foundry pro sémantické vyhledávání, porovnání podobnosti, shlukování nebo strojové učení.

Mezi ukázkové výzvy patří:

  • Basic text embedding: "Vygenerovat vnoření pro text 'Azure OpenAI Service' pomocí mého nasazení 'text-embedding-ada-002' ve skupině zdrojů 'my-resource-group'"
  • Vytvořit vektorová zapouzdření: Vytvořit vektorová zapouzdření pro můj text pomocí Azure OpenAI s nasazením 'text-embedding-3-large' na prostředku 'ai-services-prod' ve skupině prostředků 'my-resource-group'
  • Embedování dokumentů: Generování embedování pro 'Strojové učení mění analýzu dat' pomocí nasazení 'ada-002' u prostředku 'embedding-service' ve skupině prostředků 'my-resource-group'
  • Více vět: "Vytvořit embeddingy pro text 'Cloud computing poskytuje škálovatelnou infrastrukturu. Umožňuje globální přístupnost. použití mého vloženého nasazení ve skupině prostředků 'my-resource-group'
  • S uživatelovým sledováním: Generovat embeddingy pro 'aplikace zpracování přirozeného jazyka' pomocí nasazení 'text-embedding-3-small' s identifikátorem uživatele 'analytics-team' ve skupině prostředků 'my-resource-group'
  • Konkrétní dimenze: Vytvořit vkládání pro 'Umělá inteligence mění podnikové operace' pomocí nasazení 'text-embedding-3-large' s 1536 dimenzemi na prostředku 'ai-central' ve skupině prostředků 'my-resource-group'
  • Formát Base64: Generování vkládání pro neurální sítě hlubokého učení pomocí nasazení ada-002 s formátem kódování base64 u prostředku ml-services ve skupině prostředků my-resource-group
  • Text výzkumu: "Vytvořte vektorová vkládání pro 'Kvantové výpočty ukazují výpočetní výhody v konkrétních algoritmech' pomocí mého nasazení vkládání textu ve skupině prostředků 'my-resource-group'"
  • Popis produktu: "Vytvoření vektorových reprezentací pro 'Vysoce výkonný přenosný počítač s pokročilým grafickým zpracováním' pomocí implementace 'text-embedding-3-small' prostředkem 'product-ai' v rámci skupiny prostředků 'my-resource-group'"
  • Technická dokumentace: "Vytvořte vkládání pro frázi 'API authentication requires valid credentials and proper authorization headers' pomocí nasazení 'ada-002' s kódováním float na prostředku 'docs-embedding' ve skupině prostředků 'my-resource-group'"
Parameter Povinné nebo volitelné Description
Skupina zdrojů Required Název skupiny prostředků Azure. Jedná se o logický kontejner pro Azure prostředky.
Název prostředku Required Název prostředku Azure OpenAI.
Nasazení Required Název nasazení modelu Foundry.
Vstupní text Required Vstupní text, pro který se mají vygenerovat vektorové reprezentace.
User Optional Volitelný identifikátor uživatele pro sledování a sledování zneužití
Formát kódování Optional Formát pro vrácení embeddingů ve (float nebo base64).
Dimenze Optional Počet dimenzí pro vložený výstup Podporuje se jenom v některých modelech.

Tipy k anotacím nástroje:

Destruktivní Idempotentní Open World Jen pro čtení Secret Vyžadováno místní
❌ ❌ ❌ ✅ ❌ ❌

OpenAI: Generování výstupů

Vytváření dokončování textu pomocí Azure OpenAI v Foundry Odešlete výzvu nebo dotaz a modely Azure OpenAI, které jsou nasazeny ve vašem prostředku Foundry, vám vygenerují textové odpovědi. Tuto možnost použijte v případě, že potřebujete vytvářet dokončování, získávat obsah vygenerovaný pomocí umělé inteligence, generovat odpovědi na otázky nebo vytvářet dokončování textu z Azure OpenAI na základě libovolné výzvy ke vstupu. Podporuje přizpůsobení pomocí teploty a maximálního počtu tokenů.

Mezi ukázkové výzvy patří:

  • Basic completion: "Vytvořte dokončení s výzvou 'Co je Azure?'" pomocí mého nasazení 'gpt-35-turbo' ve skupině prostředků 'my-resource-group'
  • S kontrolou teploty: "Vygenerovat dokončení textu pro vysvětlení strojového učení s využitím nasazení 'text-davinci-003' a s parametrem teploty nastaveným na 0.3 ve skupině prostředků 'my-resource-group'"
  • Omezené tokeny: Vytvořte dokončení s výzvou 'Napsat souhrn' pomocí mého nasazení 'gpt-4' s maximálním počtem 100 tokenů ve skupině prostředků 'my-resource-group'.
  • Tvůrčí psaní: "Vygenerujte dokončení pro 'Povězte mi příběh o AI' pomocí nasazení 'gpt-35-turbo' s teplotou 0,8 a maximálně 200 tokeny ve skupině prostředků 'my-resource-group'"
  • Technické vysvětlení: "Vytvořte odpověď na otázku 'Jak funguje cloud computing?'" používání mého prostředku OpenAI „ai-services-east“ a nasazení „gpt-4“ ve skupině prostředků „my-resource-group“
Parameter Povinné nebo volitelné Description
Skupina zdrojů Required Název skupiny prostředků Azure, ve které je prostředek AI hostován.
Název prostředku Required Název prostředku Azure OpenAI.
Nasazení Required Název nasazení.
Text výzvy Required Text výzvy k odeslání do modelu pro dokončování.
Maximální počet tokenů Optional Maximální počet tokenů, které se mají vygenerovat v dokončení.
Teplota Optional Řídí náhodnost ve výstupu. Nižší hodnoty z něj činí determinističtější.

Tipy k anotacím nástroje:

Destruktivní Idempotentní Open World Jen pro čtení Secret Vyžadováno místní
❌ ❌ ❌ ✅ ❌ ❌

OpenAI: Výpis modelů a nasazení

Vypište všechny dostupné modely a nasazení OpenAI v Azure prostředku. Tento nástroj načte informace o nasazených modelech, včetně názvů modelů, verzí, možností a stavu nasazení.

Mezi ukázkové výzvy patří:

  • Zobrazit všechny modely: Seznam všech modelů OpenAI v prostředku ai-services-prod ve skupině prostředků my-resource-group
  • Zkontrolujte nasazení: Zobrazení všech nasazených modelů a jejich stavu v prostředku openai-east ve skupině prostředků my-resource-group
  • Inventář produkčního prostředí: Jaké modely jsou k dispozici v prostředku production-openai ve skupině prostředků my-resource-group?
  • Kontrola vývoje: Seznam všech modelů a nasazení v prostředku dev-ai-services ve skupině prostředků my-resource-group
  • Schopnosti modelů OpenAI: "Ukaž mi všechny dostupné modely OpenAI s jejich schopnostmi v prostředku 'ai-central' ve skupině prostředků 'my-resource-group'"
  • Stav nasazení: Jaký je aktuální stav všech nasazení v mém prostředku openai-west ve skupině prostředků my-resource-group?
  • Regionální modely: Seznam všech modelů dostupných v prostředku europe-openai ve skupině prostředků my-resource-group
  • Přehled služby: "Dejte mi úplný přehled modelů a nasazení v prostředku customer-ai ve skupině prostředků my-resource-group".
  • Verze modelu: Zobrazit všechny verze modelu dostupné v prostředku ai-services-main ve skupině prostředků my-resource-group
  • Audit prostředků: Potřebuji auditovat všechny modely OpenAI a nasazení v prostředku "enterprise-ai" ve skupině prostředků "my-resource-group"
Parameter Povinné nebo volitelné Description
Skupina zdrojů Required Název skupiny prostředků Azure. Jedná se o logický kontejner pro Azure prostředky.
Název prostředku Required Název prostředku Azure OpenAI.

Tipy k anotacím nástroje:

Destruktivní Idempotentní Open World Jen pro čtení Secret Vyžadováno místní
❌ ✅ ❌ ✅ ❌ ❌

Zdroje: Získání prostředku Foundry

Získejte podrobné informace o prostředcích Foundry, včetně adresy URL koncového bodu, umístění, skladové položky a všech nasazených modelů s jejich konfigurací. Pokud je zadaný konkrétní název prostředku, vrátí pouze podrobnosti o daném prostředku. Pokud není zadaný žádný název prostředku, zobrazí seznam všech prostředků Foundry v předplatném nebo skupině prostředků.

Mezi ukázkové výzvy patří:

  • Získejte konkrétní prostředek: Zobrazte podrobnosti o prostředku Foundry 'ai-foundry-prod' včetně všech nasazených modelů
  • Uveďte všechny prostředky: Jaké prostředky Foundry mám v předplatném?
  • Prostředek s konfigurací: Získejte adresu URL koncového bodu, umístění a informace o SKU pro můj 'customer-ai-foundry' foundry prostředek
Parameter Povinné nebo volitelné Description
Název prostředku Optional Název prostředku Azure OpenAI.

Tipy k anotacím nástroje:

Destruktivní Idempotentní Open World Jen pro čtení Secret Vyžadováno místní
❌ ✅ ❌ ✅ ❌ ❌

Související obsah

  • Last updated on