Ponto de extremidade de mensagens do agente

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 ponto de extremidade de mensagens do agente

Use o comando a365 cleanup blueprint --endpoint-only para 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 ponto de extremidade implantado. Ele apenas remove a entrada de registro via Teams Graph (Plataforma MCP).

a365 cleanup blueprint --endpoint-only

Configure o ponto de extremidade de mensagens em a365.config.json

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

Adicione ou atualize essas propriedades de configuração do ponto de extremidade de mensagens:

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

• messagingEndpoint: especifique a URL exata do ponto de extremidade onde você pode enviar mensagens para o agente.

• deploymentProjectPath: Caminho para o diretório do seu projeto de agente. Essa propriedade não é relevante caso o seu agente já esteja implantado e você não precise atualizar a configuração do ambiente. Defina deploymentProjectPath como . somente se o código do agente não estiver localizado em seu computador

Propriedades de configuração

Opções de configuração do ponto de extremidade

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

Para Implantações do Azure:

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

Para implantações fora 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 do ponto de extremidade personalizado

Para testes locais com Túneis do Desenvolvedor:

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

Definir ponto de extremidade de mensagens do agente

Depois de atualizar o arquivo a365.config.json, use este comando para registrar o ponto de extremidade de mensagens para que o serviço do Agent 365 possa enviar notificações ao seu agente. A operação --endpoint-only registra o ponto de extremidade por meio do Teams Graph (Plataforma MCP).

a365 setup blueprint --endpoint-only

Você também pode passar a URL diretamente com --messaging-endpoint, em vez de editar a365.config.json:

a365 setup blueprint --endpoint-only `
  --messaging-endpoint https://your-app.azurewebsites.net/api/messages

Durante os testes locais, você pode configurar esse ponto de extremidade para apontar para um ponto de extremidade do Túnel do Desenvolvedor antes de implantar o agente na nuvem. Para obter mais informações, consulte teste com Túneis do Desenvolvedor.

Para atualizar uma URL de ponto de extremidade existente:

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

Implantação do ponto de extremidade

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

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

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

• Amazon Web Services
• Google Cloud Platform