herramientas de servidor MCP de Azure para extensiones de Microsoft Foundry

El servidor MCP de Azure le permite administrar recursos de extensiones de Microsoft Foundry, incluida la creación de finalizaciones de chat y texto, la generación de incrustaciones, listar modelos y trabajar con índices de conocimiento, con indicaciones de lenguaje natural.

Microsoft Foundry es una plataforma para implementar y administrar modelos de IA personalizados en Azure. Proporciona herramientas y servicios para el entrenamiento, ajuste, implementación y supervisión de modelos de inteligencia artificial en entornos de producción.

Los comandos del índice de conocimiento requieren el punto de conexión de su proyecto de Microsoft Foundry. Los comandos openAI requieren el nombre del recurso y el grupo de recursos. El comando resource get puede enumerar los recursos sin proporcionar un nombre de recurso.

Note

parámetros Tool: las herramientas de servidor MCP de Azure definen parámetros para los datos que necesitan para completar tareas. Algunos de estos parámetros son específicos de cada herramienta y se documentan aquí. Otros parámetros son globales y compartidos por todas las herramientas. Para obtener más información, consulte Parámetros de la herramienta.

Conocimiento: Enumeración de índices de conocimiento

Obtenga una lista de índices de conocimiento de Foundry:

  • Busque índices de conocimiento creados en proyectos de Foundry.
  • Use estos índices con agentes de INTELIGENCIA ARTIFICIAL para la recuperación de conocimientos y las aplicaciones RAG.
  • La lista se actualiza a medida que crea nuevos índices o actualiza los existentes.

Comando de la CLI de ejemplo

azmcp foundryextensions knowledge index list \
  --endpoint <endpoint>
Parameter Tipo Required Description
endpoint string Sí Dirección URL del punto de conexión del proyecto o servicio de Microsoft Foundry. El punto de conexión sigue este patrón: https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secret Se requiere un recurso local
❌ ✅ ❌ ✅ ❌ ❌

Conocimientos: Obtención del esquema de índice

Obtenga la configuración de esquema detallada de un índice de conocimiento específico de Foundry.

Esta operación muestra información completa sobre la estructura y la configuración de un índice de conocimiento, incluidas las definiciones de campo, los tipos de datos, los atributos que se pueden buscar y otras propiedades de esquema. Utiliza esta información de esquema para comprender cómo funcionan las estructuras de los índices y cómo estos indexan tus datos para la búsqueda.

Comando de la CLI de ejemplo

azmcp foundryextensions knowledge index schema \
  --index <index> \
  --endpoint <endpoint>
Parameter Tipo Required Description
index string Sí Nombre del índice de conocimiento.
endpoint string Sí Dirección URL del punto de conexión del proyecto o servicio de Microsoft Foundry. El punto de conexión sigue este patrón: https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secret Se requiere un recurso local
❌ ✅ ❌ ✅ ❌ ❌

OpenAI: Crear completados de chat

Cree finalizaciones de chat mediante Azure OpenAI en Foundry. Envíe mensajes a los modelos de chat de Azure OpenAI implementados en su recurso de Foundry y reciba respuestas conversacionales generadas por IA. Admite conversaciones de varios turnos con historial de mensajes, instrucciones del sistema y personalización de respuestas.

Comando de la CLI de ejemplo

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 Tipo Required Description
resource-name string Sí Nombre del recurso Microsoft Foundry.
deployment string Sí Nombre de la implementación.
message-array string Sí Matriz JSON de mensajes en la conversación. Cada mensaje debe tener role propiedades y content .
resource-group string Sí El nombre del grupo de recursos de Azure.
max-tokens string No Número máximo de tokens que se generarán durante la finalización.
temperature string No Controla la aleatoriedad en la salida. Los valores más bajos hacen que sea más determinista.
top-p string No Controla la diversidad a través del muestreo del núcleo (de 0,0 a 1,0). El valor predeterminado es 1.0.
frequency-penalty string No Penaliza los nuevos tokens en función de su frecuencia (de -2,0 a 2,0). El valor predeterminado es 0.
presence-penalty string No Penaliza los nuevos tokens en función de su presencia (de -2,0 a 2,0). El valor predeterminado es 0.
stop string No Hasta 4 secuencias en las que la API deja de generar más tokens.
stream string No Si se transmite el progreso parcial. El valor predeterminado es falso.
seed string No Si se especifica, el sistema realiza un mejor esfuerzo para muestrear de forma determinista.
user string No Identificador de usuario para el seguimiento y la supervisión de abusos.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secret Se requiere un recurso local
❌ ❌ ❌ ✅ ❌ ❌

OpenAI: Crear incrustaciones

Cree incrustaciones mediante Azure OpenAI en Foundry. Generar representaciones vectoriales a partir de texto mediante implementaciones de Azure OpenAI en su recurso Foundry para la búsqueda semántica, comparaciones de similitud, agrupación en clústeres o aprendizaje automático.

Comando de la CLI de ejemplo

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 Tipo Required Description
resource-name string Sí Nombre del recurso Microsoft Foundry.
deployment string Sí Nombre de la implementación.
input-text string Sí Texto de entrada para el que se van a generar incrustaciones.
resource-group string Sí El nombre del grupo de recursos de Azure.
user string No Identificador de usuario para el seguimiento y la supervisión de abusos.
encoding-format string No El formato en que se deben devolver los vectores de incrustación (float o base64).
dimensions string No El número de dimensiones de la salida de la representación. Solo es compatible con algunos modelos.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secret Se requiere un recurso local
❌ ❌ ❌ ✅ ❌ ❌

OpenAI: Crear completaciones

Cree finalizaciones de texto mediante Azure OpenAI en Foundry. Envíe un mensaje o una pregunta a los modelos de Azure OpenAI implementados en su recurso Foundry y reciba respuestas de texto generadas. Use esta característica cuando necesite crear finalizaciones, obtener contenido generado por IA, generar respuestas a preguntas o generar finalizaciones de texto a partir de Azure OpenAI en función de cualquier mensaje de entrada. Permite la personalización mediante la configuración del parámetro de temperatura y el máximo de tokens.

Comando de la CLI de ejemplo

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 Tipo Required Description
deployment string Sí Nombre de la implementación.
prompt-text string Sí El texto de la solicitud que se enviará al modelo de finalización.
resource-name string Sí Nombre del recurso Microsoft Foundry.
resource-group string Sí El nombre del grupo de recursos de Azure.
max-tokens string No Número máximo de tokens que se generarán durante la finalización.
temperature string No Controla la aleatoriedad en la salida. Los valores más bajos hacen que sea más determinista.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secret Se requiere un recurso local
❌ ❌ ❌ ✅ ❌ ❌

OpenAI: enumeración de modelos e implementaciones

Enumerar las implementaciones de modelos de Azure OpenAI en un recurso de Microsoft Foundry. Esta herramienta recupera información sobre los modelos implementados, incluidos los nombres de modelo, las versiones, las funcionalidades y el estado de implementación.

Comando de la CLI de ejemplo

azmcp foundryextensions openai models-list \
  --resource-name <resource-name> \
  --resource-group <resource-group>
Parameter Tipo Required Description
resource-name string Sí Nombre del recurso Microsoft Foundry.
resource-group string Sí El nombre del grupo de recursos de Azure.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secret Se requiere un recurso local
❌ ✅ ❌ ✅ ❌ ❌

Recursos: Obtener recurso Foundry

Enumera u obtén recursos de Microsoft Foundry y devuelve detalles del recurso, como la dirección URL del punto de conexión, la ubicación, SKU, el tipo y el estado de aprovisionamiento. Si proporciona un nombre de recurso, la herramienta devuelve ese único recurso. De lo contrario, devuelve el inventario de recursos en el ámbito. Para el inventario de implementación de modelos dentro de un recurso Foundry, use la herramienta de lista modelos de OpenAI.

Comando de la CLI de ejemplo

azmcp foundryextensions resource get \
  [--resource-name <resource-name>]
Parameter Tipo Required Description
resource-name string No Nombre del recurso Microsoft Foundry.

Sugerencias de anotación de herramientas:

Destructivo Idempotente Abrir mundo Solo lectura Secret Se requiere un recurso local
❌ ✅ ❌ ✅ ❌ ❌

Contenido relacionado

  • Last updated on