Conectar-se a um agente do Microsoft Foundry (pré-visualização)

Note

Este artigo descreve as funcionalidades utilizadas em agentes ou fluxos de agente com tecnologia de plataforma standard.

[Este artigo é uma documentação de pré-lançamento e está sujeito a alterações.]

Pode ligar um Agente do Microsoft Foundry ao seu agente personalizado, permitindo-lhe chamar este agente para responder a um utilizador ou a um acionador.

Importante

Este artigo contém documentação de pré-visualização do Microsoft Copilot Studio e está sujeito a alterações.

As funcionalidades de pré-visualização não se destinam a ser utilizadas em ambiente de produção e podem ter funcionalidades restritas. Esses recursos estão disponíveis antes de um lançamento oficial para que você possa obter acesso antecipado e fornecer feedback.

Se você estiver criando um agente pronto para produção, consulte Visão geral do Microsoft Copilot Studio.

Pré-requisitos

Antes de ligar um agente Microsoft Foundry ao Copilot Studio, o agente Foundry deve ter o endpoint do protocolo Activity ativado. Um agente Foundry recém-criado expõe apenas os endpoints de Respostas e do protocolo A2A por defeito. Se o endpoint Activity não estiver ativado, a ligação ao Copilot Studio falha em tempo de execução com um erro 400. Saiba mais em Ativar A2A de entrada num agente do Foundry.

Atualmente, pode ativar o endpoint Activity apenas programaticamente, usando a API REST ou o SDK Python. Não há opção para o ativar a partir do portal da Microsoft Foundry. Saiba mais sobre o procedimento de habilitação em Configurar e partilhe o seu agente.

Depois de ativar o ponto final de Atividade, a secção Pontos finais do portal do Foundry para o agente continua a mostrar apenas Respostas e A2A. Esta omissão na interface é esperada e não significa que a alteração tenha falhado. A ligação ao Copilot Studio funciona após a aplicação da atualização.

Liga-te a um agente Microsoft Foundry

1. Vá para a página Agentes do seu agente principal e selecione Adicionar um agente.

2. Em Ligar a um agente externo, selecione Microsoft Foundry entre os tipos de agentes disponíveis.

3. Selecione a ligação desejada da lista de ligações disponíveis ou crie uma nova ligação entre a Microsoft Foundry e o seu agente do Copilot Studio. Para criar uma nova ligação, é necessário fornecer o URL do ponto final do projeto Foundry.

   Note

   Ao ligar-se a agentes Microsoft Foundry a partir do Copilot Studio, só pode ligar-se a agentes criados no novo portal Microsoft Foundry. Ligar a um agente criado no portal anterior leva a um erro que indica 404 - Version not found.

4. Uma vez criada a ligação, selecione Seguinte.

5. Introduza um Nome apropriado e uma Descrição apropriada para o seu agente do SDK. A descrição deve descrever o propósito do seu agente do Microsoft Foundry, permitindo que o seu agente principal perceba quando deve ser utilizado. Para obter mais informações, consulte escrever metadados eficazes.

6. Introduza o ID do Agente do agente do Microsoft Foundry ao qual quer ligar-se.

7. Ajuste a descrição (se necessário) para a tornar mais contextual para o agente principal. Por exemplo, torne a descrição mais específica se tiver outras ferramentas ou agentes onde as descrições possam sobrepor-se. Atualize a descrição para garantir que o Copilot Studio consegue perceber quando invocar este agente.

8. Selecione Adicionar Agente.

9. Assim que o seu agente for criado, pode testá-lo imediatamente. Se precisar de ajustar o ID do Agente mais tarde, pode fazê-lo a partir da página de detalhes, selecionando o seu agente na lista de Agentes.

Note

• Se a sua primeira chamada de teste para o agente do Foundry conectado falhar com um erro semelhante a "O conector 'Serviço de Agente do Azure AI Foundry' retornou um erro HTTP com o código 400." Erro Interno: O endpoint do agente <name> não suporta atividade. Por favor, atualize o endpoint do agente para suportar este protocolo.", o agente Foundry não tem o endpoint do protocolo Activity ativado. Consulte Pré-requisitos neste artigo e, em seguida, ative o endpoint Activity seguindo as instruções em Configure e partilhe o seu agente na documentação do Microsoft Foundry.

• És responsável por rever e testar cuidadosamente os agentes ligados no contexto dos teus casos de uso específicos, bem como por tomar todas as decisões e personalizações apropriadas. Quando se liga a agentes fora do Copilot Studio, é responsável pela utilização desses agentes. As considerações incluem garantir:

  • Os fluxos de dados, o tratamento e a partilha de dados entre agentes são adequados ao seu caso de uso e cumprem os requisitos e leis relevantes.
  • Os agentes cumprem normas adequadas em matéria de qualidade, fiabilidade, segurança e confiança.
  • São previstas permissões, limites e aprovações apropriadas, se for prudente para o seu caso de uso.
  • Estão implementadas a observabilidade, identidade e rastreabilidade adequadas, bem como funções de supervisão humana.