Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O ecossistema .NET fornece muitas ferramentas, bibliotecas e serviços poderosos para desenvolver aplicativos de IA. O .NET suporta conexões de modelo de IA local e na nuvem, muitos SDKs diferentes para vários serviços de IA e banco de dados vetorial e outras ferramentas para ajudá-lo a criar aplicativos inteligentes de escopo e complexidade variáveis.
Decida que ferramenta usar
A tabela seguinte recomenda qual a tecnologia a utilizar com base nos diferentes objetivos.
| Objective | Tecnologia para usar |
|---|---|
| Adicionar comportamento de IA a uma aplicação | Use a biblioteca Microsoft.Extensions.AI (MEAI). Adiciona Avaliações assim que tiveres algo que valha a pena medir. |
| Trabalhe com os seus próprios dados | Usa Microsoft. Extensions.DataIngestion (MEDI) para ler, fragmentar ou enriquecer conteúdo. Depois usa Microsoft. Extensions.VectorData (MEVD) para armazenar e recuperar vetores. |
| Partilhar ou consumir capacidades entre clientes de IA | Use um servidor MCP para publicar capacidades, ou um cliente MCP para as consumir. |
| Construir um sistema agentico | Utilize o Copilot SDK para uma estrutura pronta a usar, ou o Microsoft Agent Framework para a consecução de objetivos em várias etapas, encaminhamento ou transferências. |
| Escolha um modelo de alojamento ou execução | Utilize Azure AI Foundry para cloud gerida, Foundry Local para execução prioritariamente local ou sensível à privacidade e Aspire para sistemas multisserviço distribuídos. |
| Melhorar o fluxo de trabalho dos programadores | Usa AI Toolkit. |
A maioria das aplicações de IA de produção combina vários componentes:
- Chat ou aplicação de resumo: MEAI + Avaliações
- Aplicação RAG: MEDI + MEVD + MEAI
- Sistema multi-agente: MEAI + MAF + Aspire
- Interoperabilidade de ferramentas: MEAI + Servidor MCP + Cliente MCP
- Enterprise cloud app: MEAI + Azure AI Foundry + Aspire
- Aplicação local-first: MEAI + Foundry Local + AI Toolkit (desenvolvimento)
Use estas regras práticas para escolher rapidamente:
- Comece por
Microsoft.Extensions.AIpara a maioria das funcionalidades de IA ao nível da aplicação. - Adicione
Microsoft.Extensions.DataIngestioneMicrosoft.Extensions.VectorDataao fundamentar as respostas com os seus próprios dados. - Use o MCP quando as capacidades têm de ser partilhadas entre fronteiras de processos ou produtos.
- Mude para o Agent Framework quando os prompts de um passo se tornam fluxos de trabalho de múltiplos passos.
- Adicione avaliações quando o comportamento for suficientemente útil para medir e proteger contra regressões.
Bibliotecas de Microsoft.Extensions.AI
Microsoft.Extensions.AI é um conjunto de bibliotecas .NET principais que fornecem uma camada unificada de abstrações em C# para interagir com serviços de IA, como modelos de linguagem pequenos e grandes (SLMs e LLMs), incorporações e middleware. Estas APIs foram criadas em colaboração com programadores de todo o ecossistema .NET. As APIs de baixo nível, como IChatClient e IEmbeddingGenerator<TInput,TEmbedding>, foram extraídas do Kernel Semântico e movidas para o Microsoft.Extensions.AI namespace.
Microsoft.Extensions.AI fornece abstrações que podem ser implementadas por vários serviços, todos aderindo aos mesmos conceitos centrais. Esta biblioteca não se destina a fornecer APIs adaptadas aos serviços de qualquer provedor específico. O objetivo é Microsoft.Extensions.AI atuar como uma camada unificadora dentro do ecossistema .NET, permitindo que os desenvolvedores escolham suas estruturas e bibliotecas preferidas, garantindo ao mesmo tempo integração e colaboração perfeitas em todo o ecossistema.
O MEAI oferece aos programadores .NET uma abstração limpa para a interação com modelos. Encaixa-se naturalmente na injeção de dependências, configuração e arquiteturas de aplicações existentes, sendo a habitual primeira camada de uma aplicação .NET com IA.
O MEAI sozinho não é um framework de agentes. Uma chamada isolada, uma funcionalidade de chat ou um ciclo de chamadas a ferramentas pode ser criado com o MEAI sem se tornar "agêntico". Quando o sistema precisar de uma orquestração multi-etapas orientada por objetivos, utilize o MAF em vez disso.
Para mais informações, consulte Microsoft.Extensions.AI visão geral.
Bibliotecas de avaliação
A biblioteca Microsoft.Extensions.AI.Evaluation é a camada de qualidade e de regressão para funcionalidades de IA criadas com a pilha de IA do .NET. O comportamento da IA muda facilmente à medida que os prompts, modelos e ferramentas evoluem. A biblioteca de avaliações oferece às equipas uma forma repetível de comparar resultados e capturar regressões.
Para mais informações, consulte bibliotecas Microsoft.Extensions.AI.Evaluation.
Microsoft.Extensions.DataIngestion (MEDI)
Microsoft. Extensions.DataIngestion é a camada de ingestão e preparação para dados prontos para IA em .NET.
Muitas aplicações de IA falham antes de serem recuperadas porque os dados são confusos, sobredimensionados ou mal estruturados. A qualidade da ingestão tem um forte impacto na qualidade das respostas subsequentes. O MEDI prepara e estrutura os dados que o MEVD ou outro repositório consulta posteriormente.
Para mais informações, consulte Ingestão de dados para aplicações de IA.
Microsoft.Extensions.VectorData (MEVD)
Microsoft. Extensions.VectorData é a camada de armazenamento e recuperação de dados vetoriais para pesquisa semântica, pesquisa de similaridade e grounding em aplicações .NET IA.
O MEVD oferece às aplicações .NET uma forma consistente de trabalhar com armazenamentos vetoriais e ajuda a separar preocupações de armazenamento e recuperação vetorial das preocupações com invocação de modelos.
Para mais informações, consulte a visão geral das lojas vetoriais.
Servidor MCP
Um Servidor MCP expõe capacidades como ferramentas, recursos ou prompts através do Protocolo de Contexto do Modelo para que outros assistentes, IDEs e agentes possam descobri-los e utilizá-los através de um protocolo padrão.
Um servidor MCP transforma as capacidades das aplicações em endpoints reutilizáveis voltados para IA. Reduz o trabalho de integração de ferramentas duplicadas entre assistentes e cria uma fronteira mais clara entre fornecedores de capacidades e consumidores de capacidades.
Um servidor MCP serve para publicar capacidades. Se a funcionalidade for usada apenas dentro de uma aplicação, a chamada regular de funções em processo é mais simples.
Cliente MCP
Um Cliente MCP é o componente do lado do consumidor do protocolo: estabelece ligação aos servidores MCP e traz as capacidades por eles disponibilizadas para o ambiente de execução de uma aplicação, assistente ou agente.
Um Cliente MCP destina-se a consumir capacidades, não a publicá-las. Se tudo o que a aplicação precisa for local e estiver em processo, a chamada ordinária de funções ou ferramentas continua a ser mais simples.
Para mais informações, consulte Comece com MCP.
Microsoft Agent Framework (MAF)
O Microsoft Agent Framework é a camada de orquestração para sistemas verdadeiramente agentes: perseguem um objetivo em múltiplos passos, tomam decisões ao longo do processo, utilizam ferramentas e podem coordenar múltiplos agentes.
Nem todas as funcionalidades de IA precisam de MAF. Se uma chamada MEAI direta ou um simples loop de chamada de ferramentas resolver o problema, use uma abordagem mais simples. O MAF importa quando a complexidade de orquestração é o verdadeiro desafio, não apenas o acesso ao modelo.
Para mais informações, consulte Microsoft Visão geral do Framework de Agentes.
Kit de ferramentas de IA
AI Toolkit é um pacote de extensão VS Code para desenvolvimento de IA que acelera a experimentação com modelos, prompts, agentes e avaliações.
O AI Toolkit não é a arquitetura central de runtime para a aplicação de produção. Complementa MEAI, Avaliações e Foundry Local.
Para mais informações, consulte AI Toolkit para Visual Studio Code.
Copilot SDK
O Copilot SDK é uma infraestrutura pré-construída para agentes e um ambiente de execução que disponibiliza ferramentas, contexto e invocação automática de ferramentas de origem.
O Copilot SDK é mais opinativo e pré-configurado do que o MEAI. Se o seu objetivo é uma arquitetura de aplicação totalmente personalizada, a composição direta de MEAI ou de MAF pode ser mais adequada.
Para mais informações, consulte o repositório SDK Copilot.
Azure AI Foundry
Azure AI Foundry é a camada de plataforma cloud gerida para soluções de IA empresarial, com duas funções principais: gestão de modelos e agentes alojados.
Azure AI Foundry não é a abstração de programação voltada para aplicações; O MEAI ainda desempenha esse papel no código .NET. Azure AI Foundry é a escolha certa quando a verdadeira questão é onde o modelo é executado e sob que controlos.
Para mais informações, consulte a documentação Azure AI Foundry.
Fundição Local
O Foundry Local é uma opção de desenvolvimento local e de implantação local-first para equipas que precisam de manter as cargas de trabalho de IA perto da máquina ou do ambiente.
O Foundry Local é sobre o percurso de desenvolvimento e implementação, não sobre a arquitetura de aplicações de nível superior em si. A transição do ambiente local para a cloud não é uma correspondência direta, por isso, é de esperar diferenças nas funcionalidades, no modelo de alojamento e na operação.
Para mais informações, consulte a documentação local da Foundry.
Aspire
Aspire é a camada de orquestração, cablagem de serviços e observabilidade para aplicações de .NET distribuídas, incluindo sistemas de IA que abrangem múltiplos serviços.
Os sistemas de IA muitas vezes deixam de ser "apenas uma aplicação" quando entram em jogo sistemas de recuperação, ferramentas, gateways e serviços de processamento. Aspire ajuda as equipas a manter essas partes compreensíveis e observáveis, e os seus visuais facilitam o rastreio dos fluxos de IA entre serviços.
Aspire não é especificamente o tempo de execução da IA; É a camada de aplicação multi-serviço à sua volta. Não substitui MEAI, MAF ou Azure AI Foundry.
Para mais informações, consulte a Aspire documentação.