Question Answering Projects - Create Project
Créer ou mettre à jour un projet.
PATCH {Endpoint}/language/authoring/query-knowledgebases/projects/{projectName}?api-version=2023-04-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
Endpoint
|
path | True |
string |
Point de terminaison Cognitive Services pris en charge (par exemple, https://.api.cognitiveservices.azure.com). |
project
|
path | True |
string |
Nom du projet à utiliser. |
api-version
|
query | True |
string |
Version d’API client. |
Corps de la demande
Nom | Obligatoire | Type | Description |
---|---|---|---|
language | True |
string |
Langue des enregistrements de texte. Il s’agit de la représentation BCP-47 d’une langue. Par exemple, utilisez « en » pour l’anglais ; « es » pour l’espagnol, etc. S’il n’est pas défini, utilisez « en » pour l’anglais comme valeur par défaut. |
description |
string |
Description du projet. |
|
multilingualResource |
boolean |
Définissez sur true pour permettre la création de bases de connaissances dans différentes langues pour la même ressource. |
|
settings |
Paramètres configurables du projet. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
Métadonnées du projet mis à jour, s’il existe déjà. |
|
201 Created |
Métadonnées du projet créé, s’il n’existe pas. |
|
Other Status Codes |
Réponse d’erreur. |
Sécurité
AADToken
Il s’agit des flux OAuth2 Azure Active Directory . Lorsqu’il est associé au contrôle d’accès en fonction du rôle Azure, il peut être utilisé pour contrôler l’accès à Azure Maps API REST. Les contrôles d’accès en fonction du rôle Azure sont utilisés pour désigner l’accès à un ou plusieurs Azure Maps compte de ressource ou sous-ressources. Tout utilisateur, groupe ou principal de service peut se voir accorder l’accès via un rôle intégré ou un rôle personnalisé composé d’une ou plusieurs autorisations pour Azure Maps API REST.
Pour implémenter des scénarios, nous vous recommandons d’afficher les concepts d’authentification. En résumé, cette définition de sécurité fournit une solution pour modéliser 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 à quelle ressource Azure Maps l’application demande l’accès. Vous pouvez l’acquérir à partir de l’API de gestion maps.
est Authorization URL
spécifique au cloud public Azure instance. 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 du plan de gestion Azure via Portail Azure, PowerShell, CLI, kits SDK Azure ou API REST.
* L’utilisation du Kit de développement logiciel (SDK) web Azure Maps permet une 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 language.
Type:
apiKey
Dans:
header
Exemples
Successful query
Exemple de requête
PATCH {Endpoint}/language/authoring/query-knowledgebases/projects/proj1?api-version=2023-04-01
{
"description": "proj1 is a test project.",
"language": "en",
"settings": {
"defaultAnswer": "No good match found for your question in the Knowledgebase."
},
"multilingualResource": true
}
Exemple de réponse
{
"projectName": "proj1",
"description": "proj1 is a test project.",
"language": "en",
"settings": {
"defaultAnswer": "No good match found for your question in the Knowledgebase."
},
"multilingualResource": true,
"createdDateTime": "2021-05-01T15:13:22Z",
"lastModifiedDateTime": "2021-05-01T15:13:22Z",
"lastDeployedDateTime": "2021-05-01T15:13:22Z"
}
{
"projectName": "proj1",
"description": "proj1 is a test project.",
"language": "en",
"settings": {
"defaultAnswer": "No good match found for your question in the Knowledgebase."
},
"multilingualResource": true,
"createdDateTime": "2021-05-01T15:13:22Z",
"lastModifiedDateTime": "2021-05-01T15:13:22Z",
"lastDeployedDateTime": "2021-05-01T15:13:22Z"
}
Définitions
Nom | Description |
---|---|
Create |
Paramètres nécessaires pour créer le projet. |
Error |
Objet error. |
Error |
Code d’erreur lisible par l’utilisateur. |
Error |
Réponse d’erreur. |
Inner |
Code d’erreur lisible par l’utilisateur. |
Inner |
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. |
Project |
Représente le projet. |
Project |
Paramètres configurables du projet. |
CreateProjectOptions
Paramètres nécessaires pour créer le projet.
Nom | Type | Description |
---|---|---|
description |
string |
Description du projet. |
language |
string |
Langue des enregistrements de texte. Il s’agit de la représentation BCP-47 d’une langue. Par exemple, utilisez « en » pour l’anglais ; « es » pour l’espagnol, etc. S’il n’est pas défini, utilisez « en » pour l’anglais comme valeur par défaut. |
multilingualResource |
boolean |
Définissez sur true pour permettre la création de bases de connaissances dans différentes langues pour la même ressource. |
settings |
Paramètres configurables du projet. |
Error
Objet error.
Nom | Type | Description |
---|---|---|
code |
Un des ensembles de codes d’erreur définis par le serveur. |
|
details |
Error[] |
Tableau de détails sur les erreurs spécifiques qui ont conduit à cette erreur signalée. |
innererror |
Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur. |
|
message |
string |
Représentation lisible de l’erreur. |
target |
string |
Cible de l’erreur. |
ErrorCode
Code d’erreur lisible par l’utilisateur.
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 |
Objet error. |
InnerErrorCode
Code d’erreur lisible par l’utilisateur.
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 |
Un des ensembles de codes d’erreur définis par le serveur. |
|
details |
object |
Détails de l’erreur. |
innererror |
Objet contenant des informations plus spécifiques que l’objet actuel sur l’erreur. |
|
message |
string |
Message d’erreur. |
target |
string |
Cible d’erreur. |
ProjectMetadata
Représente le projet.
Nom | Type | Description |
---|---|---|
createdDateTime |
string |
Date et heure de création du projet. |
description |
string |
Description du projet. |
language |
string |
Langue des enregistrements de texte. Il s’agit de la représentation BCP-47 d’une langue. Par exemple, utilisez « en » pour l’anglais ; « es » pour l’espagnol, etc. S’il n’est pas défini, utilisez « en » pour l’anglais comme valeur par défaut. |
lastDeployedDateTime |
string |
Représente la date et l’heure du dernier déploiement du projet. |
lastModifiedDateTime |
string |
Représente la date et l’heure de la dernière modification du projet. |
multilingualResource |
boolean |
Ressource activée pour plusieurs langues dans les projets ou non. |
projectName |
string |
Nom du projet. |
settings |
Paramètres configurables du projet. |
ProjectSettings
Paramètres configurables du projet.
Nom | Type | Description |
---|---|---|
defaultAnswer |
string |
Réponse par défaut quand aucune bonne correspondance n’est trouvée dans le base de connaissances. |