Integrar com aplicativos nativos usando o SDK do Cliente de Agentes

Importante

Esse conteúdo destina-se a profissionais de TI experientes, como administradores de TI ou desenvolvedores, que estão familiarizados com ferramentas de desenvolvedor, utilitários e IDEs (ambientes de desenvolvimento integrado). A criação dessa integração requer experiência em desenvolvimento de software.

O SDK do Cliente de Agentes é um SDK para plataformas Android, iOS e Windows. Esse SDK permite que você se comunique com agentes desenvolvidos usando o Copilot Studio ou o SDK do Microsoft 365 Agents, de aplicativos nativos do Android, iOS e Windows.

Com o SDK do Cliente do Agents, estamos introduzindo a multimodalidade à interação entre agente e usuário. Os usuários agora podem se comunicar com agentes por meio de texto ou voz, ao compartilhar o contexto por meio de imagens ou captura de tela.

A primeira versão do SDK dá suporte à comunicação baseada em texto e à renderização de cartões adaptáveis para usuários finais não autenticados ou anônimos com agentes criados no Copilot Studio. Você pode adicionar cartões adaptáveis a tópicos usando a opção Perguntar com cartão adaptável .

Importante

Atualmente, o SDK dá suporte apenas a usuários não autenticados e pode ser usado em aplicativos nativos se você considerar esse uso apropriado e necessário para os usuários finais.

Configurar seu agente para aplicativos nativos

  1. Acesse seu agente no Copilot Studio selecionando Agentes e, em seguida, seu agente.

  2. Em Configurações>de Autenticação de>, selecione Nenhuma Autenticação.

    Captura de tela da configuração de segurança Sem Autenticação habilitada para um agente no Copilot Studio.

  3. Vá até a página Canais do agente.

    Quando sem autenticação é selecionada, uma revisão é recomendada.

    Captura de tela da página Canais do agente mostrando que uma revisão é recomendada por causa da seleção de Sem autenticação.

  4. Selecione Publicar.

    A tela Publicar este agente é exibida.

    Captura de tela da tela de confirmação de publicação do agente no Copilot Studio.

  5. Selecione Publicar. Seu agente está publicado e disponível para uso com o SDK do Cliente.

Obter as informações necessárias para integrar ao SDK

Antes de adicionar a integração do agente ao código do aplicativo, você precisa de alguns detalhes do Copilot Studio sobre seu agente.

  1. Acesse seu agente no Copilot Studio clicando em Agentes e depois selecione seu agente.

  2. Vá para Configurações>Configurações Avançadas>Metadados.

    Anote a ID do ambiente e o Nome do esquema.

    Captura de tela da página Configurações avançadas mostrando environmentID e nome do esquema para o agente.

  3. Anote o ambiente de implantação do agente. Para copilotstudio.microsoft.com e copilotstudio.preview.microsoft.com, o ambiente de implantação é prod. Para copilotstudio.preprod.microsoft.com, o ambiente de implantação é preprod.

Saiba mais sobre o SDK do Cliente de Agentes

Em seguida, usando as informações coletadas, você pode integrar seu agente ao código do aplicativo nativo usando o SDK do Cliente de Agentes.

Para obter código e mais informações sobre como integrar seu agente ao seu aplicativo nativo, confira o repositório GitHub para sua plataforma de aplicativo de escolha:

  • Last updated on