Endpoint de mensagens de agente

O endpoint de mensagens do agente é o endpoint onde você envia mensagens de notificação agentical para seu agente.

Excluir endpoint de mensagens do agente

Use o a365 cleanup blueprint --endpoint-only comando para limpar o registro do ponto de extremidade de mensagens do agente. Esse comando não afeta o código do seu agente nem o endpoint implantado. Ele remove apenas a entrada de registro.

Para agentes do M365 (Teams, Copilot), passe --m365 para limpar o endpoint pelo Teams Graph:

# M365 agents — clears via Teams Graph (MCP Platform)
a365 cleanup blueprint --endpoint-only --m365

# Non-M365 agents — prints the Teams Developer Portal URL for manual configuration
a365 cleanup blueprint --endpoint-only

Configurar o endpoint de mensagens em a365.config.json

Antes de definir o endpoint de mensagens, especifique-o no seu a365.config.json arquivo de configuração. Este arquivo contém a configuração principal para a implantação do seu agente.

Adicione ou atualize estas propriedades de configuração do endpoint de mensagens:

{
  "messagingEndpoint": "https://your-endpoint-url.com/api/messages",
  "deploymentProjectPath": "."
}

  • messagingEndpoint: Especifique a URL exata do endpoint onde você pode enviar mensagens para o agente.

  • deploymentProjectPath: caminho para o diretório do projeto do agente. Essa propriedade não será relevante se o agente já estiver implantado e você não precisar atualizar a configuração do ambiente. Defina deploymentProjectPath para . somente se o código do agente não estiver localizado na sua máquina.

Propriedades de configuração

Propriedade Description Obrigatório Default Example
messagingEndpoint A URL onde seu agente recebe mensagens Yes Nenhum https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Caminho para o diretório de projeto do agente para atualizações de configuração No . ./my-agent ou .

Opções de configuração do endpoint

O messagingEndpoint valor depende do seu cenário de implantação:

Para implantações do Azure:

  • aplicativo Web Azure: https://your-app-name.azurewebsites.net/api/messages

Para implantações que não são do Azure:

  • AWS: https://your-api-gateway-url.amazonaws.com/api/messages
  • GCP: https://your-cloud-run-url.run.app/api/messages
  • Outros provedores de nuvem: URL personalizada do seu endpoint

Para testes locais com Túneis de Desenvolvimento:

  • URL do Túnel de Desenvolvimento: https://abc123xyz.devtunnels.ms:3978/api/messages

Important

O deploymentProjectPath especifica onde a CLI procura arquivos de projeto e onde atualiza a configuração do ambiente, como arquivos de .env.

Note

Ao usar Túneis de Desenvolvimento para testes locais, atualize o messagingEndpoint em a365.config.json com a URL do seu Túnel de Desenvolvimento antes de executar o comando de configuração. Para mais informações, veja testes com Dev Tunnels.

Definir o endpoint de mensagens do agente

Depois de atualizar o a365.config.json arquivo, use este comando para registrar o ponto de extremidade de mensagens para que o serviço do Agente 365 possa enviar notificações ao seu agente.

Para agentes M365 (Teams, Copilot), passe --m365 para se registrar usando o Teams Graph:

# M365 agents — registers via Teams Graph (MCP Platform)
a365 setup blueprint --endpoint-only --m365

# Non-M365 agents — prints the Teams Developer Portal URL for manual configuration
a365 setup blueprint --endpoint-only

Durante os testes locais, você pode definir esse endpoint como um Dev Tunnel antes de implantar o agente na nuvem. Para mais informações, veja testes com Dev Tunnels.

Para atualizar uma URL de ponto de extremidade existente:

a365 setup blueprint --update-endpoint https://your-new-host.example.com/api/messages --m365

Implantação do endpoint

Se você ainda não tiver seu agente implantado na nuvem, aprende como implantar o agente no Azure.

Se você já tem seu agente implantado na nuvem, pode definir o endpoint de mensagens como mostrado anteriormente.

Aprenda como configurar o endpoint de mensagens em algumas outras nuvens populares:

  • Last updated on