Integração com aplicativos nativos usando o SDK do Agents Client

Note

Este artigo descreve as funcionalidades usadas em agentes ou fluxos de agentes alimentados pelo arnês padrão.

Importante

Este 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 ambientes de desenvolvimento integrado (IDEs). Criar essa integração requer experiência em desenvolvimento de software.

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

Com o SDK do Agents Client, estamos introduzindo a multimodalidade na interação usuário-agente. Os usuários agora podem se comunicar com os agentes por meio de texto ou voz, enquanto compartilham o contexto por meio de imagens ou captura de tela.

A primeira versão do SDK suporta 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 suporta apenas usuários não autenticados e pode ser usado em aplicativos nativos se você considerar esse uso apropriado e necessário para seus usuários finais.

Configurar seu agente para aplicativos nativos

  1. Vá para o seu agente no Copilot Studio selecionando Agents e, em seguida, o seu agente.

  2. Em Configurações>de Autenticação de Segurança>, selecione Sem Autenticação.

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

  3. Vá para a página Canais do seu agente.

    Com Sem autenticação selecionada, recomenda-se uma revisão.

    Captura de ecrã da página Canais do agente com recomendação de revisão devido à seleção Sem autenticação.

  4. Selecione Publicar.

    A tela Publicar este agente é exibida.

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

  5. Selecione Publicar. O seu agente é publicado e está disponível para uso com o SDK do cliente.

Obtenha as informações necessárias para integrar com o SDK

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

  1. Vá para o seu agente no Copilot Studio selecionando Agentes e, em seguida, selecionando o 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 o ID do ambiente e o nome do esquema para o agente.

  3. Anote o ambiente de implantação do seu 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 Agents Client

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

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

  • Last updated on