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.
As habilidades hospedadas no Azure Functions permitem adicionar raciocínio de IA aos seus aplicativos de funções. Em um arquivo .agent.md, você fornece instruções em linguagem natural, uma configuração de gatilho e vinculações opcionais de ferramentas. Quando um evento ocorre, o ambiente de execução chama um modelo, executa as ferramentas solicitadas pelo modelo e retorna um resultado. Você implanta o app como qualquer outro app de funções.
Para começar, escolha a experiência que se encaixe no seu objetivo:
- Para criar e testar uma habilidade hospedada localmente usando uma tela interativa no GitHub Copilot, veja Construir e testar uma habilidade hospedada com a tela de habilidades hospedadas no Azure Functions.
- Para provisionar recursos do Azure e implantar um aplicativo completo de habilidades hospedado usando a CLI do Azure Developer (
azd), veja Construir um aplicativo de IA orientado a eventos com habilidades hospedadas no Azure Functions.
Para obter a documentação do runtime mais atualizada e abrangente, consulte Azure Functions Agents Runtime.
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.
Uma habilidade hospedada é uma única unidade de trabalho alimentada por IA definida em um .agent.md arquivo. Cada habilidade hospedada é mapeada para uma Função do Azure. Uma habilidade isoladamente refere-se a orientações reutilizáveis do Markdown armazenadas em um SKILL.md arquivo que habilidades hospedadas podem carregar sob demanda.
Quando usar habilidades hospedadas
Use habilidades hospedadas no Azure Functions quando um evento de negócio precisar de raciocínio de IA antes de agir. Por exemplo:
- Triagem dos e-mails recebidos. Um gatilho de conector é acionado quando uma reclamação chega em uma caixa de correio compartilhada. A habilidade hospedada lê a mensagem, classifica a gravidade e a direciona para a fila de suporte correta.
- Enriqueça novos leads de CRM. Um gatilho do conector é acionado quando um lead é adicionado ao Salesforce ou ao Dynamics 365. A habilidade hospedada busca na internet por contexto sobre o lead e envia um resumo para o vendedor designado.
- Valide as alterações dos dados. Um blob ou um gatilho de banco de dados é ativado quando um registro de receita é atualizado. A habilidade hospedada verifica se a receita caiu abaixo de um limite, gera uma explicação e inicia um fluxo de trabalho de revisão.
- Sirva uma ferramenta MCP específica para cada domínio. Um agente externo ou harness de agente invoca uma habilidade hospedada por HTTP ou MCP. A habilidade hospedada aplica lógica de IA a dados em armazenamento ou banco de dados e retorna uma resposta estruturada, atuando como uma ferramenta inteligente e específica de domínio que outros clientes de IA podem consumir.
Habilidades hospedadas são uma boa opção quando você precisa de gatilhos orientados a eventos, raciocínio de IA com ferramentas e os recursos operacionais do Azure Functions (identidade gerenciada, monitoramento, escala até zero e integração com rede virtual).
Para exemplos que combinam eventos, raciocínio de IA e sistemas de negócios, veja Cenários de habilidades hospedadas no Azure Functions.
Por que usar Funções para seus aplicativos de IA?
Cargas de trabalho de IA em produção precisam de mais do que um prompt e um modelo. Eles precisam de maneiras confiáveis para iniciar o trabalho, chamar sistemas externos, persistir o histórico de conversas, executar código não confiável com segurança, autenticar sem segredos, emitir telemetria e dimensionar sob demanda.
O Functions fornece um modelo de computação orientado a eventos para essas preocupações operacionais. As habilidades hospedadas no Azure Functions aplicam esse mesmo modelo ao seu código de IA. Os benefícios incluem:
- Cada habilidade hospedada é um
.agent.mdarquivo. Configuração declarativa e instruções em linguagem natural convivem juntas. Cada arquivo é mapeado para uma Função do Azure. - Eventos iniciam habilidades hospedadas. O Functions dispara habilidades hospedadas iniciais a partir de agendamentos, solicitações HTTP, mensagens de fila, alterações de blobs, eventos da Grade de Eventos, mensagens do Barramento de Serviço e outros eventos com suporte.
- Os recursos são configurados primeiro, com código quando você precisa dele. Você pode configurar habilidades hospedadas para usar servidores MCP remotos, servidores MCP hospedados em namespaces de conectores, habilidades reutilizáveis e execução de código sandbox. Escreva suas próprias ferramentas baseadas em Python para lógica específica de aplicativos.
- A hospedagem do Azure Functions é integrada. As habilidades hospedadas no Azure Functions oferecem suporte aos planos Flex Consumption, Premium e Dedicated (App Service). O Flex Consumption oferece escalonamento até zero, cobrança por segundo e escalonamento automático. Todos os planos suportam identidade gerenciada, integração com redes virtuais e Insights de Aplicação.
- A hidráulica operacional é cuidada por você. O runtime gerencia a descoberta de habilidades hospedadas, o registro de gatilhos, a composição de ferramentas, o histórico de sessões e endpoints integrados opcionais.
Trabalha com outras plataformas de IA da Microsoft
As habilidades hospedadas no Azure Functions são complementares a outras ofertas de IA da Microsoft e podem ser usadas junto com elas. O ponto ideal deles é construir capacidades inteligentes hospedadas em nuvem e orientadas a eventos no Azure Functions por meio de um modelo de programação acessível. Habilidades hospedadas podem expor recursos via HTTP ou MCP para uso por outros aplicativos, agentes e estruturas de agente.
Escolha a funcionalidade do Azure que melhor se encaixa no seu cenário:
| Scenario | Option |
|---|---|
| Expor funções determinísticas como ferramentas para outro cliente de IA | extensão MCP do Azure Functions |
| Orquestração de longa duração em vários passos com aprovações com intervenção humana | Durable Functions |
| Crie e gerencie agentes de IA sem hospedagem personalizada | Microsoft Foundry ou Copilot Studio |
Definição do projeto
Um aplicativo de habilidades hospedado no Azure Functions é um projeto padrão de aplicação de funções em Python v2, implantado junto com arquivos de projetos de habilidades hospedados. Os seguintes arquivos de projeto são sempre necessários para aplicativos de função Python:
| Arquivo | Purpose |
|---|---|
function_app.py |
Importa create_function_app() e retorna o aplicativo de Azure Functions configurado. |
host.json |
Configura o host do Azure Functions. |
requirements.txt |
Inclui o pacote de runtime de habilidades hospedadas e quaisquer dependências específicas de Python do app. |
Para mais informações, consulte o guia de referência para desenvolvedores do Azure Functions para aplicativos Python.
Importante
As habilidades hospedadas no Azure Functions suportam apenas funções de streaming HTTP. Qualquer outra função HTTP no mesmo aplicativo de habilidades hospedada também deve usar streaming. Combinar funções HTTP de streaming e não streaming dentro do mesmo app não é suportado. Para mais informações, veja fluxos HTTP em Python.
Arquivos de projetos de habilidades hospedados
O runtime descobre estes arquivos e pastas, que são implantados com o projeto do app:
| Arquivo ou pasta | Purpose |
|---|---|
*.agent.md |
Define habilidades hospedadas. O bloco de metadados YAML configura a habilidade hospedada, e o corpo em Markdown se torna as instruções. Seu projeto deve ter pelo menos um .agent.md arquivo. |
agents.config.yaml |
(Opcional) Define padrões de runtime para todo o app, como modelo, timeout e configurações sandbox. |
mcp.json |
Define os servidores HTTP MCP remotos que habilidades hospedadas podem usar como ferramentas, incluindo ferramentas conectoras para ações como enviar e-mails ou trabalhar com o Teams. |
tools/ |
(Opcional) Contém quaisquer ferramentas Python personalizadas que você crie para fornecer capacidades ainda não fornecidas por servidores MCP, conexões, habilidades ou execuções sandbox. |
skills/ |
(Opcional) Contém recursos de prompt reutilizáveis SKILL.md que as skills hospedadas podem carregar conforme necessário. |
Cada arquivo .agent.md usa um cabeçalho YAML, seguido de instruções em Markdown. Este exemplo define uma habilidade hospedada acionada por temporizador que roda diariamente às 15h (UTC):
---
name: Daily Tech News Email
description: Fetches top tech news and emails a summary daily.
trigger:
type: timer_trigger
args:
schedule: "0 0 15 * * *"
---
You are a news assistant. When triggered, do the following:
1. Gather today's top technology news from reputable sources.
1. Summarize the stories in a concise HTML email body.
1. Email the summary to $TO_EMAIL with the subject "Daily Tech News Summary".
A matéria inicial declara como a habilidade hospedada é invocada. O corpo de markdown é o bloco de instrução que o runtime passa para o modelo durante a execução. A substituição de variável de ambiente permite que instruções e valores de configuração referenciem configurações de aplicativo, como $TO_EMAIL.
Cada .agent.md arquivo define uma habilidade hospedada. O nome do arquivo deriva o nome da Azure Function e o segmento de rota para pontos de extremidade internos. O name campo é um nome de exibição para logs, rótulos e documentação.
Para a lista completa de campos do arquivo .agent.md, opções de configuração do aplicativo e regras de substituição de variáveis, consulte a referência de habilidades hospedadas do Azure Functions.
Crie e teste com o canvas de skills hospedado
Como parte da versão prévia de habilidades hospedadas, o Azure Functions disponibiliza uma tela de habilidades hospedadas opcional no GitHub Copilot. A tela é uma superfície interativa onde você e o GitHub Copilot podem criar um aplicativo inicial, escolher controles de evento de temporizador, HTTP ou fila, editar as instruções sobre habilidades, selecionar um modelo compatível, iniciar o host local do Functions, invocar o gatilho e inspecionar a atividade e o resultado.
A partir do canvas, você pode abrir o projeto gerado no Visual Studio Code ou usar a ação embutida Deploy to Azure. A ação de implantação utiliza a CLI do Azure Developer (azd).
A tela orienta e visualiza o fluxo de trabalho de desenvolvimento, mas não substitui o ambiente de execução de habilidades hospedado nem o formato do projeto. Um aplicativo criado por meio do canvas permanece como um aplicativo padrão de funções Python v2 que usa os arquivos hospedados do projeto de skills. Você pode continuar a editar, executar e implantar o aplicativo fora da tela.
O guia de início rápido da tela concentra-se na criação, execução e inspeção de uma habilidade hospedada local, acionada por temporizador. Para o fluxo de trabalho guiado, veja como criar e testar uma habilidade hospedada com a tela de habilidades hospedadas do Azure Functions.
Processo de inicialização do aplicativo
Quando o host de Funções carrega o aplicativo, o método create_function_app localiza arquivos .agent.md, servidores MCP, habilidades e ferramentas personalizadas no projeto. Ele valida a configuração, monta as ferramentas para cada habilidade hospedada e registra os gatilhos e endpoints necessários.
Quando um gatilho dispara, o runtime constrói a habilidade hospedada com suas instruções resolvidas, modelo, ferramentas e histórico de sessão, e então a executa.
Habilidades hospedadas pelo Trigger em eventos
O runtime suporta vários gatilhos no seu aplicativo, mas apenas um gatilho por arquivo .agent.md. Uma definição de gatilho tem um objeto type e um objeto args. O type identifica a associação de gatilho, e args contém as configurações específicas do gatilho que definem qual evento inicia a habilidade hospedada.
Os padrões de gatilho comuns incluem:
| Pattern | Example |
|---|---|
| HTTP | Receber uma solicitação, chamar ferramentas e retornar uma resposta estruturada. |
| Programação | Execute um relatório diário, resumo, limpeza ou fluxo de trabalho de reconciliação. |
| Fila ou mensagem | Processar itens de trabalho que precisam de raciocínio de modelo ou chamadas de ferramenta. |
| Evento de armazenamento ou banco de dados | Reagir a arquivos, registros ou eventos alterados. |
| Gatilho do conector | Reaja a eventos de conectores gerenciados, como mensagens do Teams, correspondências do Outlook ou eventos de calendário suportados pelo conector. |
Para obter detalhes sobre a configuração de gatilhos, os tipos compatíveis e a args referência, consulte a referência das habilidades hospedadas no Azure Functions.
Ferramentas de IA suportadas
As habilidades hospedadas pelo Azure Functions suportam vários tipos de ferramentas. Comece com capacidades configuradas e use ferramentas Python personalizadas para lógica específica de aplicativos que não se encaixem nessas opções.
Servidores MCP remotos
Defina servidores remotos HTTP ou HTTP MCP com streaming em mcp.json. O runtime descobre esses servidores e disponibiliza suas ferramentas para todas as habilidades hospedadas. Use servidores MCP remotos quando habilidades hospedadas precisarem chamar ferramentas hospedadas por outro serviço ou compor capacidades através dos limites do app.
Conectores do Azure
Conectores permitem que habilidades hospedadas trabalhem com serviços externos sem código cliente personalizado de API. Um Namespace de Conectores hospeda conexões, triggers e servidores MCP para serviços como Microsoft 365 Outlook, Teams, Salesforce, SAP ou SQL. Use gatilhos do conector para iniciar habilidades hospedadas a partir de eventos externos e ferramentas MCP do conector para chamar ações de serviço a partir das instruções de habilidades hospedadas.
Habilidades
Armazene os prompts reutilizáveis sob a skills/ pasta. Cada pasta de habilidades contém um SKILL.md arquivo com nome, descrição e instruções de marcação. O runtime descobre automaticamente habilidades e as disponibiliza para habilidades hospedadas. As habilidades ajudam a manter as instruções básicas pequenas enquanto disponibilizam orientações específicas para cada domínio quando necessário.
Execução em área restrita
O runtime pode usar sessões dinâmicas dos Aplicativos de Contêiner do Azure para dar às habilidades hospedadas uma ferramenta execute_python. Essa ferramenta roda Python em um pool de sessões isolado, o que é útil para execução de código e análise de dados. Configure o endpoint do pool de sessões em agents.config.yaml.
Ferramentas de Python personalizadas
Use ferramentas Python personalizadas para capacidades específicas de cada app. Adicione arquivos .py à pasta tools/ e decore as funções com @tool do pacote de runtime. O runtime descobre e registra automaticamente essas ferramentas.
Para detalhes de configuração, tabelas de campos e exemplos de código para cada tipo de ferramenta, veja a referência de habilidades hospedada do Azure Functions.
Fluxos de trabalho dinâmicos
Fluxos de trabalho dinâmicos permitem que tarefas de IA compatíveis iniciem planos duradouros de várias etapas, compostos por chamadas de ferramentas compatíveis com fluxos de trabalho, tarefas de subagentes e etapas de espera. Eles estendem o padrão de chamada de ferramentas programáticas com Durable Functions para que uma tarefa possa dispersar o trabalho, rodar especialistas isolados, esperar por temporizadores duráveis, sobreviver a reinícios de trabalhadores e manter resultados intermediários grandes fora da conversa até que um resumo final esteja pronto.
Na superfície experimental v1 atual, ative fluxos de trabalho em um arquivo executável .agent.md de forma independente. Tarefas de fluxo de trabalho podem chamar funções Python que você decora explicitamente com @workflow_tool ou tarefas especializadas que você disponibiliza por meio de workflows.subagents. Para mais informações, veja Fluxos de trabalho dinâmicos em habilidades hospedadas no Azure Functions.
Sessões e estado
Interações em múltiplos turnos precisam de histórico de sessão. No Azure, o tempo de execução armazena o histórico da sessão no Armazenamento de Blobs usando a conta AzureWebJobsStorage do aplicativo de função. Para desenvolvimento local, o runtime volta ao histórico de sessão baseado em arquivos. A execução em sandbox também tem reconhecimento de sessão e usa sessões isoladas para execuções sem relação entre si.
Observability
A partir da azure-functions-agents-runtime versão 0.1.0b6, o runtime inclui um conjunto de recursos de observabilidade que ainda está em desenvolvimento ativo e sujeito a mudanças.
Para os detalhes mais recentes de configuração, campos de telemetria e orientações de uso, use a documentação do repositório em tempo de execução:
Para configurar o monitoramento, consultas KQL, uso de tokens, latência e verificações de conectores, veja Monitorar e solucionar problemas com habilidades hospedadas.
Conteúdo relacionado
- Cenários de habilidades hospedadas no Azure Functions
- Documentação de runtime do Azure Functions Agents
- Guia para desenvolvedores de habilidades hospedadas no Azure Functions
- Referência de habilidades hospedada no Azure Functions
- Construa e teste uma habilidade hospedada com a tela do Azure Functions para habilidades hospedadas
- Construa um aplicativo de IA orientado a eventos com habilidades hospedadas no Azure Functions
- Fluxos de trabalho dinâmicos em habilidades hospedadas pelo Azure Functions
- Use ferramentas e modelos de IA no Azure Functions
- Build um servidor MCP remoto personalizado usando Azure Functions
- Hospedagem do plano Flex Consumption