Você precisa trazer seus próprios dados de negócios para o Copilot para obter respostas baseadas em documentos, bancos de dados ou ferramentas internas específicas da sua empresa. Os conectores do Copilot permitem vincular fontes de dados externas para que a IA possa ler e referenciar esse conteúdo durante as conversas. Este artigo explica o que são conectores do Copilot, quais pré-requisitos são necessários e fornece instruções passo a passo para adicionar uma fonte de dados personalizada. Ao final, você será capaz de configurar um conector que disponibiliza seus dados proprietários para o Copilot no Microsoft 365.
Principais Conclusões: Adicionar uma Fonte de Dados Personalizada com Conectores do Copilot
- Central de administração do Microsoft 365 > Copilot > Conectores: Local central para gerenciar todas as conexões de fontes de dados do Copilot.
- A configuração de conector personalizado requer um endpoint OAuth 2.0 válido e uma API publicamente acessível: Sem eles, o teste de conexão falhará.
- Certificação Graph Connector: Apenas conectores certificados aparecem na galeria de conectores do Copilot para uso em todo o locatário.
O Que São Conectores do Copilot e Por Que Você Precisa de uma Fonte de Dados Personalizada
Os conectores do Copilot são as pontes entre o Microsoft 365 Copilot e repositórios de dados externos. Quando você adiciona um conector, o Copilot pode indexar o conteúdo dessa fonte e usá-lo para gerar respostas contextuais e fundamentadas. Sem um conector, o Copilot acessa apenas dados já presentes no Microsoft 365, como SharePoint, OneDrive e Exchange. Uma fonte de dados personalizada é necessária quando suas informações de negócios residem em um sistema de terceiros, como um CRM, um banco de dados personalizado ou um servidor de arquivos legado. O conector busca esses dados, transforma-os em um índice pesquisável e os disponibiliza por meio do Microsoft Graph.
O processo envolve dois componentes principais: o conector em si, registrado na Central de administração do Microsoft 365, e a API externa com a qual o conector se comunica. Você deve ter privilégios administrativos no Microsoft 365 e acesso de gravação ao sistema externo. O conector pode ser um Graph Connector pré-criado do ecossistema de parceiros da Microsoft ou um conector personalizado que você cria usando a API Graph Connector. Este artigo aborda o caminho do conector personalizado, pois os conectores pré-criados não exigem configuração manual além da instalação.
Pré-requisitos para Adicionar um Conector Personalizado
Antes de começar, confirme se os seguintes requisitos foram atendidos:
- Você tem uma função de administrador global do Microsoft 365 ou administrador de pesquisa atribuída.
- A fonte de dados externa expõe uma API RESTful com autenticação OAuth 2.0.
- A API retorna dados no formato JSON que podem ser mapeados para o esquema do Microsoft Graph.
- Seu locatário do Microsoft 365 está licenciado para o Copilot for Microsoft 365.
- Você tem a URL do endpoint da API, ID do cliente, segredo do cliente e escopos prontos.
Passos para Adicionar uma Fonte de Dados Personalizada Usando a Central de Administração do Microsoft 365
Siga estas etapas para registrar e configurar um conector personalizado. Todo o processo leva cerca de 15 minutos se você tiver os detalhes da API preparados.
- Entre na Central de administração do Microsoft 365
Abra um navegador e vá parahttps://admin.microsoft.com. Faça login com uma conta que tenha a função de Administrador Global ou Administrador de Pesquisa. - Navegue até a página de conectores do Copilot
No painel de navegação esquerdo, selecione Copilot e depois Conectores. Esta página lista todos os conectores existentes e a opção de adicionar um novo. - Clique em Adicionar um conector
Na página Conectores, clique no botão Adicionar um conector. Um painel lateral é aberto com duas guias: Galeria e Personalizado. - Selecione a guia Personalizado
Clique na guia Personalizado. Aqui você pode fazer upload de um arquivo de definição do conector ou inserir os detalhes manualmente. Para uma fonte de dados personalizada, escolha Criar um novo conector personalizado. - Insira o nome e a descrição do conector
Digite um nome amigável como Dados CRM Salesforce e uma breve descrição. Esse nome aparece na interface do Copilot quando os usuários referenciam a fonte de dados. - Configure o método de autenticação
Selecione OAuth 2.0 no menu suspenso Tipo de autenticação. Cole os seguintes valores da sua API externa:
– URL de autorização
– URL do token
– ID do cliente
– Segredo do cliente
– Escopos (lista separada por espaços) - Defina o esquema de dados
Clique em Adicionar esquema. Você deve mapear os campos da resposta da sua API para o esquema do conector do Microsoft Graph. No mínimo, forneça umtitle,urledescriptionpara cada item. Use o botão Testar conexão para verificar se o conector pode buscar um registro de exemplo. - Defina a agenda de atualização
Escolha com que frequência o Copilot deve reindexar os dados desta fonte. As opções são a cada 15 minutos, a cada hora, diariamente ou semanalmente. Para dados atualizados com frequência, selecione A cada 15 minutos. - Revise e finalize
Clique em Avançar para revisar suas configurações. Em seguida, clique em Criar. O conector aparece na lista com o status Provisionando. Após alguns minutos, o status muda para Ativo.
Problemas Comuns ao Adicionar um Conector Personalizado
O teste de conexão falha com erro 401 Não Autorizado
Esse erro significa que as credenciais OAuth 2.0 estão incorretas ou os escopos estão incompatíveis. Verifique novamente o ID do cliente, o segredo do cliente e os escopos. Certifique-se de que o endpoint do token retorna um token de acesso com permissão para ler a fonte de dados. Se sua API usar um escopo personalizado, verifique se ele está incluído no campo de escopos.
O conector mostra Provisionando mas nunca se torna Ativo
A causa mais comum é um tempo limite durante a indexação inicial. O conector tenta buscar o primeiro lote de dados da sua API. Se a API levar mais de 30 segundos para responder, o provisionamento falha. Reduza o tamanho da página na resposta da sua API ou aumente o tempo limite do servidor. Após corrigir, exclua o conector e crie-o novamente.
Os usuários não conseguem ver os dados personalizados nas respostas do Copilot
Após o conector estar ativo, pode levar até 24 horas para que os dados indexados apareçam nos resultados do Copilot. Além disso, verifique se o conector está habilitado para os grupos de usuários corretos. Vá para Copilot > Conectores, selecione seu conector e verifique a guia Permissões. Atribua o conector aos grupos de segurança que devem ter acesso.
Tipos de Conectores do Copilot: Pré-criado vs Personalizado
| Item | Graph Connector Pré-criado | Conector Personalizado |
|---|---|---|
| Esforço de configuração | Mínimo — instale da galeria com um clique | Requer configuração de API e mapeamento de esquema |
| Flexibilidade da fonte de dados | Limitada a aplicativos parceiros suportados, como ServiceNow ou Jira | Qualquer API RESTful que retorne JSON |
| Autenticação | Gerenciada pelo provedor do conector | Você configura OAuth 2.0 manualmente |
| Controle da agenda de atualização | Fixo pelo provedor | Você escolhe o intervalo |
| Certificação necessária | Já certificado pela Microsoft | Você deve passar pela certificação Graph Connector para uso em todo o locatário |
Depois de adicionar uma fonte de dados personalizada, teste-a fazendo uma pergunta ao Copilot que exija dados dessa fonte. Por exemplo, se você conectou um banco de dados de produtos, pergunte Qual é o inventário atual do SKU 12345? Se o Copilot retornar uma resposta relevante, o conector está funcionando. Caso contrário, verifique os logs do conector na Central de administração em Copilot > Conectores > Log de atividades. Use o log para identificar tentativas de busca falhas ou incompatibilidades de esquema.