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. As versões preliminares da Frontier estão sujeitas aos termos de versão preliminar existentes dos contratos de cliente. Como esses recursos ainda estão em desenvolvimento, sua disponibilidade e capacidades podem mudar ao longo do tempo.

O ponto de extremidade de mensagens do agente é o ponto de extremidade onde você envia mensagens de notificação do agente 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 exclui a entrada de registro desse ponto de extremidade 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",
  "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 Padrão Example
messagingEndpoint A URL onde seu agente recebe mensagens Yes None https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Caminho para o diretório de projeto do agente para atualizações de 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 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

Importante

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 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

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