Conectar a um agente do Microsoft Foundry (versão preliminar)

Note

Este artigo descreve recursos usados em agentes ou fluxos de agente da plataforma do agente padrão.

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

Você pode conectar um Agente do Microsoft Foundry ao agente personalizado, permitindo a ele chamar esse agente para atender a um usuário ou a um gatilho.

Importante

Este artigo contém a documentação da versão preliminar do Microsoft Copilot Studio e está sujeito a alterações.

As funcionalidades de pré-visualização não se destinam à utilização 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 comentários.

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

Pré-requisitos

Antes de conectar 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 por padrão apenas os endpoints de Respostas e do protocolo A2A . Se o endpoint Activity não estiver ativado, a conexão com o Copilot Studio falha em tempo de execução com um erro 400. Saiba mais em Habilitar A2A de entrada em um agente do Foundry.

Atualmente, você pode ativar o endpoint Activity apenas programaticamente, usando a API REST ou o SDK Python. Não há opção para habilitar isso pelo portal do Microsoft Foundry. Saiba mais sobre o procedimento de habilitação em Configure e compartilhe seu agente.

Depois que você habilitar o ponto de extremidade Atividade, a seção Pontos de Extremidade do portal Foundry do agente continuará mostrando apenas Respostas e A2A. Essa omissão na interface é esperada e não significa que a mudança falhou. A conexão com o Copilot Studio funciona após a atualização ser aplicada.

Conectar-se a um agente do Microsoft Foundry

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

2. Em Conectar-se a um agente externo, selecione Microsoft Foundry entre os tipos de agente disponíveis.

3. Selecione a conexão desejada na lista de conexões disponíveis ou crie uma nova conexão entre o Microsoft Foundry e seu agente do Copilot Studio. Para criar uma nova conexão, você precisa fornecer a URL do ponto de extremidade do projeto Foundry.

   Note

   Ao se conectar aos agentes do Microsoft Foundry do Copilot Studio, você só pode se conectar aos agentes criados no novo portal do Microsoft Foundry. Conectar-se a um agente criado no portal anterior gera um erro indicando 404 - Version not found.

4. Depois que a conexão for criada, selecione Avançar.

5. Insira um Nome e uma Descrição apropriados para o seu agente SDK. A descrição deve declarar a finalidade do agente do Microsoft Foundry, permitindo ao agente principal compreender quando ele deve ser usado. Para obter mais informações, consulte escrita de metadados eficazes.

6. Insira a ID do agente do Microsoft Foundry ao qual você deseja se conectar.

7. Ajuste a descrição (se necessário) para deixá-la mais contextual para o agente principal. Por exemplo, deixe a descrição mais específica se você tiver outras ferramentas ou agentes nos quais as descrições possam se sobrepor. Atualize a descrição para garantir que o Copilot Studio entenda quando invocar esse agente.

8. Selecione Adicionar Agente.

9. Assim que o agente for criado, você poderá testá-lo imediatamente. Se precisar ajustar a ID do agente depois, você poderá fazer isso na página de detalhes, selecionando o agente na lista Agentes.

Note

• Se a primeira chamada de teste para o agente do Foundry conectado falhar com um erro semelhante a "O conector 'Serviço de Agente da Fábrica de IA do Azure'" retornou um erro HTTP com 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. Veja Pré-requisitos neste artigo e, em seguida, ative o endpoint de Atividade seguindo as instruções em Configurar e compartilhar seu agente na documentação do Microsoft Foundry.

• Você é responsável por revisar e testar cuidadosamente os agentes conectados no contexto dos seus casos de uso específicos, além de tomar todas as decisões e personalizações apropriadas. Ao se conectar a agentes fora do Copilot Studio, você é responsável pelo uso desses agentes. Considerações incluem garantir:

  • Fluxos de dados, tratamento de dados e compartilhamento de dados entre agentes são adequados para o seu caso de uso e atendem aos requisitos e leis relevantes.
  • Os agentes atendem a padrões apropriados de qualidade, confiabilidade, segurança e caráter confiável.
  • Permissões, restrições e aprovações apropriadas são provisionadas, se isso for adequado para o seu caso de uso.
  • Observabilidade, identidade e rastreabilidade adequadas, bem como funções de supervisão humana, estão implementadas.