

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 了解 Amazon Chime SDK 的發言者搜尋工作流程
<a name="va-data-flow"></a>

在本節中，我們向您展示 Amazon Chime SDK 發言者搜尋分析的範例資料和程式流程。

發言者搜尋函數涉及建立語音內嵌，可用來比較來電者的語音與先前儲存的語音資料。以數位聲紋形式收集、使用、儲存和保留生物識別符和生物識別資訊，可能需要發起人透過書面版本取得同意。根據各種州法律，包括伊利諾州、德克薩斯州、華盛頓州和其他州隱私權法律，此類同意是必要的。在使用發言者搜尋功能之前，您必須提供所有通知，並依據適用法律以及規範您使用此功能的 [AWS 服務條款](https://aws.amazon.com/service-terms/)，取得所有同意。

下圖顯示透過發言者搜尋分析任務的範例資料流程。圖表下方的編號描述說明程序的每個步驟。圖表假設您已使用具有 的通話分析組態來設定 Amazon Chime SDK Voice Connector`VoiceAnalyticsProcessor`。如需詳細資訊，請參閱[錄製語音連接器呼叫](record-vc-calls.md)。

![\[圖表顯示透過發言者搜尋分析的資料流程。\]](http://docs.aws.amazon.com/zh_tw/chime-sdk/latest/dg/images/speaker-search-workflow-2.png)


1. 您或系統管理員會建立語音設定檔網域，以存放語音內嵌和語音設定檔。如需建立語音設定檔網域的詳細資訊，請參閱《*Amazon Chime SDK 管理員指南*》中的[建立語音設定檔網域](https://docs.aws.amazon.com/chime-sdk/latest/ag/create-vp-domain.html)。您也可以使用 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceProfileDomain.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceProfileDomain.html) API。

1. 來電者使用指派給 Amazon Chime SDK Voice Connector 的電話號碼撥入 。或者，客服人員使用語音連接器號碼進行外撥通話。

1. Amazon Chime SDK Voice Connector 服務會建立交易 ID，並將其與呼叫建立關聯。

1. 假設您的應用程式訂閱 EventBridge 事件，您的應用程式會使用媒體洞察管道組態和語音連接器呼叫的 Kinesis Video Stream ARNs 來呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_CreateMediaInsightsPipeline.html) API。

   如需使用 EventBridge 的詳細資訊，請參閱 [了解 Amazon Chime SDK 機器學習型分析的工作流程](ml-based-analytics.md)。

1. 您的應用程式，例如互動式語音回應系統，或客服人員會通知來電者有關通話錄音和使用語音內嵌進行語音分析，並尋求他們的參與同意。

1. 發起人提供同意後，如果您有 Voice Connector 和交易 ID，您的應用程式或客服人員可以透過[語音 SDK](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Voice.html) 呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_StartSpeakerSearchTask.html) API。或者，如果您有媒體洞察管道 ID 而不是交易 ID，您可以在[媒體管道 SDK ](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_Operations_Amazon_Chime_SDK_Media_Pipelines.html)中呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_media-pipelines-chime_StartSpeakerSearchTask.html) API。

   一旦發起人提供同意，您的應用程式或客服人員就會呼叫 `StartSpeakerSearchTask` API。您必須將語音連接器 ID、交易 ID 和語音設定檔網域 ID 傳遞給 API。會傳回發言者搜尋任務 ID，以識別非同步任務。
**注意**  
在任一SDKs中調用 `StartSpeakerSearchTask` API 之前，您必須根據法律和 [AWS 服務條款](https://aws.amazon.com/service-terms/)的要求，提供任何必要的通知，並取得任何必要的同意。

1. 系統會累積 10 秒的來電者語音。發起人必須至少說出該時間。系統不會擷取或分析靜音。

1. 媒體洞察管道會將語音與網域中的語音設定檔進行比較，並列出前 10 個高可信度配對。如果找不到相符項目，語音連接器會建立語音設定檔。

1. 媒體洞察管道服務會將通知事件傳送至設定的通知目標。

1. 發起人會繼續說話，並提供額外 10 秒的非靜音語音。

1. 媒體洞察管道會產生註冊語音內嵌，您可以用來建立語音設定檔或更新現有的語音設定檔。

1. 媒體洞察管道會將`VoiceprintGenerationSuccessful`通知傳送至設定的通知目標。

1. 您的應用程式會呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceProfile.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_CreateVoiceProfile.html)或 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UpdateVoiceProfile.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_UpdateVoiceProfile.html) APIs來建立或更新設定檔。

1. 您的應用程式會視需要呼叫 [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_GetSpeakerSearchTask.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_voice-chime_GetSpeakerSearchTask.html) API，以取得發言者搜尋任務的最新狀態。