Compartilhar via

Endpoint de mensagens de agente

Importante

Você precisa fazer parte do programa de prévia Frontier para obter acesso antecipado ao Microsoft Agent 365. A Frontier conecta você diretamente às mais recentes inovações de IA da Microsoft. Prévias da Frontier estão sujeitas aos termos de visualização prévia existentes dos seus contratos com clientes. Como esses recursos ainda estão em desenvolvimento, sua disponibilidade e capacidades podem mudar ao longo do tempo.

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 comando a365 cleanup blueprint --endpoint-only para excluir a entrada do endpoint de mensagens do agente. Esse comando não afeta o código do seu agente nem o endpoint implantado. Apenas apaga a entrada de registro desse endpoint para o seu agente.

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",
  "needDeployment": false,
  "deploymentProjectPath": "."
}

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

  • needDeployment: indique à CLI se deseja implantar seu código em um aplicativo Web Azure.

  • deploymentProjectPath: Implante o código do seu agente na nuvem. Essa propriedade não é relevante caso o seu agente já esteja implantado e você não precise implantá-lo novamente. 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 Padrão Example
messagingEndpoint A URL onde seu agente recebe mensagens Yes None https://your-app.azurewebsites.net/api/messages
needDeployment Se a CLI deve ser implantada em Azure (true) ou se você está auto-hospedando (false) Não true false para túneis AWS/GCP/Dev
deploymentProjectPath Caminho para o diretório do seu projeto de agente para atualizações de implantação e configuração Não . ./my-agent ou .

Opções de configuração do endpoint

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

Para implantações de Azure (needDeployment: true):

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

Para implantações não Azure (needDeployment: false):

  • 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 Dev Tunnels (needDeployment: false):

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

Importante

  • Ao implantar no Azure, defina needDeployment como true. A CLI gerencia automaticamente a implantação.
  • Para AWS, GCP ou Dev Tunnels, defina needDeployment para false indicar que você está gerenciando a implantação separadamente.
  • O deploymentProjectPath especifica onde a CLI procura arquivos de projeto e onde atualiza a configuração do ambiente, como arquivos de .env.

Observação

Ao usar Dev Tunnels para testes locais, atualize o messagingEndpoint entrada a365.config.json com a URL do seu Dev Tunnel e defina needDeployment para false antes de executar o comando de configuração. Para mais informações, veja testes com Dev Tunnels.

Definir o endpoint de mensagens do agente

Após atualizar seu a365.config.json arquivo, use este comando para registrar o endpoint de mensagens no serviço Agent 365, para que ele possa enviar notificações ao seu agente.

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.

a365 setup blueprint --endpoint-only

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