Yazma API’si
Yazma API'sini yanıtlayan özel soru, yeni soru yanıt çiftleri eklemenin yanı sıra proje oluşturma, yayımlama ve sürdürme gibi yaygın görevleri otomatikleştirmek için kullanılır.
Not
Yazma işlevi REST API ve Yazma SDK'sı (önizleme) aracılığıyla kullanılabilir. Bu makalede, rest API'yi cURL ile kullanma örnekleri sağlanır. Tüm parametrelerin ve işlevlerin tam belgeleri için REST API başvuru içeriğine başvurun.
Önkoşullar
- cURL'nin geçerli sürümü. Bu makalede, cURL belgelerinde belirtilen çeşitli komut satırı anahtarları kullanılır.
- Bu makaledeki komutlar Bash kabuğunda yürütülecek şekilde tasarlanmıştır. Bu komutlar her zaman bir Windows komut isteminde veya PowerShell'de değişiklik yapılmadan çalışmaz. Yerel olarak yüklenmiş bir Bash kabuğunuz yoksa Azure Cloud Shell'in bash ortamını kullanabilirsiniz.
Bir proje oluştur
Program aracılığıyla proje oluşturmak için:
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusunu yanıtlayan>değeri bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Önceki örnek aşağıdaki kod örneğindeki uç noktanızsa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusunu yanıtlayan>değeri bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
NEW-PROJECT-NAME |
Projenizi yanıtlayan yeni özel sorunuz için ad. |
Proje dili, güvenilirlik eşiğini karşılayan veya aşan yanıt bulunamazsa verilen varsayılan yanıt ve bu dil kaynağının birden çok dili destekleyip desteklemeyeceği gibi ek değerleri de ayarlayabilirsiniz.
Örnek sorgu
curl -X PATCH -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '{
"description": "proj1 is a test project.",
"language": "en",
"settings": {
"defaultAnswer": "No good match found for your question in the project."
},
"multilingualResource": true
}
}' 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{NEW-PROJECT-NAME}?api-version=2021-10-01'
Örnek yanıt
{
"200": {
"headers": {},
"body": {
"projectName": "proj1",
"description": "proj1 is a test project.",
"language": "en",
"settings": {
"defaultAnswer": "No good match found for your question in the project."
},
"multilingualResource": true,
"createdDateTime": "2021-05-01T15:13:22Z",
"lastModifiedDateTime": "2021-05-01T15:13:22Z",
"lastDeployedDateTime": "2021-05-01T15:13:22Z"
}
}
}
Projeyi Sil
Bir projeyi program aracılığıyla silmek için:
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Önceki örnek aşağıdaki kod örneğindeki uç noktanızsa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
PROJECT-NAME |
Silmek istediğiniz projenin adı. |
Örnek sorgu
curl -X DELETE -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -i 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}?api-version=2021-10-01'
Projeyi silmek için yapılan başarılı bir çağrı, proje silme işinin durumunu denetlemek için kullanılabilen bir Operation-Location
üst bilgi döndürülür. Çoğu örnekte yanıt üst bilgilerine bakmamız gerekmiyor ve bu nedenle bunları görüntülemiyoruz. Curl komutumuz yanıt üst bilgilerini almak için kullanır -i
. Uç nokta adresinden önceki bu parametre olmadan, bu komuta verilen yanıt hiçbir yanıt oluşmadı gibi boş görünür.
Örnek yanıt
HTTP/2 202
content-length: 0
operation-location: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/sample-proj1/deletion-jobs/{JOB-ID-GUID}
x-envoy-upstream-service-time: 324
apim-request-id:
strict-transport-security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
date: Tue, 23 Nov 2021 20:56:18 GMT
Proje zaten silinmişse veya bulunamazsa aşağıdaki gibi bir ileti alırsınız:
{
"error": {
"code": "ProjectNotFound",
"message": "The specified project was not found.",
"details": [
{
"code": "ProjectNotFound",
"message": "{GUID}"
}
]
}
}
Proje silme durumunu alma
Proje silme isteğinizin durumunu denetlemek için:
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusunu yanıtlayan>değeri bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Aşağıdaki kod örneğindeki uç noktanız buysa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
PROJECT-NAME |
Dağıtım durumunu denetlemek istediğiniz projenin adı. |
JOB-ID |
Bir projeyi program aracılığıyla sildiğinizde, silme isteğinin yanıt üst bilgisinin operation-location bir parçası olarak bir JOB-ID oluşturulur. JOB-ID , öğesinin sonundaki guid değeridiroperation-location . Örneğin: operation-location: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/sample-proj1/deletion-jobs/{THIS GUID IS YOUR JOB ID} |
Örnek sorgu
curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/deletion-jobs/{JOB-ID}?api-version=2021-10-01'
Örnek yanıt
{
"createdDateTime": "2021-11-23T20:56:18+00:00",
"expirationDateTime": "2021-11-24T02:56:18+00:00",
"jobId": "GUID",
"lastUpdatedDateTime": "2021-11-23T20:56:18+00:00",
"status": "succeeded"
}
Proje ayarlarını alma
Belirli bir proje hakkında bilgi almak için aşağıdaki sorguda aşağıdaki değerleri güncelleştirin:
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Aşağıdaki kod örneğindeki uç noktanız buysa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
PROJECT-NAME |
Hakkında bilgi almak istediğiniz projenin adı. |
Örnek sorgu
curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}?api-version=2021-10-01'
Örnek yanıt
{
"200": {
"headers": {},
"body": {
"projectName": "proj1",
"description": "proj1 is a test project.",
"language": "en",
"settings": {
"defaultAnswer": "No good match found for your question in the project."
},
"createdDateTime": "2021-05-01T15:13:22Z",
"lastModifiedDateTime": "2021-05-01T15:13:22Z",
"lastDeployedDateTime": "2021-05-01T15:13:22Z"
}
}
}
Soru yanıt çiftlerini alma
Belirli bir projenin soru yanıt çiftlerini ve ilgili bilgilerini almak için aşağıdaki sorguda aşağıdaki değerleri güncelleştirin:
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Aşağıdaki kod örneğindeki uç noktanız buysa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
PROJECT-NAME |
Tüm soru yanıt çiftlerini almak istediğiniz projenin adı. |
Örnek sorgu
curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/qnas?api-version=2021-10-01'
Örnek yanıt
{
"200": {
"headers": {},
"body": {
"value": [
{
"id": 1,
"answer": "ans1",
"source": "source1",
"questions": [
"question 1.1",
"question 1.2"
],
"metadata": {
"k1": "v1",
"k2": "v2"
},
"dialog": {
"isContextOnly": false,
"prompts": [
{
"displayOrder": 1,
"qnaId": 11,
"displayText": "prompt 1.1"
},
{
"displayOrder": 2,
"qnaId": 21,
"displayText": "prompt 1.2"
}
]
},
"lastUpdatedDateTime": "2021-05-01T17:21:14Z"
},
{
"id": 2,
"answer": "ans2",
"source": "source2",
"questions": [
"question 2.1",
"question 2.2"
],
"lastUpdatedDateTime": "2021-05-01T17:21:14Z"
}
]
}
}
}
Kaynakları alma
Belirli bir projenin kaynaklarını ve ilgili bilgilerini almak için aşağıdaki sorguda aşağıdaki değerleri güncelleştirin:
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Aşağıdaki kod örneğindeki uç noktanız buysa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
PROJECT-NAME |
Tüm kaynak bilgilerini almak istediğiniz projenin adı. |
Örnek sorgu
curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT_NAME}/sources?api-version=2021-10-01'
Örnek yanıt
{
"200": {
"headers": {},
"body": {
"value": [
{
"displayName": "source1",
"sourceUri": "https://learn.microsoft.com/azure/ai-services/qnamaker/overview/overview",
"sourceKind": "url",
"lastUpdatedDateTime": "2021-05-01T15:13:22Z"
},
{
"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"
}
]
}
}
}
Eş anlamlıları alma
Belirli bir projenin eş anlamlılarını ve ilgili bilgilerini almak için aşağıdaki sorguda aşağıdaki değerleri güncelleştirin:
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Aşağıdaki kod örneğindeki uç noktanız buysa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
PROJECT-NAME |
Eş anlamlı bilgilerini almak istediğiniz projenin adı. |
Örnek sorgu
curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/synonyms?api-version=2021-10-01'
Örnek yanıt
{
"200": {
"headers": {},
"body": {
"value": [
{
"alterations": [
"qnamaker",
"qna maker"
]
},
{
"alterations": [
"botframework",
"bot framework"
]
}
]
}
}
}
Projeyi dağıtma
Bir projeyi üretime dağıtmak için aşağıdaki sorguda aşağıdaki değerleri güncelleştirin:
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Aşağıdaki kod örneğindeki uç noktanız buysa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
PROJECT-NAME |
Üretime dağıtmak istediğiniz projenin adı. |
Örnek sorgu
curl -X PUT -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '' -i 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/deployments/production?api-version=2021-10-01'
Projeyi dağıtmak için yapılan başarılı bir çağrı, dağıtım işinin durumunu denetlemek için kullanılabilecek bir Operation-Location
üst bilginin döndürülmesini sağlar. Çoğu örnekte yanıt üst bilgilerine bakmamız gerekmiyor ve bu nedenle bunları görüntülemiyoruz. Curl komutumuz yanıt üst bilgilerini almak için kullanır -i
. Uç nokta adresinden önceki bu parametre olmadan, bu komuta verilen yanıt hiçbir yanıt oluşmadı gibi boş görünür.
Örnek yanıt
0HTTP/2 202
content-length: 0
operation-location: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/sample-proj1/deployments/production/jobs/{JOB-ID-GUID}
x-envoy-upstream-service-time: 31
apim-request-id:
strict-transport-security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
date: Tue, 23 Nov 2021 20:35:00 GMT
Proje dağıtım durumunu alma
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Aşağıdaki kod örneğindeki uç noktanız buysa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
PROJECT-NAME |
Dağıtım durumunu denetlemek istediğiniz projenin adı. |
JOB-ID |
Bir projeyi program aracılığıyla dağıttığınızda, dağıtım isteğine yanıt üst bilgisinin operation-location bir parçası olarak bir JOB-ID oluşturulur. JOB-ID , öğesinin sonundaki guid değeridiroperation-location . Örneğin: operation-location: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/sample-proj1/deployments/production/jobs/{THIS GUID IS YOUR JOB ID} |
Örnek sorgu
curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '' 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/deployments/production/jobs/{JOB-ID}?api-version=2021-10-01'
Örnek yanıt
{
"200": {
"headers": {},
"body": {
"errors": [],
"createdDateTime": "2021-05-01T17:21:14Z",
"expirationDateTime": "2021-05-01T17:21:14Z",
"jobId": "{JOB-ID-GUID}",
"lastUpdatedDateTime": "2021-05-01T17:21:14Z",
"status": "succeeded"
}
}
}
Proje meta verilerini ve varlıklarını dışarı aktarma
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Aşağıdaki kod örneğindeki uç noktanız buysa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
PROJECT-NAME |
Dışarı aktarmak istediğiniz projenin adı. |
Örnek sorgu
curl -X POST -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '{exportAssetTypes": ["qnas","synonyms"]}' -i 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/:export?api-version=2021-10-01&format=tsv'
Örnek yanıt
HTTP/2 202
content-length: 0
operation-location: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/Sample-project/export/jobs/{JOB-ID_GUID}
x-envoy-upstream-service-time: 214
apim-request-id:
strict-transport-security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
date: Tue, 23 Nov 2021 21:24:03 GMT
Dışarı aktarma durumunu denetleme
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Aşağıdaki kod örneğindeki uç noktanız buysa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
PROJECT-NAME |
Dışarı aktarma durumunu denetlemek istediğiniz projenin adı. |
JOB-ID |
Bir projeyi program aracılığıyla dışarı aktardığınızda, dışarı aktarma isteğine yanıt üst bilgisinin operation-location bir parçası olarak bir JOB-ID oluşturulur. JOB-ID , öğesinin sonundaki guid değeridiroperation-location . Örneğin: operation-location: https://southcentralus.api.cognitive.microsoft.com/language/query-knowledgebases/projects/sample-proj1/export/jobs/{THIS GUID IS YOUR JOB ID} |
Örnek sorgu
curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '' 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/sample-proj1/export/jobs/{JOB-ID}?api-version=2021-10-01'
Örnek yanıt
{
"createdDateTime": "2021-11-23T21:24:03+00:00",
"expirationDateTime": "2021-11-24T03:24:03+00:00",
"jobId": "JOB-ID-GUID",
"lastUpdatedDateTime": "2021-11-23T21:24:08+00:00",
"status": "succeeded",
"resultUrl": "https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/sample-proj1/export/jobs/{JOB-ID_GUID}/result"
}
resultUrl öğesine doğrudan erişmeye çalışırsanız 404 hatası alırsınız. Kimliği doğrulanmış bir istekle erişilebilir hale getirmek için yola eklemeniz ?api-version=2021-10-01
gerekir: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/sample-proj1/export/jobs/{JOB-ID_GUID}/result?api-version=2021-10-01
Projeyi içeri aktarma
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Aşağıdaki kod örneğindeki uç noktanız buysa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
PROJECT-NAME |
İçeri aktarma için hedef olmasını istediğiniz projenin adı. |
FILE-URI-PATH |
Bir projeyi program aracılığıyla dışarı aktardığınızda ve ardından yanıtın bir parçası olarak dışarı resultUrl aktarmanın oluşturulduğu durumu denetlediğinizde. Örneğin: "resultUrl": "https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/sample-proj1/export/jobs/{JOB-ID_GUID}/result" kaynağından bir projeyi içeri aktarmak için resultUrl'yi API sürümü eklenmiş olarak kullanabilirsiniz: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/sample-proj1/export/jobs/{JOB-ID_GUID}/result?api-version=2021-10-01 . |
Örnek sorgu
curl -X POST -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '{
"fileUri": "FILE-URI-PATH"
}' -i 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/:import?api-version=2021-10-01&format=tsv'
Projeyi içeri aktarmak için yapılan başarılı bir çağrı, içeri aktarma işinin durumunu denetlemek için kullanılabilen bir Operation-Location
üst bilgi döndürülür. Çoğu örneğimizde yanıt üst bilgilerine bakmamıza gerek yoktu ve bu nedenle bunları görüntülemedik. Curl komutumuz yanıt üst bilgilerini almak için kullanır -i
. Uç nokta adresinden önceki bu ek parametre olmadan, bu komuta verilen yanıt hiçbir yanıt oluşmadı gibi boş görünür.
Örnek yanıt
HTTP/2 202
content-length: 0
operation-location: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/sample-proj1/import/jobs/{JOB-ID-GUID}
x-envoy-upstream-service-time: 417
apim-request-id:
strict-transport-security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
date: Wed, 24 Nov 2021 00:35:11 GMT
İçeri aktarma durumunu denetleme
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Aşağıdaki kod örneğindeki uç noktanız buysa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
PROJECT-NAME |
İçeri aktarma için hedef olmasını istediğiniz projenin adı. |
JOB-ID |
Bir projeyi program aracılığıyla içeri aktardığınızda, dışarı aktarma isteğine yanıt üst bilgisinin operation-location bir parçası olarak bir JOB-ID oluşturulur. JOB-ID , sonundaki GUID'diroperation-location . Örneğin: operation-location: https://southcentralus.api.cognitive.microsoft.com/language/query-knowledgebases/projects/sample-proj1/import/jobs/{THIS GUID IS YOUR JOB ID} |
Örnek sorgu
curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '' 'https://southcentralus.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME/import/jobs/{JOB-ID-GUID}?api-version=2021-10-01'
Örnek sorgu yanıtı
{
"errors": [],
"createdDateTime": "2021-05-01T17:21:14Z",
"expirationDateTime": "2021-05-01T17:21:14Z",
"jobId": "JOB-ID-GUID",
"lastUpdatedDateTime": "2021-05-01T17:21:14Z",
"status": "succeeded"
}
Dağıtımları listeleme
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Aşağıdaki kod örneğindeki uç noktanız buysa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
PROJECT-NAME |
Dağıtım listesi oluşturmak istediğiniz projenin adı. |
Örnek sorgu
curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '' 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/deployments?api-version=2021-10-01'
Örnek yanıt
[
{
"deploymentName": "production",
"lastDeployedDateTime": "2021-10-26T15:12:02Z"
}
]
Projeleri Listele
Hesabınızın erişimi olan tüm soruları yanıtlayan projelerin listesini alın.
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Aşağıdaki kod örneğindeki uç noktanız buysa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
Örnek sorgu
curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '' 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects?api-version=2021-10-01'
Örnek yanıt
{
"value": [
{
"projectName": "Sample-project",
"description": "My first question answering project",
"language": "en",
"multilingualResource": false,
"createdDateTime": "2021-10-07T04:51:15Z",
"lastModifiedDateTime": "2021-10-27T00:42:01Z",
"lastDeployedDateTime": "2021-11-24T01:34:18Z",
"settings": {
"defaultAnswer": "No good match found in KB"
}
}
]
}
Kaynakları güncelleştirme
Bu örnekte mevcut projeye yeni bir kaynak ekleyeceğiz. Ayrıca, sorgu gövdesinin bir parçası olarak ne tür işlemler geçirdiğinize bağlı olarak mevcut kaynakları bu komutla değiştirebilir ve silebilirsiniz.
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Aşağıdaki kod örneğindeki uç noktanız buysa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
PROJECT-NAME |
Kaynakları güncelleştirmek istediğiniz projenin adı. |
METHOD |
PATCH |
Örnek sorgu
curl -X PATCH -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '[
{
"op": "add",
"value": {
"displayName": "source5",
"sourceKind": "url",
"sourceUri": "https://download.microsoft.com/download/7/B/1/7B10C82E-F520-4080-8516-5CF0D803EEE0/surface-book-user-guide-EN.pdf",
"sourceContentStructureKind": "semistructured"
}
}
]' -i '{LanguageServiceName}.cognitiveservices.azure.com//language/query-knowledgebases/projects/{projectName}/sources?api-version=2021-10-01'
Kaynağı güncelleştirmeye yönelik başarılı bir çağrı, içeri aktarma işinin durumunu denetlemek için kullanılabilecek bir Operation-Location
üst bilgi döndürülür. Çoğu örneğimizde yanıt üst bilgilerine bakmamıza gerek yoktu ve bu nedenle bunları her zaman görüntülemedik. Curl komutumuz yanıt üst bilgilerini almak için kullanır -i
. Uç nokta adresinden önceki bu parametre olmadan, bu komuta verilen yanıt hiçbir yanıt oluşmadı gibi boş görünür.
Örnek yanıt
HTTP/2 202
content-length: 0
operation-location: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/Sample-project/sources/jobs/{JOB_ID_GUID}
x-envoy-upstream-service-time: 412
apim-request-id: dda23d2b-f110-4645-8bce-1a6f8d504b33
strict-transport-security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
date: Wed, 24 Nov 2021 02:47:53 GMT
Güncelleştirme kaynağı durumunu alma
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusunu yanıtlayan>değeri bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Aşağıdaki kod örneğindeki uç noktanız buysa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
PROJECT-NAME |
İçeri aktarma için hedef olmasını istediğiniz projenin adı. |
JOB-ID |
Bir kaynağı program aracılığıyla güncelleştirdiğinizde, güncelleştirme kaynağı isteğinin yanıt üst bilgisinin operation-location bir parçası olarak bir JOB-ID oluşturulur. JOB-ID , sonundaki GUID'diroperation-location . Örneğin: operation-location: https://southcentralus.api.cognitive.microsoft.com/language/query-knowledgebases/projects/sample-proj1/sources/jobs/{THIS GUID IS YOUR JOB ID} |
Örnek sorgu
curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '' 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/sources/jobs/{JOB-ID}?api-version=2021-10-01'
Örnek yanıt
{
"createdDateTime": "2021-11-24T02:47:53+00:00",
"expirationDateTime": "2021-11-24T08:47:53+00:00",
"jobId": "{JOB-ID-GUID}",
"lastUpdatedDateTime": "2021-11-24T02:47:56+00:00",
"status": "succeeded",
"resultUrl": "/knowledgebases/Sample-project"
}
Soru ve yanıt çiftlerini güncelleştirme
Bu örnekte, mevcut kaynağa bir soru yanıt çifti ekleyeceğiz. Ayrıca, sorgu gövdesinde geçirdiğiniz işleme bağlı olarak bu sorguyla mevcut soru yanıt çiftlerini değiştirebilir veya silebilirsiniz. adlı source5
bir kaynağınız yoksa bu örnek sorgu başarısız olur. Sorgunun gövdesindeki kaynak değerini hedef projeniz için var olan bir kaynağa ayarlayabilirsiniz.
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Aşağıdaki kod örneğindeki uç noktanız buysa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
PROJECT-NAME |
İçeri aktarma için hedef olmasını istediğiniz projenin adı. |
curl -X PATCH -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '[
{
"op": "add",
"value":{
"id": 1,
"answer": "The latest question answering docs are on https://learn.microsoft.com",
"source": "source5",
"questions": [
"Where do I find docs for question answering?"
],
"metadata": {},
"dialog": {
"isContextOnly": false,
"prompts": []
}
}
}
]' -i 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/qnas?api-version=2021-10-01'
Bir soru yanıt çiftini güncelleştirmeye yönelik başarılı bir çağrı, güncelleştirme işinin durumunu denetlemek için kullanılabilecek bir Operation-Location
üst bilgi döndürülür. Çoğu örneğimizde yanıt üst bilgilerine bakmamıza gerek yoktu ve bu nedenle bunları her zaman görüntülemedik. Curl komutumuz yanıt üst bilgilerini almak için kullanır -i
. Uç nokta adresinden önceki bu parametre olmadan, bu komuta verilen yanıt hiçbir yanıt oluşmadı gibi boş görünür.
Örnek yanıt
HTTP/2 202
content-length: 0
operation-location: https://southcentralus.api.cognitive.microsoft.com:443/language/query-knowledgebases/projects/Sample-project/qnas/jobs/{JOB-ID-GUID}
x-envoy-upstream-service-time: 507
apim-request-id:
strict-transport-security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
date: Wed, 24 Nov 2021 03:16:01 GMT
Güncelleştirme sorusu yanıt çiftlerinin durumunu alma
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Aşağıdaki kod örneğindeki uç noktanız buysa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
PROJECT-NAME |
Soru yanıt çiftleri güncelleştirmeleri için hedef olmasını istediğiniz projenin adı. |
JOB-ID |
Soru yanıt çiftini program aracılığıyla güncelleştirdiğinizde, güncelleştirme isteğine yanıt üst bilgisinin operation-location bir parçası olarak bir JOB-ID oluşturulur. JOB-ID , sonundaki GUID'diroperation-location . Örneğin: operation-location: https://southcentralus.api.cognitive.microsoft.com/language/query-knowledgebases/projects/sample-proj1/qnas/jobs/{THIS GUID IS YOUR JOB ID} |
Örnek sorgu
curl -X GET -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '' 'https://southcentralus.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/qnas/jobs/{JOB-ID}?api-version=2021-10-01'
Örnek yanıt
"createdDateTime": "2021-11-24T03:16:01+00:00",
"expirationDateTime": "2021-11-24T09:16:01+00:00",
"jobId": "{JOB-ID-GUID}",
"lastUpdatedDateTime": "2021-11-24T03:16:06+00:00",
"status": "succeeded",
"resultUrl": "/knowledgebases/Sample-project"
Eş Anlamlıları Güncelleştirme
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Aşağıdaki kod örneğindeki uç noktanız buysa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
PROJECT-NAME |
Eş anlamlılar eklemek istediğiniz projenin adı. |
Örnek sorgu
curl -X PUT -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '{
"value": [
{
"alterations": [
"qnamaker",
"qna maker"
]
},
{
"alterations": [
"botframework",
"bot framework"
]
}
]
}' -i 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/synonyms?api-version=2021-10-01'
Örnek yanıt
0HTTP/2 200
content-length: 17
content-type: application/json; charset=utf-8
x-envoy-upstream-service-time: 39
apim-request-id: 5deb2692-dac8-43a8-82fe-36476e407ef6
strict-transport-security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
date: Wed, 24 Nov 2021 03:59:09 GMT
{
"value": []
}
Etkin öğrenme geri bildirimini güncelleştirme
Değişken adı | Değer |
---|---|
ENDPOINT |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Örnek uç nokta: https://southcentralus.api.cognitive.microsoft.com/ . Aşağıdaki kod örneğindeki uç noktanız buysa, uç nokta yolunun geri kalanı zaten mevcut olduğundan yalnızca bölgeye özgü bölümünü southcentral eklemeniz gerekir. |
API-KEY |
Bu değer, Azure portal kaynağınızı incelerken Anahtarlar ve Uç Nokta bölümünde bulunabilir. Key1 veya Key2 kullanabilirsiniz. Her zaman iki geçerli anahtara sahip olmak, sıfır kapalı kalma süresiyle güvenli anahtar döndürmeye olanak tanır. Alternatif olarak, Language Studio'da>projeyi>dağıtma Tahmin URL'sini alma sorusuna yanıt olarak>değerini bulabilirsiniz. Anahtar değeri örnek isteğin bir parçasıdır. |
PROJECT-NAME |
Etkin öğrenme geri bildirim güncelleştirmelerinin hedefi olmasını istediğiniz projenin adı. |
Örnek sorgu
curl -X POST -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '{
records": [
{
"userId": "user1",
"userQuestion": "hi",
"qnaId": 1
},
{
"userId": "user1",
"userQuestion": "hello",
"qnaId": 2
}
]
}' -i 'https://{ENDPOINT}.api.cognitive.microsoft.com/language/query-knowledgebases/projects/{PROJECT-NAME}/feedback?api-version=2021-10-01'
Örnek yanıt
HTTP/2 204
x-envoy-upstream-service-time: 37
apim-request-id: 92225e03-e83f-4c7f-b35a-223b1b0f29dd
strict-transport-security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
date: Wed, 24 Nov 2021 04:02:56 GMT
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin