Conectores do Copilot, SDK, gerenciamento de conexões, API e modelos

Os conectores do Microsoft 365 Copilot (anteriormente conectores do Microsoft Graph), contratos, API de gerenciamento de conexões e modelos do SDK são chamados durante o processo de criação de conexão de conector personalizado no Centro de administração do Microsoft 365.

APIs de gerenciamento de conexão

Método Parâmetros Tipo de retorno Descrição
ValidateAuthentication ValidateAuthenticationRequest ValidateAuthenticationResponse Valida as credenciais e o caminho da fonte de dados fornecidos pelo administrador na etapa de configurações de conexão.
ValidateCustomConfiguration ValidateCustomConfigurationRequest ValidateCustomConfigurationResponse Valida a configuração opcional fornecida pelo administrador na etapa de configuração de conexão. Se nenhuma configuração for necessária para o conector, essa API poderá retornar uma resposta de êxito.
GetDataSourceSchema GetDataSourceSchemaRequest GetDataSourceSchemaResponse Obtém o esquema da fonte de dados em um formato que pode ser compreendido pelo Microsoft Graph.

Modelos de API de gerenciamento de conexões

As seções a seguir descrevem os modelos de API de gerenciamento de conexões.

ValidateAuthenticationRequest

Solicite um modelo para validar a solicitação de autenticação para a fonte de dados.

Propriedade Tipo Descrição
authenticationData AuthenticationData Contém a URL de acesso à fonte de dados e as credenciais para acessá-la.

ValidateAuthenticationResponse

Modelo de resposta para validar a resposta de autenticação à fonte de dados.

Propriedade Tipo Descrição
status OperationStatus Mostra o status da operação e detalhes como mensagens de erro.
oAuth2ClientCredentialResponse OAuth2ClientCredentialResponse Informações de credencial a serem enviadas ao conector durante o rastreamento se o fluxo OAuth for usado (token de acesso, token de atualização e assim por diante, enviadas pelo servidor de autenticação).

ValidateCustomConfigurationRequest

Solicitar modelo para validar informações de solicitação de configuração personalizada.

Propriedade Tipo Descrição
customConfiguration CustomConfiguration Fornece dados de configuração para o conector.
authenticationData AuthenticationData Contém a URL de acesso à fonte de dados e as credenciais para acessá-la.

ValidateCustomConfigurationResponse

Solicite o modelo para validar as informações de resposta da configuração personalizada.

Propriedade Tipo Descrição
status OperationStatus Mostra o status da operação e detalhes como mensagens de erro.

GetDataSourceSchemaRequest

Solicite um modelo para obter a solicitação de esquema da fonte de dados.

Propriedade Tipo Descrição
customConfiguration CustomConfiguration Fornece dados de configuração para o conector.
authenticationData AuthenticationData Contém a URL de acesso à fonte de dados e as credenciais para acessá-la.

GetDataSourceSchemaResponse

Solicite um modelo para obter a resposta do esquema da fonte de dados.

Propriedade Tipo Descrição
status OperationStatus Mostra o status da operação e detalhes como mensagens de erro.
dataSourceSchema DataSourceSchema Mostra o esquema da fonte de dados.