Azure MCP Server para ferramentas de extensões do Microsoft Foundry

O servidor MCP do Azure permite que você gerencie os recursos de Extensões Microsoft Foundry, incluindo a criação de completamentos de chat e texto, a geração de embeddings, a listagem de modelos e o trabalho com índices de conhecimento, usando prompts em linguagem natural.

Microsoft Foundry é uma plataforma para implantar e gerenciar modelos de IA personalizados em Azure. Ele fornece ferramentas e serviços para treinamento, ajuste fino, implantação e monitoramento de modelos de IA em ambientes de produção.

Os comandos de índice de conhecimento exigem o endpoint do seu projeto do Microsoft Foundry. Os comandos OpenAI exigem o nome do recurso e o grupo de recursos. O comando resource get pode listar recursos sem fornecer um nome de recurso.

Note

parâmetros Tool: as ferramentas do servidor MCP Azure definem parâmetros para os dados necessários para concluir tarefas. Alguns desses parâmetros são específicos para cada ferramenta e estão documentados aqui. Outros parâmetros são globais e compartilhados por todas as ferramentas. Para obter mais informações, consulte parâmetros de ferramenta.

Conhecimento: Listar índices de conhecimento

Obtenha uma lista de índices de conhecimento da Foundry:

  • Encontre índices de conhecimento criados em projetos do Foundry.
  • Use esses índices com agentes de IA para recuperação de conhecimento e aplicativos RAG.
  • A lista é atualizada à medida que você cria novos índices ou atualiza os existentes.

Exemplo de comando da CLI

azmcp foundryextensions knowledge index list \
  --endpoint <endpoint>
Parameter Tipo Required Description
endpoint cadeia Yes A URL do endpoint para o projeto ou serviço Microsoft Foundry. O ponto de extremidade segue este padrão: https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Conhecimento: Obter esquema de índice

Obtenha a configuração detalhada do esquema de um índice de conhecimento específico do Foundry.

Esta operação mostra informações abrangentes sobre a estrutura e a configuração de um índice de conhecimento, incluindo definições de campo, tipos de dados, atributos pesquisáveis e outras propriedades de esquema. Use essas informações de esquema para entender como o índice estrutura e indexa seus dados para pesquisa.

Exemplo de comando da CLI

azmcp foundryextensions knowledge index schema \
  --index <index> \
  --endpoint <endpoint>
Parameter Tipo Required Description
index cadeia Yes O nome do índice de conhecimento.
endpoint cadeia Yes URL do ponto de extremidade do projeto ou serviço do Microsoft Foundry. O ponto de extremidade segue este padrão: https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

OpenAI: Criar completamentos de chat

Crie conclusões de chat usando o OpenAI do Azure no Foundry. Envie mensagens para modelos de chat do Azure OpenAI implantados no seu recurso Foundry e receba respostas conversacionais geradas por IA. Dá suporte a conversas de vários turnos com histórico de mensagens, instruções do sistema e personalização de resposta.

Exemplo de comando da 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 <stream>] \
  [--seed <seed>] \
  [--user <user>]
Parameter Tipo Required Description
resource-name cadeia Yes O nome do recurso Microsoft Foundry.
deployment cadeia Yes O nome da implantação.
message-array cadeia Yes Matriz JSON de mensagens na conversa. Cada mensagem deve ter role e content propriedades.
resource-group cadeia Yes O nome do grupo de recursos do Azure.
max-tokens cadeia No O número máximo de tokens a serem gerados na conclusão.
temperature cadeia No Controla a aleatoriedade na saída. Valores mais baixos tornam-no mais determinístico.
top-p cadeia No Controla a diversidade por meio da amostragem de núcleo (0,0 a 1,0). O padrão é 1.0.
frequency-penalty cadeia No Penaliza novos tokens com base na frequência deles (escala de -2.0 a 2.0). O padrão é 0.
presence-penalty cadeia No Penaliza novos tokens com base na sua presença (escala de -2.0 a 2.0). O padrão é 0.
stop cadeia No Até 4 sequências em que a API para de gerar tokens adicionais.
stream cadeia No Se o progresso parcial deverá ser transmitido de volta. O padrão é false.
seed cadeia No Se especificado, o sistema faz o possível para realizar a amostragem de forma determinística.
user cadeia No Identificador de usuário para acompanhamento e monitoramento de abuso.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ❌ ❌ ✅ ❌ ❌

OpenAI: Criar inserções

Crie inserções usando Azure OpenAI no Foundry. Gere vetores de incrustação a partir do texto usando implantações do Azure OpenAI no recurso Foundry para pesquisa semântica, comparações de similaridade, agrupamento ou aprendizado de máquina.

Exemplo de comando da 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 Tipo Required Description
resource-name cadeia Yes O nome do recurso Microsoft Foundry.
deployment cadeia Yes O nome da implantação.
input-text cadeia Yes O texto de entrada para o qual gerar inserções.
resource-group cadeia Yes O nome do grupo de recursos do Azure.
user cadeia No Identificador de usuário para acompanhamento e monitoramento de abuso.
encoding-format cadeia No O formato de retorno dos embeddings (float ou base64).
dimensions cadeia No O número de dimensões da saída de incorporação. Só há suporte em alguns modelos.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ❌ ❌ ✅ ❌ ❌

OpenAI: Criar compleções

Crie complementações de texto usando o Azure OpenAI no Foundry. Envie um prompt ou uma pergunta para os modelos OpenAI do Azure implantados no seu recurso Foundry e receba respostas de texto geradas. Use esse recurso quando precisar criar conclusões, obter conteúdo gerado por IA, gerar respostas a perguntas ou produzir conclusões de texto de Azure OpenAI com base em qualquer prompt de entrada. Suporta personalização com ajuste da temperatura e número máximo de tokens.

Exemplo de comando da 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 Tipo Required Description
deployment cadeia Yes O nome da implantação.
prompt-text cadeia Yes O texto do prompt que será enviado ao modelo de conclusão.
resource-name cadeia Yes O nome do recurso Microsoft Foundry.
resource-group cadeia Yes O nome do grupo de recursos do Azure.
max-tokens cadeia No O número máximo de tokens a serem gerados na conclusão.
temperature cadeia No Controla a aleatoriedade na saída. Valores mais baixos tornam-no mais determinístico.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ❌ ❌ ✅ ❌ ❌

OpenAI: Listar modelos e implantações

Listar implantações de modelo do Azure OpenAI em um recurso do Microsoft Foundry. Essa ferramenta recupera informações sobre modelos implantados, incluindo nomes de modelo, versões, funcionalidades e status de implantação.

Exemplo de comando da CLI

azmcp foundryextensions openai models-list \
  --resource-name <resource-name> \
  --resource-group <resource-group>
Parameter Tipo Required Description
resource-name cadeia Yes O nome do recurso Microsoft Foundry.
resource-group cadeia Yes O nome do grupo de recursos do Azure.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Recursos: Obter recurso Foundry

Liste ou obtenha recursos do Microsoft Foundry e retorne detalhes no nível de recurso, como URL do endpoint, localização, SKU, tipo e estado de provisionamento. Se você fornecer um nome de recurso, a ferramenta retornará esse único recurso. Caso contrário, é retornado o inventário de recursos no escopo. Para o inventário de implantações de modelos em um recurso do Foundry, use a ferramenta de listagem de modelos do OpenAI.

Exemplo de comando da CLI

azmcp foundryextensions resource get \
  [--resource-name <resource-name>]
Parameter Tipo Required Description
resource-name cadeia No O nome do recurso Microsoft Foundry.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Local obrigatório
❌ ✅ ❌ ✅ ❌ ❌

Conteúdo relacionado

  • Last updated on