Azure MCP-Servertools für Microsoft Foundry Extensions

Mit dem Azure MCP-Server können Sie Microsoft Foundry Extensions-Ressourcen verwalten, einschließlich der Erstellung von Chat- und Textabschlussen, das Generieren von Einbettungen, das Auflisten von Modellen und das Arbeiten mit Wissensindizes mit Anweisungen in natürlicher Sprache.

Microsoft Foundry ist eine Plattform zum Bereitstellen und Verwalten von benutzerdefinierten KI-Modellen in Azure. Sie bietet Tools und Dienste für Schulungen, Feinabstimmung, Bereitstellung und Überwachung von KI-Modellen in Produktionsumgebungen.

Wissensindexbefehle erfordern den Endpunkt Ihres Microsoft Foundry-Projekts. OpenAI-Befehle erfordern den Ressourcennamen und die Ressourcengruppe. Der Befehl "Ressourcen abrufen" kann Ressourcen auflisten, ohne einen Ressourcennamen anzugeben.

Note

Tool-Parameter: Die Azure MCP-Servertools definieren Parameter für Daten, die sie zum Ausführen von Aufgaben benötigen. Einige dieser Parameter sind für jedes Tool spezifisch und werden hier dokumentiert. Andere Parameter sind global und werden von allen Tools gemeinsam genutzt. Weitere Informationen finden Sie unter Toolparameter.

Wissen: Wissensindizes auflisten

Holen Sie sich eine Liste von Wissensindizes aus Foundry:

  • Suchen Sie Wissensindizes, die in Foundry-Projekten erstellt wurden.
  • Verwenden Sie diese Indizes mit KI-Agenten für den Wissensabruf und RAG-Anwendungen.
  • Die Liste wird aktualisiert, während Sie neue Indizes erstellen oder vorhandene aktualisieren.

Beispiel-CLI-Befehl

azmcp foundryextensions knowledge index list \
  --endpoint <endpoint>
Parameter Typ Required Description
endpoint string Ja Die Endpunkt-URL für das Microsoft Foundry-Projekt oder -Dienst. Der Endpunkt folgt diesem Muster: https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>.

Tool-Anmerkungshinweise:

Zerstörend Idempotent Offene Welt Nur Leseberechtigung Secret Lokal erforderlich

Wissen: Indexschema abrufen

Rufen Sie die detaillierte Schemakonfiguration eines bestimmten Wissensindexes aus Foundry ab.

Dieser Vorgang zeigt Ihnen umfassende Informationen zur Struktur und Konfiguration eines Wissensindexes, einschließlich Felddefinitionen, Datentypen, durchsuchbaren Attributen und anderen Schemaeigenschaften. Verwenden Sie diese Schemainformationen, um zu verstehen, wie die Indexstrukturen aufgebaut sind und Ihre Daten für die Suche indiziert werden.

Beispiel-CLI-Befehl

azmcp foundryextensions knowledge index schema \
  --index <index> \
  --endpoint <endpoint>
Parameter Typ Required Description
index string Ja Der Name des Wissensindexes.
endpoint string Ja Die Endpunkt-URL für das Microsoft Foundry-Projekt oder -Dienst. Der Endpunkt folgt diesem Muster: https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>.

Tool-Anmerkungshinweise:

Zerstörend Idempotent Offene Welt Nur Leseberechtigung Secret Lokal erforderlich

OpenAI: Chat-Vervollständigungsanfragen erstellen

Erstellen Sie Chatabschlusse mithilfe von Azure OpenAI in Foundry. Senden Sie Nachrichten an Azure OpenAI-Chatmodelle, die in Ihrer Foundry-Ressource bereitgestellt wurden, und empfangen Sie KI-generierte Unterhaltungsantworten. Unterstützt mehrstufige Unterhaltungen mit Verlauf der Nachrichten, Systemvorgaben und Anpassung der Antworten.

Beispiel-CLI-Befehl

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 <stream>] \
  [--seed <seed>] \
  [--user <user>]
Parameter Typ Required Description
resource-name string Ja Der Name der Microsoft Foundry-Ressource.
deployment string Ja Der Name der Bereitstellung
message-array string Ja JSON-Array der Nachrichten in der Konversation. Jede Nachricht sollte die Eigenschaften role und content haben.
resource-group string Ja Der Azure-Ressourcengruppenname.
max-tokens string No Die maximale Anzahl von Token, die beim Abschluss generiert werden sollen.
temperature string No Steuert die Zufälligkeit der Ausgabe. Niedrigere Werte machen sie deterministischer.
top-p string No Kontrolliert die Vielfalt durch Kernsampling (0,0 bis 1,0). Der Standardwert ist 1.0.
frequency-penalty string No Bestraft neue Token basierend auf ihrer Häufigkeit (-2,0 bis 2,0). Standard ist "0".
presence-penalty string No Bestraft neue Token basierend auf der Anwesenheit (-2,0 bis 2,0). Standard ist "0".
stop string No Bis zu 4 Sequenzen, bei denen die API die Generierung weiterer Token beendet.
stream string No Gibt an, ob der Teilfortschritt zurückgestreamt werden soll. Die Standardeinstellung ist "false".
seed string No Wenn angegeben, bemüht sich das System am besten, deterministisch zu proben.
user string No Benutzerkennung für Tracking und Missbrauchserkennung.

Tool-Anmerkungshinweise:

Zerstörend Idempotent Offene Welt Nur Leseberechtigung Secret Lokal erforderlich

OpenAI: Erstellen von Einbettungen

Erstellen Sie Einbettungen mit Azure OpenAI in Foundry. Generieren Sie Vektoreinbettungen aus Text mithilfe von Azure OpenAI-Bereitstellungen in Ihrer Foundry-Ressource für semantische Suche, Ähnlichkeitsvergleiche, Clustering oder maschinelles Lernen.

Beispiel-CLI-Befehl

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 string Ja Der Name der Microsoft Foundry-Ressource.
deployment string Ja Der Name der Bereitstellung
input-text string Ja Der Eingabetext, für den Einbettungen generiert werden sollen.
resource-group string Ja Der Azure-Ressourcengruppenname.
user string No Benutzerkennung zur Nachverfolgung und Missbrauchserkennung.
encoding-format string No Das Format für die Rückgabe von Embeddings (float oder base64).
dimensions string No Die Anzahl der Dimensionen für die Einbettungsausgabe. Nur in einigen Modellen unterstützt.

Tool-Anmerkungshinweise:

Zerstörend Idempotent Offene Welt Nur Leseberechtigung Secret Lokal erforderlich

OpenAI: Erstellen von Vervollständigungen

Erstellen Sie Textabschlusse mithilfe von Azure OpenAI in Foundry. Senden Sie eine Eingabeaufforderung oder Frage an Azure OpenAI-Modelle, die in Ihrer Foundry-Ressource bereitgestellt wurden, und empfangen Sie generierte Textantworten. Verwenden Sie dieses Feature, wenn Sie Abschlusse erstellen, KI-generierte Inhalte abrufen, Antworten auf Fragen generieren oder Textabschlusse aus Azure OpenAI basierend auf jeder Eingabeaufforderung erstellen müssen. Unterstützt die Anpassung mit Temperatur und Höchstanzahl von Token.

Beispiel-CLI-Befehl

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 string Ja Der Name der Bereitstellung
prompt-text string Ja Der Anforderungstext, der an das Vervollständigungsmodell gesendet werden soll.
resource-name string Ja Der Name der Microsoft Foundry-Ressource.
resource-group string Ja Der Azure-Ressourcengruppenname.
max-tokens string No Die maximale Anzahl von Token, die beim Abschluss generiert werden sollen.
temperature string No Steuert die Zufälligkeit der Ausgabe. Niedrigere Werte machen sie deterministischer.

Tool-Anmerkungshinweise:

Zerstörend Idempotent Offene Welt Nur Leseberechtigung Secret Lokal erforderlich

OpenAI: Auflisten von Modellen und Bereitstellungen

Azure OpenAI-Modellbereitstellungen in einer Microsoft Foundry-Ressource auflisten. Dieses Tool ruft Informationen zu bereitgestellten Modellen ab, einschließlich Modellnamen, Versionen, Funktionen und Bereitstellungsstatus.

Beispiel-CLI-Befehl

azmcp foundryextensions openai models-list \
  --resource-name <resource-name> \
  --resource-group <resource-group>
Parameter Typ Required Description
resource-name string Ja Der Name der Microsoft Foundry-Ressource.
resource-group string Ja Der Azure-Ressourcengruppenname.

Tool-Anmerkungshinweise:

Zerstörend Idempotent Offene Welt Nur Leseberechtigung Secret Lokal erforderlich

Ressourcen: Findry-Ressource abrufen

Microsoft Foundry-Ressourcen auflisten oder abrufen und Ressourcendetails wie Endpunkt-URL, Standort, SKU, Typ und Bereitstellungsstatus zurückgeben. Wenn Sie einen Ressourcennamen angeben, gibt das Tool diese einzelne Ressource zurück. Andernfalls wird der Ressourcenbestand im Geltungsbereich zurückgegeben. Verwenden Sie für die Bestandsübersicht der Modellbereitstellungen innerhalb einer Foundry-Ressource das Tool für die OpenAI-Modellliste.

Beispiel-CLI-Befehl

azmcp foundryextensions resource get \
  [--resource-name <resource-name>]
Parameter Typ Required Description
resource-name string No Der Name der Microsoft Foundry-Ressource.

Tool-Anmerkungshinweise:

Zerstörend Idempotent Offene Welt Nur Leseberechtigung Secret Lokal erforderlich