Ferramentas de Servidor Azure MCP para Extensões do Microsoft Foundry

O Azure MCP Server permite-lhe gerir recursos das Extensões Microsoft Foundry, incluindo a criação de conversas e completações de texto, geração de embeddings, listagem de modelos e trabalho com índices de conhecimento, utilizando prompts em linguagem natural.

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

Os comandos de índice de conhecimento requerem o endpoint do seu projeto Microsoft Foundry. Os comandos OpenAI requerem 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 de ferramenta: As ferramentas do Azure MCP Server definem parâmetros para os dados necessários para concluir tarefas. Alguns destes 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 da ferramenta.

Conhecimento: Listar índices de conhecimento

Obtenha uma lista de índices de conhecimento na Foundry:

  • Encontre índices de conhecimento criados dentro dos projetos 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.

Comando CLI de exemplo

azmcp foundryextensions knowledge index list \
  --endpoint <endpoint>
Parameter Tipo Required Description
endpoint cadeia (de caracteres) Sim O URL do endpoint do projeto ou do serviço Microsoft Foundry. O ponto final 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 Localidade obrigatória
❌ ✅ ❌ ✅ ❌ ❌

Conhecimento: Obter esquema de índice

Obtenha a configuração detalhada do esquema de um índice de conhecimento específico no 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.

Comando CLI de exemplo

azmcp foundryextensions knowledge index schema \
  --index <index> \
  --endpoint <endpoint>
Parameter Tipo Required Description
index cadeia (de caracteres) Sim O nome do índice de conhecimento.
endpoint cadeia (de caracteres) Sim O URL do ponto final do projeto ou serviço Microsoft Foundry. O ponto final 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 Localidade obrigatória
❌ ✅ ❌ ✅ ❌ ❌

OpenAI: Criar completamentos de chat

Crie concluções de chat usando o Azure OpenAI no Foundry. Envie mensagens para modelos de chat Azure OpenAI implementados no seu recurso Foundry e receba respostas conversacionais geradas por IA. Suporta conversas contínuas com histórico de mensagens, instruções do sistema e personalização de respostas.

Comando CLI de exemplo

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 (de caracteres) Sim O nome do recurso Microsoft Foundry.
deployment cadeia (de caracteres) Sim O nome da implantação.
message-array cadeia (de caracteres) Sim Matriz JSON de mensagens na conversa. Cada mensagem deve ter role e content propriedades.
resource-group cadeia (de caracteres) Sim O nome do grupo de recursos do Azure.
max-tokens cadeia (de caracteres) Não O número máximo de tokens a serem gerados na conclusão.
temperature cadeia (de caracteres) Não Controla a aleatoriedade na saída. Valores mais baixos tornam-na mais determinística.
top-p cadeia (de caracteres) Não Controla a diversidade através da amostragem de núcleos (0,0 a 1,0). O padrão é 1.0.
frequency-penalty cadeia (de caracteres) Não Penaliza novos tokens com base na sua frequência (–2,0 a 2,0). O padrão é 0.
presence-penalty cadeia (de caracteres) Não Penaliza novos tokens dependendo da presença (-2,0 a 2,0). O padrão é 0.
stop cadeia (de caracteres) Não Até 4 sequências onde a API para de gerar mais tokens.
stream cadeia (de caracteres) Não Se o progresso parcial deve ser transmitido. O valor padrão é falso.
seed cadeia (de caracteres) Não Se especificado, o sistema faz o melhor esforço para amostrar deterministicamente.
user cadeia (de caracteres) Não Identificador de utilizador para rastreamento e monitorização de abusos.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória
❌ ❌ ❌ ✅ ❌ ❌

OpenAI: Criar incorporações

Crie embeddings usando Azure OpenAI no Foundry. Gera embeddings vetoriais a partir de texto usando implementações do Azure OpenAI no seu recurso Foundry para pesquisa semântica, comparações de similaridade, clustering ou aprendizagem automática.

Comando CLI de exemplo

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 (de caracteres) Sim O nome do recurso Microsoft Foundry.
deployment cadeia (de caracteres) Sim O nome da implantação.
input-text cadeia (de caracteres) Sim O texto de entrada para o qual gerar incorporações.
resource-group cadeia (de caracteres) Sim O nome do grupo de recursos do Azure.
user cadeia (de caracteres) Não Identificador de utilizador para rastreamento e monitorização de abusos.
encoding-format cadeia (de caracteres) Não O formato em que os embeddings são devolvidos (float ou base64).
dimensions cadeia (de caracteres) Não O número de dimensões para a saída de incorporação. Apenas suportado em alguns modelos.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória
❌ ❌ ❌ ✅ ❌ ❌

OpenAI: Criar conclusões

Crie completações de texto usando o Azure OpenAI no Foundry. Envie um prompt ou pergunta para os modelos OpenAI do Azure implementados no seu recurso Foundry e receba respostas geradas em texto. Use esta funcionalidade quando precisar de criar conclusões, obter conteúdo gerado por IA, gerar respostas a perguntas ou produzir conclusãos de texto a partir do Azure OpenAI com base em qualquer prompt de entrada. Suporta personalização com temperatura e max tokens.

Comando CLI de exemplo

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 (de caracteres) Sim O nome da implantação.
prompt-text cadeia (de caracteres) Sim O texto de solicitação a enviar para o modelo de conclusão.
resource-name cadeia (de caracteres) Sim O nome do recurso Microsoft Foundry.
resource-group cadeia (de caracteres) Sim O nome do grupo de recursos do Azure.
max-tokens cadeia (de caracteres) Não O número máximo de tokens a serem gerados na conclusão.
temperature cadeia (de caracteres) Não Controla a aleatoriedade na saída. Valores mais baixos tornam-na mais determinística.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória
❌ ❌ ❌ ✅ ❌ ❌

OpenAI: Listar modelos e implantações

Listar implementações de modelos Azure OpenAI num recurso Microsoft Foundry. Essa ferramenta recupera informações sobre modelos implantados, incluindo nomes de modelos, versões, recursos e status de implantação.

Comando CLI de exemplo

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

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória
❌ ✅ ❌ ✅ ❌ ❌

Recursos: Obter recurso do Foundry

Liste ou obtenha recursos do Microsoft Foundry e devolve detalhes ao nível do recurso, como URL do endpoint, localização, SKU, tipo e estado de provisionamento. Se fornecer um nome de recurso, a ferramenta devolve esse único recurso. Caso contrário, devolve o inventário de recursos abrangido pelo âmbito. Para inventário de implementação de modelos dentro de um recurso Foundry, utilize a ferramenta OpenAI de listas de modelos.

Comando CLI de exemplo

azmcp foundryextensions resource get \
  [--resource-name <resource-name>]
Parameter Tipo Required Description
resource-name cadeia (de caracteres) Não O nome do recurso Microsoft Foundry.

Dicas de anotação da ferramenta:

Destrutivo Idempotente Mundo Aberto Somente leitura Secret Localidade obrigatória
❌ ✅ ❌ ✅ ❌ ❌

Conteúdo relacionado

  • Last updated on