Konuşma tanıma için ses ve transkripsiyonları günlüğe kaydetme

Konuşmayı metne dönüştürme veya konuşma çevirisi kullanırken hem ses girişi hem de tanınan konuşma için günlüğe kaydetmeyi etkinleştirebilirsiniz. Konuşma çevirisi için yalnızca özgün sesin sesi ve transkripsiyonu günlüğe kaydedilir. Çeviriler günlüğe kaydedilmez. Bu makalede ses ve transkripsiyon günlüklerinin nasıl etkinleştirileceği, erişileceği ve silineceği açıklanır.

Ses ve transkripsiyon günlükleri, özel konuşma modeli eğitimi için giriş olarak kullanılabilir. Başka kullanım örnekleriniz olabilir.

Günlüğe kaydetme işlemi hem temel hem de özel model uç noktaları için zaman uyumsuz olarak yapılır. Konuşma hizmeti, ses ve transkripsiyon günlüklerini dahili depolama alanında depolar ve yerel olarak yazılmaz. Günlükler 30 gün boyunca saklanır. Bu süreden sonra günlükler otomatik olarak silinir. Ancak istediğiniz zaman belirli günlükleri veya kullanılabilir günlük aralığını silebilirsiniz.

Ses ve transkripsiyon günlüklerini, Kendi depolamanızı getir (BYOS) teknolojisini kullanarak Konuşma hizmeti şirket içi yerine sahip olduğunuz ve denetlediğiniz bir Azure Depolama hesabı içinde de depolayabilirsiniz. Bu makalede KCG özellikli Konuşma kaynağının nasıl kullanılacağına ilişkin ayrıntılara bakın.

Ses ve transkripsiyon günlüğünü etkinleştirme

Günlük varsayılan olarak devre dışıdır. Günlük, tanıma oturumu veya özel model uç noktası başına etkinleştirilebilir.

Tek bir tanıma oturumu için günlüğe kaydetmeyi etkinleştirme

Varsayılan temel modeli veya özel model uç noktasını kullanarak tek bir tanıma oturumu için günlüğe kaydetmeyi etkinleştirebilirsiniz.

Konuşma SDK'sı ile konuşmayı metne dönüştürme için günlüğe kaydetmeyi etkinleştirme

speechConfig.EnableAudioLogging();

string isAudioLoggingEnabled = speechConfig.GetProperty(PropertyId.SpeechServiceConnection_EnableAudioLogging);

speechConfig->EnableAudioLogging();

string isAudioLoggingEnabled = speechConfig->GetProperty(PropertyId::SpeechServiceConnection_EnableAudioLogging);

speechConfig.enableAudioLogging();

String isAudioLoggingEnabled = speechConfig.getProperty(PropertyId.SpeechServiceConnection_EnableAudioLogging);

speechConfig.enableAudioLogging();

var SpeechSDK;
SpeechSDK = speechSdk;
// <...>
string isAudioLoggingEnabled = speechConfig.getProperty(SpeechSDK.PropertyId.SpeechServiceConnection_EnableAudioLogging);

speech_config.enable_audio_logging()

import azure.cognitiveservices.speech as speechsdk
# <...>
is_audio_logging_enabled = speech_config.get_property(property_id=speechsdk.PropertyId.SpeechServiceConnection_EnableAudioLogging)

[speechConfig enableAudioLogging];

NSString *isAudioLoggingEnabled = [speechConfig getPropertyById:SPXSpeechServiceConnectionEnableAudioLogging];

Konuşma SDK'sı ile konuşma çevirisi için günlüğe kaydetmeyi etkinleştirme

Konuşma çevirisi için yalnızca özgün sesin sesi ve transkripsiyonu günlüğe kaydedilir. Çeviriler günlüğe kaydedilmez.

speechTranslationConfig.EnableAudioLogging();

string isAudioLoggingEnabled = speechTranslationConfig.GetProperty(PropertyId.SpeechServiceConnection_EnableAudioLogging);

speechTranslationConfig->EnableAudioLogging();

string isAudioLoggingEnabled = speechTranslationConfig->GetProperty(PropertyId::SpeechServiceConnection_EnableAudioLogging);

speechTranslationConfig.enableAudioLogging();

String isAudioLoggingEnabled = speechTranslationConfig.getProperty(PropertyId.SpeechServiceConnection_EnableAudioLogging);

speechTranslationConfig.enableAudioLogging();

var SpeechSDK;
SpeechSDK = speechSdk;
// <...>
string isAudioLoggingEnabled = speechTranslationConfig.getProperty(SpeechSDK.PropertyId.SpeechServiceConnection_EnableAudioLogging);

speech_translation_config.enable_audio_logging()

import azure.cognitiveservices.speech as speechsdk
# <...>
is_audio_logging_enabled = speech_translation_config.get_property(property_id=speechsdk.PropertyId.SpeechServiceConnection_EnableAudioLogging)

[speechTranslationConfig enableAudioLogging];

NSString *isAudioLoggingEnabled = [speechTranslationConfig getPropertyById:SPXSpeechServiceConnectionEnableAudioLogging];

Kısa ses için Konuşmayı metne dönüştürme REST API'sinde günlüğe kaydetmeyi etkinleştirme

Kısa ses için KONUŞMAYı metne dönüştürme REST API'sini kullanıyorsanız ve ses ve transkripsiyon günlüğünü etkinleştirmek istiyorsanız, REST isteğinizin bir parçası olarak sorgu parametresini ve değerini storeAudio=true kullanmanız gerekir. Örnek istek şuna benzer:

https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?language=en-US&storeAudio=true

Özel model uç noktası için ses ve transkripsiyon günlüğünü etkinleştirme

Bu yöntem yalnızca özel konuşma uç noktaları için geçerlidir.

Günlük, kalıcı özel model uç noktası ayarlarında etkinleştirilebilir veya devre dışı bırakılabilir. Özel model uç noktası için günlüğe kaydetme etkinleştirildiğinde (açıkken), SDK veya REST API ile tanıma oturumu düzeyinde günlüğe kaydetmeyi etkinleştirmeniz gerekmez. Özel model uç noktası için günlüğe kaydetme etkinleştirilmemiş olsa bile SDK veya REST API ile tanıma oturumu düzeyinde günlüğü geçici olarak etkinleştirebilirsiniz.

Özel model uç noktası için ses ve transkripsiyon günlüğünü etkinleştirebilirsiniz:

• Uç noktayı Speech Studio, REST API veya Konuşma CLI'sını kullanarak oluşturduğunuzda. Özel konuşma uç noktası için günlüğe kaydetmeyi etkinleştirme hakkında ayrıntılı bilgi için bkz . Özel konuşma modeli dağıtma.
• Konuşma metni REST API'sini kullanarak uç noktayı (Endpoints_Update) güncelleştirdiğinizde. Bir uç nokta için günlüğe kaydetme ayarının nasıl güncelleştirildiğini gösteren bir örnek için bkz . Özel model uç noktası için günlüğü kapatma. Ancak özelliğini falseolarak ayarlamak contentLoggingEnabled yerine, uç nokta için günlüğe kaydetmeyi etkinleştirecek şekilde true ayarlayın.

Özel model uç noktası için günlüğe kaydetmeyi kapatma

Özel model uç noktası için ses ve transkripsiyon günlüğünü devre dışı bırakmak için Konuşmayı metne dönüştürme REST API'sini kullanarak kalıcı uç nokta günlüğü ayarını güncelleştirmeniz gerekir. Speech Studio kullanarak mevcut bir özel model uç noktası için günlüğe kaydetmeyi devre dışı bırakmanın bir yolu yoktur.

Özel uç nokta için günlüğe kaydetmeyi kapatmak için Konuşmayı metne dönüştürme REST API'sinin Endpoints_Update işlemini kullanın. İstek gövdesini aşağıdaki yönergelere göre oluşturun:

• özelliğini içinde contentLoggingEnabled propertiesayarlayın. Uç nokta trafiğinin günlüğe kaydedilmesini etkinleştirmek için bu özelliği true olarak ayarlayın. Uç nokta trafiğinin günlüğe false kaydedilmesini devre dışı bırakmak için bu özelliği olarak ayarlayın.

Aşağıdaki örnekte gösterildiği gibi URI'yi kullanarak bir HTTP PATCH isteği oluşturun. değerini YourSubscriptionKey Konuşma kaynak anahtarınızla değiştirin, değerini YourServiceRegion Konuşma kaynağı bölgenizle değiştirin, değerini uç nokta kimliğiniz ile değiştirin YourEndpointId ve istek gövdesi özelliklerini daha önce açıklandığı gibi ayarlayın.

curl -v -X PATCH -H "Ocp-Apim-Subscription-Key: YourSubscriptionKey" -H "Content-Type: application/json" -d '{
  "properties": {
    "contentLoggingEnabled": false
  },
}'  "https://YourServiceRegion.api.cognitive.microsoft.com/speechtotext/v3.2/endpoints/YourEndpointId"

Aşağıdaki biçimde bir yanıt gövdesi almanız gerekir:

{
  "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/endpoints/a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
  "model": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/models/9e240dc1-3d2d-4ac9-98ec-1be05ba0e9dd"
  },
  "links": {
    "logs": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/endpoints/a07164e8-22d1-4eb7-aa31-bf6bb1097f37/files/logs",
    "restInteractive": "https://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "restConversation": "https://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "restDictation": "https://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "webSocketInteractive": "wss://eastus.stt.speech.microsoft.com/speech/recognition/interactive/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "webSocketConversation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/conversation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37",
    "webSocketDictation": "wss://eastus.stt.speech.microsoft.com/speech/recognition/dictation/cognitiveservices/v1?cid=a07164e8-22d1-4eb7-aa31-bf6bb1097f37"
  },
  "project": {
    "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/projects/0198f569-cc11-4099-a0e8-9d55bc3d0c52"
  },
  "properties": {
    "loggingEnabled": false
  },
  "lastActionDateTime": "2024-07-15T16:30:12Z",
  "status": "Succeeded",
  "createdDateTime": "2024-07-15T16:29:36Z",
  "locale": "en-US",
  "displayName": "My Endpoint",
  "description": "My Endpoint Description"
}

Yanıt gövdesi yeni ayarı yansıtmalıdır. Yanıttaki (loggingEnabled) günlük özelliğinin adı, istekte (contentLoggingEnabled) ayarladığınız günlük özelliğinin adından farklıdır.

Ses ve transkripsiyon günlüklerini alma

Konuşmayı metne dönüştürme REST API'sini kullanarak ses ve transkripsiyon günlüklerine erişebilirsiniz. Özel model uç noktaları için Speech Studio'yu da kullanabilirsiniz. Aşağıdaki bölümlerdeki ayrıntılara bakın.

Speech Studio ile ses ve transkripsiyon günlüklerini alma

Bu yöntem yalnızca özel model uç noktaları için geçerlidir.

Uç nokta günlüklerini indirmek için:

1. Speech Studio'da oturum açın.
2. Özel konuşma Projenizin adı> Modelleri dağıt'ı seçin.>
3. Uç nokta adına göre bağlantıyı seçin.
4. İçerik günlüğü altında Günlüğü indir'i seçin.

Bu yaklaşımla tüm kullanılabilir günlük kümelerini aynı anda indirebilirsiniz. Speech Studio'da seçili günlük kümelerini indirmenin hiçbir yolu yoktur.

Konuşmayı metne dönüştürme REST API'siyle ses ve transkripsiyon günlüklerini alma

Kullanılabilir günlük kümelerinin tümünü veya bir alt kümesini indirebilirsiniz.

Bu yöntem temel ve özel model uç noktaları için geçerlidir. Ses ve transkripsiyon günlüklerini listelemek ve indirmek için:

• Temel modeller: Konuşmayı metne dönüştürme REST API'sinin Endpoints_ListBaseModelLogs işlemini kullanın. Bu işlem, belirli bir dilin varsayılan temel modeli kullanılırken depolanan ses ve transkripsiyon günlüklerinin listesini alır.
• Özel model uç noktaları: Konuşmayı metne dönüştürme REST API'sinin Endpoints_ListLogs işlemini kullanın. Bu işlem, belirli bir uç nokta için depolanan ses ve transkripsiyon günlüklerinin listesini alır.

Konuşmayı metne dönüştürme REST API'siyle günlük kimliklerini alma

Bazı senaryolarda, kullanılabilir günlüklerin kimliklerini almanız gerekebilir. Örneğin, bu makalenin devamında açıklandığı gibi belirli bir günlüğü silmek isteyebilirsiniz.

Kullanılabilir günlüklerin kimliklerini almak için:

• Temel modeller: Konuşmayı metne dönüştürme REST API'sinin Endpoints_ListBaseModelLogs işlemini kullanın. Bu işlem, belirli bir dilin varsayılan temel modeli kullanılırken depolanan ses ve transkripsiyon günlüklerinin listesini alır.
• Özel model uç noktaları: Konuşmayı metne dönüştürme REST API'sinin Endpoints_ListLogs işlemini kullanın. Bu işlem, belirli bir uç nokta için depolanan ses ve transkripsiyon günlüklerinin listesini alır.

aşağıda örnek bir Endpoints_ListLogs çıktısı verilmişti. Kolaylık olması için yalnızca bir günlük kümesi gösterilir:

{
  "values": [
    {
      "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/endpoints/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/files/logs/2023-03-13_163715__0420c53d-e6ac-4857-bce0-f39c3f9f5ff9_v2_json",
      "name": "163715__0420c53d-e6ac-4857-bce0-f39c3f9f5ff9.v2.json",
      "kind": "Transcription",
      "properties": {
        "size": 79920
      },
      "createdDateTime": "2024-07-15T16:29:36Z",
      "links": {
        "contentUrl": "<Link to download log file>"
      }
    },
    {
      "self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/endpoints/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/files/logs/2023-03-13_163715__0420c53d-e6ac-4857-bce0-f39c3f9f5ff9_wav",
      "name": "163715__0420c53d-e6ac-4857-bce0-f39c3f9f5ff9.wav",
      "kind": "Audio",
      "properties": {
        "size": 932966
      },
      "createdDateTime": "2024-07-15T16:29:36Z",
      "links": {
        "contentUrl": "<Link to download log file>"
      }
    }
  ]
}

Her ses ve transkripsiyon günlük dosyasının konumları yanıt gövdesinde döndürülür. Dosyanın ses () veya transkripsiyon"kind": "Transcription" ("kind": "Audio") içerip içermediğini belirlemek için ilgili kind özelliğe bakın.

Her günlük dosyasının günlük kimliği, url'nin öğe değerindeki "self" son bölümüdür. Aşağıdaki örnekteki günlük kimliği şeklindedir 2023-03-13_163715__0420c53d-e6ac-4857-bce0-f39c3f9f5ff9_v2_json.

"self": "https://eastus.api.cognitive.microsoft.com/speechtotext/v3.2/endpoints/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/files/logs/2023-03-13_163715__0420c53d-e6ac-4857-bce0-f39c3f9f5ff9_v2_json"

Ses ve transkripsiyon günlüklerini silme

Günlük verileri 30 gün boyunca tutulur. Bu süreden sonra günlükler otomatik olarak silinir. Ancak istediğiniz zaman belirli günlükleri veya kullanılabilir günlük aralığını silebilirsiniz.

Herhangi bir temel veya özel model uç noktası için tüm kullanılabilir günlükleri, belirli bir zaman çerçevesine ait günlükleri veya Günlük Kimliğine göre belirli bir günlüğü silebilirsiniz. Silme işlemi zaman uyumsuz olarak yapılır ve günlük dosyalarının sayısına bağlı olarak dakikalar, saatler, bir gün veya daha uzun sürebilir.

Ses ve transkripsiyon günlüklerini silmek için Konuşmayı metne dönüştürme REST API'sini kullanmanız gerekir. Speech Studio kullanarak günlükleri silmenin bir yolu yoktur.

Belirli bir zaman çerçevesi için tüm günlükleri veya günlükleri silme

Belirli bir zaman çerçevesine ilişkin tüm günlükleri veya günlükleri silmek için:

• Temel modeller: Konuşmayı metne dönüştürme REST API'sinin Endpoints_DeleteBaseModelLogs işlemini kullanın.
• Özel model uç noktaları: Konuşmayı metne dönüştürme REST API'sinin Endpoints_DeleteLogs işlemini kullanın.

İsteğe bağlı olarak, ses günlüklerinin silinmesini (belirli bir gün, UTC) ayarlayın endDate . Beklenen biçim: "yyyy-mm-dd". Örneğin, "2023-03-15", 15 Mart 2023 ve öncesinde tüm günlüklerin silinmesiyle sonuçlanıyor.

Belirli bir günlüğü silme

Belirli bir günlüğü kimlikle silmek için:

• Temel modeller: Konuşmayı metne dönüştürme REST API'sinin Endpoints_DeleteBaseModelLog işlemini kullanın.
• Özel model uç noktaları: Konuşmayı metne dönüştürme REST API'sinin Endpoints_DeleteLog işlemini kullanın.

Günlük kimliklerini alma hakkında ayrıntılı bilgi için, Konuşma metni REST API'siyle günlük kimliklerini alma bölümüne bakın.

Ses ve transkripsiyon günlüklerinde ayrı kimlikler (örneğin, kimlikler 2023-03-13_163715__0420c53d-e6ac-4857-bce0-f39c3f9f5ff9_v2_json ve 2023-03-13_163715__0420c53d-e6ac-4857-bce0-f39c3f9f5ff9_wav bu makaledeki önceki bir örnekten) olduğundan, hem ses hem de transkripsiyon günlüklerini silmek istediğinizde kimlik isteklerine göre ayrı silme işlemi yürütürsunuz.

Sonraki adımlar

• Konuşmayı metne dönüştürme hızlı başlangıcı
• Konuşma çevirisi hızlı başlangıcı
• Özel konuşma modelleri oluşturma ve eğitma