Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Azure Functions fornece recursos de computação sem servidor que se integram aos serviços de IA e Azure para ajudá-lo a criar aplicativos inteligentes hospedados na nuvem. Este artigo pesquisa cenários, integrações e recursos relacionados à IA que você pode usar em seus aplicativos de funções.
Use a tabela a seguir para escolher uma integração baseada em como o trabalho começa e como outros componentes o consomem:
| Option | Melhor ajuste | Modelo de invocação | Principais considerações |
|---|---|---|---|
| Habilidades hospedadas no Azure Functions | Adicione raciocínio de IA a cargas de trabalho orientadas a eventos usando instruções e ferramentas declarativas. | Funções de gatilho ou ponto de extremidades HTTP e MCP integrados opcionais | Preview |
| Vinculações de agentes para Python | Adicione raciocínio de agente limitado a uma função Python mantendo o controle orientado por código sobre validação, ramificação, erros e saídas. | Um gatilho padrão de Funções invoca código Python, que chama um objeto injetado do Microsoft Agent Framework Agent |
Prévia; Apenas Python |
| Implementações de endpoints do Model Context Protocol (MCP) | Expor ferramentas síncronas e reutilizáveis para agentes do Microsoft Foundry e outros clientes MCP. | HTTP transmissível | Escolha entre habilidades hospedadas, a extensão MCP de disponibilidade geral e a hospedagem baseada em SDK em versão prévia. |
| Ferramentas do Azure Functions baseadas em filas | Execute ferramentas assíncronas em segundo plano para agentes do 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 autônomos | Coordene tarefas de IA de longa duração ou multietapas que precisam sobreviver a reinicializações e períodos de espera. | Orquestrações duráveis iniciadas por eventos de aplicação | Escolha orquestração direta de Durable Functions ou fluxos de trabalho dinâmicos com habilidades hospedadas. |
Este artigo é específico da linguagem, portanto, certifique-se de escolher sua linguagem de programação na parte superior da página.
Habilidades hospedadas no Azure Functions
O Azure Functions hosted skills é um modelo de programação para construir capacidades inteligentes hostadas em nuvem e orientadas a eventos no Azure Functions. Você define comportamento com Markdown, instruções em linguagem natural e configuração declarativa. O ambiente de execução descobre arquivos .agent.md, registra gatilhos e endpoints e executa habilidades hospedadas quando eventos ocorrem.
Importante
As habilidades hospedadas no Azure Functions estão atualmente em versão prévia. Recursos, nomes de configuração e conectores com suporte podem ser alterados antes da disponibilidade geral.
Você não precisa escrever código em Python para definir uma habilidade hospedada. Você define seu comportamento, gatilhos e ferramentas configuradas em arquivos Markdown e de configuração. Se você precisar de lógica de aplicativo personalizada além dessas capacidades configuradas, pode adicionar ferramentas Python personalizadas.
Use habilidades hospedadas no Azure Functions quando quiser adicionar comportamento inteligente a uma aplicação orientada a eventos em resposta a uma requisição HTTP, agendamento, mensagem, mudança de dados, um evento de um conector gerenciado ou outro evento. Você também pode ativar um endpoint MCP integrado opcional que expõe cada habilidade hospedada como uma ferramenta com tecnologia de IA para outros aplicativos, agentes ou orquestradores de agentes.
Para começar, confira estes artigos:
- Visão geral: Habilidades hospedadas no Azure Functions
- Comece: Construa um aplicativo de IA orientado a eventos com habilidades hospedadas no Azure Functions
- Referência: Configuração de habilidades hospedadas no Azure Functions
Vinculações de agentes para Python
Importante
As vinculações de agente para aplicativos de função do Python estão em versão prévia. Recursos, nomes de pacotes e configurações podem mudar antes da disponibilidade geral.
As vinculações de agentes adicionam um objeto configurado do Microsoft Agent Framework Agent a uma invocação padrão de função em Python. A função mantém o controle de sua lógica de disparo e de aplicação determinística, e seu manipulador decide se, quando e como invocar o Agente.
Use vinculações de agentes quando a função Python é o modelo de execução principal e o raciocínio de agente é uma parte limitada de seu trabalho. Use habilidades hospedadas no Azure Functions quando uma habilidade hospedada definida declarativamente for o modelo principal de execução da aplicação. Use o Microsoft Agent Framework SDK diretamente quando seu código precisar controlar todo o ciclo de vida do Agente, em vez de receber um Agente configurado por meio de um binding.
As associações de agente também dão suporte a chamadas de agente seguras para reprodução em orquestrações do Durable Functions. Para saber mais e começar, veja Agent bindings para Python no Azure Functions.
Ferramentas e servidores MCP
Os modelos e agentes de IA usam a chamada 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.
As funções são particularmente adequadas para implementar a chamada de função em fluxos de trabalho agênticos porque ela é dimensionada com eficiência para lidar com a demanda e fornece extensões de associação que simplificam a conexão de agentes com serviços do Azure remotos. 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 de plataforma.
MCP é o padrão da indústria para interação com servidores remotos. Ele fornece uma maneira padronizada para que os modelos e agentes de IA se comuniquem com sistemas externos. Ao usar um servidor MCP, esses clientes de IA podem determinar de forma eficiente as ferramentas e capacidades de um sistema externo.
Azure Functions atualmente dá suporte à exposição do código de função usando estes tipos de ferramentas:
| Tipo de ferramenta | Descrição |
|---|---|
| Endpoint MCP integrado para habilidades hospedadas | Disponibilize habilidades hospedadas que usam raciocínio de IA como ferramentas por meio de um endpoint MCP integrado. |
| Servidor MCP remoto | Crie ferramentas MCP determinísticas ou hospeder servidores MCP baseados em SDK para chamadas de ferramentas síncronas. |
| Ferramenta baseada em filas do Azure Functions | Use a ferramenta específica do Microsoft Foundry para chamadas de funções assíncronas através de filas de mensagens. |
Escolha como expor um endpoint MCP
O Functions suporta estas opções para expor capacidades por meio do MCP:
- Ative o endpoint MCP embutido para habilidades hospedadas no Azure Functions para expor ferramentas baseadas em IA definidas em
.agent.mdarquivos. As habilidades hospedadas estão atualmente em versão prévia. - Use a extensão de associação do MCP para criar e hospedar ferramentas MCP determinísticas, como você faria com qualquer outro aplicativo de função.
- Servidores MCP auto-hospedados criados com os SDKs oficiais do MCP. Esta opção de hospedagem está atualmente em versão prévia.
Aqui está uma comparação das opções atuais de endpoint MCP fornecidas pela Functions:
| Característica | Endpoint MCP integrado para habilidades hospedadas | Extensão de associação MCP | Servidores MCP auto-hospedados |
|---|---|---|---|
| Melhor ajuste | Exponha uma habilidade hospedada com IA como uma ferramenta MCP. | Crie ferramentas determinísticas do MCP com gatilhos e associações do Functions. | Hospede um servidor existente construído com um SDK oficial do MCP. |
| Nível de suporte atual | Preview | Disponível para o público geral | Visualizar* |
| Modelo de programação | Habilidade .agent.md hospedada |
Funções, gatilhos e associações | SDKs padrão do MCP |
| Execução com estado | Histórico de sessões suportado | Suportado | Sem suporte no momento |
| Linguagens de código personalizadas | Python (ferramentas personalizadas opcionais) | C# (processo isolado) Python TypeScript JavaScript Java |
C# (processo isolado) Python TypeScript Java |
| Plano de hospedagem | Consumo Flexível Premium Dedicado (Serviço de Aplicativo) |
Planos de hospedagem suportados pelo Azure Functions | Consumo Flexível apenas |
| Outros requisitos | Ativar builtin_endpoints.mcp na habilidade hospedada |
None | Servidor sem estado que usa transporte HTTP Streamable |
| Como implementado | endpoint MCP integrado ao runtime de hosted-skills | Extensão de associação MCP | Manipuladores personalizados |
*Os detalhes de configuração para servidores MCP auto-hospedados podem mudar durante a pré-visualização.
Use os seguintes recursos específicos de linguagem para começar a usar 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 associação MCP | Servidores MCP auto-hospedados |
|---|---|---|
| Documentation | Extensão de associação MCP | Não aplicável |
| Samples | Servidor MCP personalizado remoto | servidor Weather |
| Modelos | HelloTool | Não aplicável |
Para Python, compare estes recursos para a extensão MCP e a hospedagem baseada em SDK:
| Opções | Extensão de associação MCP | Servidores MCP auto-hospedados |
|---|---|---|
| Documentation | Extensão de associação MCP | Não aplicável |
| Samples | Servidor MCP personalizado remoto | servidor Weather |
Para o TypeScript, compare estes recursos da extensão MCP e da hospedagem baseada em SDK:
| Opções | Extensão de associação MCP | Servidores MCP auto-hospedados |
|---|---|---|
| Documentation | Extensão de associação MCP | Não aplicável |
| Samples | Servidor MCP personalizado remoto | servidor Weather |
Para JavaScript, use os recursos da extensão MCP. Hospedagem baseada em SDK é suportada, mas um quickstart em JavaScript não está disponível no momento.
| Opções | Extensão de associação MCP | Servidores MCP auto-hospedados |
|---|---|---|
| Documentation | Extensão de associação MCP | Não aplicável |
| Samples | Ainda não está disponível | Ainda não está disponível |
Para Java, use a documentação da extensão MCP. Amostras específicas de idiomas não estão disponíveis atualmente.
| Opções | Extensão de associação MCP | Servidores MCP auto-hospedados |
|---|---|---|
| Documentation | Extensão de associação MCP | Não aplicável |
| Samples | Ainda não está disponível | Ainda não está disponível |
No momento, o PowerShell não tem suporte para nenhuma das opções de hospedagem do servidor MCP.
Escolha ferramentas do Azure Functions baseadas em filas para o Microsoft Foundry Agent Service
O Microsoft Foundry Agent Service também oferece uma ferramenta específica para Azure Functions para chamadas de funções assíncronas. O agente faz uma solicitação em uma fila de entrada do Armazenamento de Filas do Azure. Uma função acionada por uma fila processa a solicitação e retorna o resultado por meio de uma fila de saída.
Use esta integração específica da Foundry para operações em segundo plano que não exigem uma resposta imediata e se beneficiam de entrega confiável de mensagens e novas tentativas. Para interações síncronas ou ferramentas que você deseja reutilizar com outros clientes de IA, use um servidor MCP em vez disso.
Ferramentas do Azure Functions baseadas em fila exigem um agente Foundry com a configuração padrão. Para revisar SDKs suportados e construir uma ferramenta, veja Use Azure Functions with Foundry Agent Service.
Fluxos de trabalho autônomos
Use Funções Duráveis quando o código do seu aplicativo definir uma sequência confiável de chamadas de agentes, chamadas de modelos, aprovações e outras tarefas. Durable Functions preserva o estado da orquestração durante esperas e reinicializações e oferece suporte a padrões comuns, como encadeamento de funções, fan-out/fan-in e interação humana.
Se você usar habilidades hospedadas no Azure Functions, fluxos de trabalho dinâmicos oferecem uma opção de pré-visualização na qual um modelo cria um plano estruturado de chamadas de ferramentas, tarefas de subagentes e esperas. O runtime de habilidades hospedadas executa esse plano como uma orquestração do Durable Functions. Use a invocação direta de ferramentas quando a tarefa puder ser concluída em uma única interação e use um fluxo de trabalho dinâmico quando a tarefa precisar ir além de uma única interação, se ramificar, aguardar ou sobreviver a reinicializações.
| 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 controle explícito, repetições, esperas e aprovações | Use o modelo de programação Durable Functions para sua linguagem. |
| Fluxo de trabalho dinâmico de habilidades hospedadas | modelo de IA | Fluxos de trabalho adaptativos que planejam chamadas de ferramentas, tarefas de subagentes, períodos de espera e ramificações paralelas em tempo de execução | Prévia; requer habilidades hospedadas no Azure Functions. |
Para orientações de implementação, veja Padrões de Aplicação e Criar e executar fluxos de trabalho dinâmicos.
Ferramentas e estruturas de IA para Azure Functions
Com o Functions, você pode criar aplicativos no seu idioma preferido e usar suas bibliotecas favoritas. Devido a essa flexibilidade, você pode usar uma ampla gama de bibliotecas e estruturas de IA em seus aplicativos de funções habilitados para IA.
Essas plataformas e frameworks de IA da Microsoft suportam diferentes arquiteturas de aplicações:
| Plataforma ou estrutura | Melhor ajuste | Como funciona com o Azure Functions |
|---|---|---|
| Estrutura do Microsoft Agent | Lógica de agentes centrada em código e fluxos de trabalho executados em sua aplicação | Execute os SDKs do framework no seu código de função. |
| Microsoft Foundry Agent Service | Agentes gerenciados que utilizam ferramentas hospedadas em Funções | Crie e gerencie agentes como um serviço hospedado. Agentes Foundry podem chamar ferramentas hospedadas por Funções via MCP, filas ou OpenAPI. |
| SDKs do Microsoft Foundry | Chamadas diretas a modelos e serviços que não exigem um agente gerenciado | Chame os modelos e serviços do Foundry diretamente no código da sua função. |
No Functions, seus aplicativos também podem referenciar bibliotecas e frameworks de terceiros, então você pode usar todas as suas ferramentas e bibliotecas de IA favoritas em suas funções habilitadas por IA.
Artigos relacionados
- Cenários do Azure Functions
- Usar conectores no Azure Functions