Partager via


Question Answering Projects - Get Sources

Obtient toutes les sources d’un projet.

GET {Endpoint}/language/authoring/query-knowledgebases/projects/{projectName}/sources?api-version=2023-04-15-preview
GET {Endpoint}/language/authoring/query-knowledgebases/projects/{projectName}/sources?api-version=2023-04-15-preview&top={top}&skip={skip}&maxpagesize={maxpagesize}

Paramètres URI

Nom Dans Obligatoire Type Description
projectName
path True

string

Nom du projet à utiliser.

api-version
query True

string

Version de l’API cliente.

maxpagesize
query

integer

int32

Nombre maximal de ressources à inclure dans une seule réponse.

skip
query

integer

int32

Décalage dans la collection de la première ressource à retourner.

top
query

integer

int32

Nombre maximal de ressources à retourner à partir de la collection.

Réponses

Nom Type Description
200 OK

QnaSources

Toutes les sources d’un projet.

Other Status Codes

ErrorResponse

Réponse d’erreur.

Sécurité

AADToken

Il s’agit des flux Azure Active Directory OAuth2. Lorsqu’il est associé à 'accès en fonction du rôle Azure contrôle, il peut être utilisé pour contrôler l’accès aux API REST Azure Maps. Les contrôles d’accès en fonction du rôle Azure sont utilisés pour désigner l’accès à un ou plusieurs comptes de ressources Azure Maps ou sous-ressources. Tout utilisateur, groupe ou principal de service peut avoir accès via un rôle intégré ou un rôle personnalisé composé d’une ou plusieurs autorisations pour les API REST Azure Maps.

Pour implémenter des scénarios, nous vous recommandons d’afficher concepts d’authentification. En résumé, cette définition de sécurité fournit une solution pour la modélisation des applications via des objets capables de contrôler l’accès sur des API et des étendues spécifiques.

Notes

  • Cette définition de sécurité nécessite l’utilisation de l’en-tête x-ms-client-id pour indiquer la ressource Azure Maps à laquelle l’application demande l’accès. Cela peut être acquis à partir de l’API de gestion Maps.

La Authorization URL est spécifique à l’instance de cloud public Azure. Les clouds souverains ont des URL d’autorisation uniques et des configurations Azure Active Directory. * Le contrôle d’accès en fonction du rôle Azure est configuré à partir de l'plan de gestion Azure via le portail Azure, PowerShell, l’interface CLI, les SDK Azure ou les API REST. * L’utilisation du kit de développement logiciel (SDK) web Azure Maps permet la configuration basée sur la configuration d’une application pour plusieurs cas d’usage.

  • Actuellement, Azure Active Directory v1.0 ou v2.0 prend en charge les comptes professionnels, scolaires et invités, mais ne prend pas en charge les comptes personnels.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
https://cognitiveservices.azure.com/.default https://cognitiveservices.azure.com/.default

Ocp-Apim-Subscription-Key

Clé d’abonnement pour une ressource de service de langage.

Type: apiKey
Dans: header

Exemples

Successful query

Exemple de requête

GET {Endpoint}/language/authoring/query-knowledgebases/projects/proj1/sources?api-version=2023-04-15-preview

Exemple de réponse

{
  "value": [
    {
      "displayName": "source1",
      "sourceUri": "https://docs.microsoft.com/en-us/azure/cognitive-services/qnamaker/overview/overview",
      "sourceKind": "url",
      "lastUpdatedDateTime": "2021-05-01T15:13:22Z",
      "source": "https://docs.microsoft.com/en-us/azure/cognitive-services/qnamaker/overview/overview"
    },
    {
      "displayName": "source2",
      "sourceUri": "https://download.microsoft.com/download/2/9/B/29B20383-302C-4517-A006-B0186F04BE28/surface-pro-4-user-guide-EN.pdf",
      "sourceKind": "file",
      "contentStructureKind": "unstructured",
      "lastUpdatedDateTime": "2021-05-01T15:13:22Z",
      "source": "surface-guide.pdf"
    }
  ]
}

Définitions

Nom Description
Error

Objet d’erreur.

ErrorCode

Code d’erreur lisible par l’homme.

ErrorResponse

Réponse d’erreur.

InnerErrorCode

Code d’erreur lisible par l’homme.

InnerErrorModel

Objet contenant des informations plus spécifiques sur l’erreur. Conformément aux instructions de l’API Microsoft One - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

QnaSourceRecord

Enregistrement source personnalisé avec date et heure de la dernière mise à jour.

QnaSources

Toutes les sources QnA pour le projet.

sourceContentStructureKind

Type de structure de contenu pour les sources.

sourceKind

Types sources pris en charge.

Error

Objet d’erreur.

Nom Type Description
code

ErrorCode

Un ensemble de codes d’erreur définis par le serveur.

details

Error[]

Tableau de détails sur des erreurs spécifiques qui ont conduit à cette erreur signalée.

innererror

InnerErrorModel

Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.

message

string

Représentation lisible par l’homme de l’erreur.

target

string

Cible de l’erreur.

ErrorCode

Code d’erreur lisible par l’homme.

Nom Type Description
AzureCognitiveSearchIndexLimitReached

string

AzureCognitiveSearchIndexNotFound

string

AzureCognitiveSearchNotFound

string

AzureCognitiveSearchThrottling

string

Conflict

string

Forbidden

string

InternalServerError

string

InvalidArgument

string

InvalidRequest

string

NotFound

string

OperationNotFound

string

ProjectNotFound

string

QuotaExceeded

string

ServiceUnavailable

string

Timeout

string

TooManyRequests

string

Unauthorized

string

Warning

string

ErrorResponse

Réponse d’erreur.

Nom Type Description
error

Error

Objet d’erreur.

InnerErrorCode

Code d’erreur lisible par l’homme.

Nom Type Description
AzureCognitiveSearchNotFound

string

AzureCognitiveSearchThrottling

string

EmptyRequest

string

ExtractionFailure

string

InvalidCountryHint

string

InvalidDocument

string

InvalidDocumentBatch

string

InvalidParameterValue

string

InvalidRequest

string

InvalidRequestBodyFormat

string

KnowledgeBaseNotFound

string

MissingInputDocuments

string

ModelVersionIncorrect

string

UnsupportedLanguageCode

string

InnerErrorModel

Objet contenant des informations plus spécifiques sur l’erreur. Conformément aux instructions de l’API Microsoft One - https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses.

Nom Type Description
code

InnerErrorCode

Un ensemble de codes d’erreur définis par le serveur.

details

object

Détails de l’erreur.

innererror

InnerErrorModel

Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur.

message

string

Message d'erreur.

target

string

Cible d’erreur.

QnaSourceRecord

Enregistrement source personnalisé avec date et heure de la dernière mise à jour.

Nom Type Valeur par défaut Description
contentStructureKind

sourceContentStructureKind

Unstructured

Type de structure de contenu pour les sources.

displayName

string

Nom convivial de la source.

lastUpdatedDateTime

string

Date et heure de la dernière mise à jour du QnA.

source

string

Identificateur source unique. Nom du fichier s’il s’agit d’une source « fichier » ; sinon, l’URL complète s’il s’agit d’une source « URL ».

sourceKind

sourceKind

url

Types sources pris en charge.

sourceUri

string

Emplacement de l’URI pour le fichier ou l’URL.

QnaSources

Toutes les sources QnA pour le projet.

Nom Type Description
nextLink

string

value

QnaSourceRecord[]

Sources personnalisées à partir desquelles des QnA ont été extraites ou explicitement ajoutées au projet.

sourceContentStructureKind

Type de structure de contenu pour les sources.

Nom Type Description
unstructured

string

sourceKind

Types sources pris en charge.

Nom Type Description
file

string

url

string