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 Funções do Azure fornece recursos computacionais serverless que se integram com serviços de IA e Azure para o ajudar a construir aplicações inteligentes alojadas na cloud. Este artigo faz uma análise de cenários, integrações e recursos relacionados com IA que pode utilizar nas suas aplicações funcionais.
Use a tabela seguinte para escolher uma integração com base em como o trabalho começa e como outros componentes o consomem:
| Option | Melhor ajuste | Modelo de invocação | Principais considerações |
|---|---|---|---|
| Competências alojadas no Funções do Azure | Adicione raciocínio de IA a cargas de trabalho orientadas a eventos usando instruções e ferramentas declarativas. | Acionadores do Functions ou endpoints HTTP e MCP integrados opcionais | Preview |
| Ligações de agentes para Python | Adiciona raciocínio de agente limitado a uma função Python, mantendo o controlo orientado pelo código sobre validação, ramificação, erros e saídas. | Um disparador padrão de Funções invoca código Python, que chama um objeto injetado do Microsoft Agent Framework Agent |
Pré-visualização; Apenas Python |
| Implementações de endpoints do Model Context Protocol (MCP) | Expor ferramentas síncronas e reutilizáveis a agentes Microsoft Foundry e outros clientes MCP. | HTTP para Transmissão Contínua | Escolha entre competências alojadas, a extensão MCP geralmente disponível e previsualize alojamento baseado em SDK. |
| Ferramentas Funções do Azure baseadas em fila | Execute ferramentas assíncronas em segundo plano para agentes Microsoft Foundry. | Filas de entrada e saída do Armazenamento de Filas do Azure | Específico do Foundry; requer um agente do Foundry com a configuração padrão. |
| Fluxos de trabalho agenciais | Coordene trabalho de IA de longa duração ou com várias etapas que tenha de sobreviver a reinícios e períodos de espera. | Orquestrações duráveis iniciadas por eventos de aplicação | Escolha orquestração direta com Durable Functions ou fluxos de trabalho dinâmicos com competências hospedadas. |
Este artigo é específico da linguagem, portanto, certifique-se de escolher sua linguagem de programação na parte superior da página.
Competências alojadas no Funções do Azure
O Funções do Azure hosted skills é um modelo de programação para construir capacidades inteligentes orientadas a eventos e alojadas na cloud no Funções do Azure. Defines o comportamento com Markdown, instruções em linguagem natural e configuração declarativa. O tempo de execução descobre .agent.md ficheiros, regista triggers e endpoints, e executa competências alojadas quando os eventos são ativados.
Importante
As habilidades hospedadas do Funções do Azure estão atualmente em pré-visualização. Funcionalidades, nomes de configuração e conectores suportados podem mudar antes da disponibilidade geral.
Não precisas de escrever código Python para definir uma competência alojada. Defines o seu comportamento, os gatilhos e as ferramentas configuradas no Markdown e nos ficheiros de configuração. Se precisares de lógica de aplicação personalizada para além destas capacidades configuradas, podes adicionar ferramentas Python personalizadas.
Use as competências alojadas no Funções do Azure quando quiser adicionar comportamento inteligente a uma aplicação orientada a eventos em resposta a um pedido HTTP (schedule), mensagem, alteração de dados, evento de um conector gerido ou outro evento. Também pode ativar um endpoint MCP integrado opcional que expõe cada capacidade alojada como uma ferramenta com tecnologia de IA para outras aplicações, agentes ou estruturas de teste de agentes.
Para começar, veja estes artigos:
- Visão geral: Competências alojadas no Funções do Azure
- Comece: Construa uma aplicação de IA orientada a eventos com competências alojadas no Funções do Azure
- Referência: Configuração de competências hospedadas no Funções do Azure
Ligações de agentes para Python
Importante
As associações de agentes para aplicações de funções em Python encontram-se atualmente em pré-visualização. Funcionalidades, nomes de pacotes e configuração podem mudar antes da disponibilidade geral.
As ligações de agentes adicionam um objeto configurado do Microsoft Agent Agent Framework a uma invocação padrão de função Python. A função mantém o controlo do seu trigger e da lógica de aplicação determinística, e o seu manipulador decide se, quando e como invocar o Agente.
Use ligações de Agente quando a função Python é o modelo de execução principal e o raciocínio de Agente é uma parte limitada do seu trabalho. Utilize antes competências alojadas no Funções do Azure quando uma competência alojada definida de forma declarativa for o principal modelo de execução da aplicação. Use diretamente o Microsoft Agent Framework SDK quando o seu código tiver de controlar todo o ciclo de vida do Agente, em vez de receber um Agente configurado através de um binding.
As associações de agente também suportam chamadas de agente seguras em caso de repetição em orquestrações do Durable Functions. Para saber mais e começar, veja Agent bindings para Python no Funções do Azure.
Ferramentas e servidores MCP
Modelos e agentes de IA usam chamadas de função para solicitar recursos externos conhecidos como ferramentas. Ao usar chamadas de funções, modelos e agentes podem invocar dinamicamente funcionalidades específicas com base no contexto de uma conversa ou tarefa.
Functions é particularmente adequado para implementar chamadas de funções em fluxos de trabalho agênticos, pois escala eficientemente para gerir a procura e fornece extensões de vinculação que simplificam a ligação de agentes a serviços remotos do Azure. Ao criar ou hospedar ferramentas de IA no Functions, você também obtém modelos de preços sem servidor e recursos de segurança da plataforma.
O MCP é o padrão da indústria para interagir com servidores remotos. Ele fornece uma maneira padronizada para modelos e agentes de IA se comunicarem com sistemas externos. Ao utilizar um servidor MCP, estes clientes de IA podem determinar de forma eficiente as ferramentas e capacidades de um sistema externo.
O Funções do Azure atualmente suporta a exposição do seu código de funções usando estes tipos de ferramentas:
| Tipo de ferramenta | Descrição |
|---|---|
| Ponto final MCP integrado para funcionalidades alojadas | Exponha competências alojadas que aplicam raciocínio de IA sob a forma de ferramentas através de um endpoint MCP integrado. |
| Servidor MCP remoto | Criar ferramentas MCP determinísticas ou hospedar servidores MCP baseados em SDK para chamadas de ferramentas síncronas. |
| Ferramenta de Funções do Azure baseada em filas | Use a ferramenta específica da Microsoft Foundry para chamadas assíncronas de funções através de filas de mensagens. |
Escolha como expor um endpoint MCP
O Functions suporta estas opções para expor capacidades através do MCP:
- Ative o endpoint MCP integrado nas competências alojadas no Funções do Azure para expor ferramentas com tecnologia de IA definidas em ficheiros
.agent.md. As competências alojadas estão atualmente em pré-visualização. - Use a extensão MCP binding para criar e hospedar ferramentas MCP determinísticas, tal como faria com qualquer outra aplicação de funções.
- Servidores MCP autoalojados criados com recurso aos SDKs oficiais do MCP. Esta opção de hospedagem está atualmente em visualização.
Aqui está uma comparação das opções atuais de endpoint MCP fornecidas pela Functions:
| Característica | Ponto final MCP integrado para funcionalidades alojadas | Extensão de vinculação MCP | Servidores MCP auto-hospedados |
|---|---|---|---|
| Melhor ajuste | Exponha uma competência alojada alimentada por IA como uma ferramenta MCP. | Crie ferramentas MCP determinísticas com funções de acionamento e de associação do Functions. | Aloja um servidor existente construído com um SDK MCP oficial. |
| Nível de suporte atual | Preview | Disponível ao público em geral | Previsualizar* |
| Modelo de programação |
.agent.md Competência Hospedeira |
Funções, gatilhos e ligações | SDKs MCP padrão |
| Execução com Estado | Histórico de sessões suportado | Suportado | Não é suportado atualmente |
| Linguagens de código personalizadas | Python (ferramentas personalizadas opcionais) | C# (processo isolado) Python TypeScript JavaScript Java |
C# (processo isolado) Python TypeScript Java |
| Plano de alojamento | Consumo Flexível Premium Dedicado (Serviço de Aplicativo) |
Planos de alojamento suportados pelo Funções do Azure | Apenas Consumo Flexível |
| Outros requisitos | Ativar builtin_endpoints.mcp na habilidade alojada |
Nenhum | Servidor sem estado que utiliza transporte HTTP Streamable |
| Modo de implementação | Endpoint MCP integrado no runtime de hosted-skills | Extensão de vinculação MCP | Manipuladores personalizados |
*Os detalhes de configuração para servidores MCP auto-hospedados mudam durante a visualização.
Utilize os seguintes recursos específicos da linguagem para começar com servidores MCP remotos em Funções:
Para C#, compare estes recursos para a extensão MCP e o alojamento baseado em SDK:
| Opções | Extensão de vinculação MCP | Servidores MCP auto-hospedados |
|---|---|---|
| Documentation | Extensão de vinculação MCP | Não aplicável |
| Samples | Servidor MCP personalizado remoto | Servidor meteorológico |
| Modelos | HelloTool | Não aplicável |
Para Python, compare estes recursos para a extensão MCP e o alojamento baseado em SDK:
| Opções | Extensão de vinculação MCP | Servidores MCP auto-hospedados |
|---|---|---|
| Documentation | Extensão de vinculação MCP | Não aplicável |
| Samples | Servidor MCP personalizado remoto | Servidor meteorológico |
Para TypeScript, compare estes recursos para a extensão MCP e o alojamento baseado em SDK:
| Opções | Extensão de vinculação MCP | Servidores MCP auto-hospedados |
|---|---|---|
| Documentation | Extensão de vinculação MCP | Não aplicável |
| Samples | Servidor MCP personalizado remoto | Servidor meteorológico |
Para JavaScript, use os recursos da extensão MCP. É suportado alojamento baseado em SDK, mas atualmente não existe um quickstart em JavaScript.
| Opções | Extensão de vinculação MCP | Servidores MCP auto-hospedados |
|---|---|---|
| Documentation | Extensão de vinculação MCP | Não aplicável |
| Samples | Ainda não está disponível | Ainda não está disponível |
Para o Java, use a documentação da extensão MCP. Amostras específicas da língua não estão atualmente disponíveis.
| Opções | Extensão de vinculação MCP | Servidores MCP auto-hospedados |
|---|---|---|
| Documentation | Extensão de vinculação MCP | Não aplicável |
| Samples | Ainda não está disponível | Ainda não está disponível |
Atualmente, o PowerShell não é suportado para nenhuma das opções de hospedagem do servidor MCP.
Escolha ferramentas do Funções do Azure baseadas em filas para o serviço Microsoft Foundry Agent
O Microsoft Foundry Agent Service também fornece uma ferramenta específica do Funções do Azure para chamadas de funções assíncronas. O agente coloca um pedido numa fila de entrada do Armazenamento de Filas do Azure. Uma função acionada por uma fila processa a solicitação e devolve o resultado por meio de uma fila de saída.
Utilize esta integração específica do Foundry para operações em segundo plano que não exijam uma resposta imediata e que tirem partido de uma entrega fiável de mensagens e de novas tentativas. Para interações síncronas ou ferramentas que pretende reutilizar com outros clientes de IA, use um servidor MCP em vez disso.
As ferramentas Funções do Azure baseadas em fila requerem um agente Foundry com a configuração padrão. Para rever SDKs suportados e construir uma ferramenta, consulte Usar Funções do Azure com Foundry Agent Service.
Fluxos de trabalho agenciais
Utilize Durable Functions quando o código da sua aplicação define uma sequência fiável de chamadas de agente, chamadas de modelo, aprovações e outras tarefas. Durable Functions preserva o estado de orquestração entre esperas e reinicios e suporta padrões comuns como encadeamento de funções, fan-out/fan-in e interação humana.
Se usar competências alojadas no Funções do Azure, os fluxos de trabalho dinâmicos fornecem uma opção de pré-visualização em que um modelo cria um plano estruturado de chamadas de ferramentas, tarefas de subagentes e esperas. O runtime de habilidades alojadas executa esse plano como uma orquestração do Durable Functions. Utilize a invocação direta de ferramentas quando a tarefa puder ficar concluída numa única interação e utilize um fluxo de trabalho dinâmico quando a tarefa tiver de se prolongar para além de uma única interação, ramificar-se, esperar ou persistir após reinícios.
| Option | Quem define o fluxo de trabalho | Melhor ajuste | Principais considerações |
|---|---|---|---|
| Orquestração direta do Durable Functions | Código do aplicativo | Fluxos de trabalho previsíveis com fluxo de controlo explícito, novas tentativas, períodos de espera e aprovações | Usa o modelo de programação Durable Functions para a tua linguagem. |
| Fluxo de trabalho dinâmico de competências alojadas | modelo de IA | Fluxos de trabalho adaptativos que planeiam chamadas de ferramentas, tarefas de subagentes, espera e dispersão em tempo de execução | Pré-visualização; requer competências alojadas no Funções do Azure. |
Para orientações de implementação, consulte padrões de aplicação e Criar e executar fluxos de trabalho dinâmicos.
Ferramentas e frameworks de IA para Funções do Azure
Com o Functions, pode criar aplicações na sua língua preferida e usar as suas bibliotecas preferidas. Devido a essa flexibilidade, você pode usar uma ampla gama de bibliotecas e estruturas de IA em seus aplicativos de função habilitados para IA.
Estas plataformas e frameworks de IA da Microsoft suportam diferentes arquiteturas de aplicação:
| Plataforma ou estrutura | Melhor ajuste | Como funciona com o Funções do Azure |
|---|---|---|
| Estrutura do Microsoft Agent | Lógica de agente code-first e fluxos de trabalho que correm na sua aplicação | Executa os SDKs do framework no teu código de função. |
| Microsoft Foundry Agent Service | Agentes geridos que utilizam ferramentas alojadas no Functions | Criar e gerir agentes como um serviço alojado. Os agentes Foundry podem chamar ferramentas alojadas pelas Funções através do MCP, filas ou OpenAPI. |
| SDKs do Microsoft Foundry | Chamadas diretas de modelo e serviço que não requerem um agente gerido | Invoque diretamente os modelos e os serviços do Foundry no código da sua função. |
No Functions, as suas aplicações também podem referenciar bibliotecas e frameworks de terceiros, para que possa usar todas as suas ferramentas e bibliotecas de IA favoritas nas suas funções habilitadas por IA.