

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

# 程式碼範例
<a name="sonic-code-examples"></a>

這些程式碼範例可協助您快速開始使用 Amazon Nova 2 Sonic。您可以在 [Amazon Nova Sonic GitHub 範例](https://github.com/aws-samples/amazon-nova-samples/tree/main/speech-to-speech/amazon-nova-2-sonic)頁面中存取範例的完整清單。

## 入門範例
<a name="sonic-getting-started-examples"></a>

如需協助您開始使用 Amazon Nova 2 Sonic 的簡單範例，請參閱下列實作：
+ [基本 Amazon Nova 2 Sonic 實作 (Python)](https://github.com/aws-samples/amazon-nova-samples/blob/main/speech-to-speech/amazon-nova-2-sonic/sample-codes/console-python/nova_sonic_simple.py)：基本實作，示範如何在雙向串流 API 中建構事件。此版本不支援插斷輸入功能 （在語音時中斷助理），而且不會實作真正的雙向通訊。
+ [全功能 Amazon Nova 2 Sonic 實作 (Python)](https://github.com/aws-samples/amazon-nova-samples/blob/main/speech-to-speech/amazon-nova-2-sonic/sample-codes/console-python/nova_sonic_tool_use.py)：具有真實雙向通訊和插斷支援的完整功能實作。這允許更自然的對話，使用者可以在說話時中斷助理，類似於人工對話。
+ [Amazon Nova 2 Sonic with tool use (Python)](https://github.com/aws-samples/amazon-nova-samples/blob/main/speech-to-speech/amazon-nova-2-sonic/sample-codes/console-python/nova_sonic_tool_use.py)：進階實作，透過工具使用範例擴展雙向通訊功能。此版本示範 Amazon Nova 2 Sonic 如何與外部工具和 APIs 互動，以提供增強的功能。
+ [Nova Sonic 搭配文字和混合輸入 (Python)](https://github.com/aws-samples/amazon-nova-samples/blob/main/speech-to-speech/amazon-nova-2-sonic/sample-codes/console-python/nova_sonic_with_text.py)：範例實作，示範 Amazon Nova 2 Sonic 如何將文字做為輸入。
+ [Java WebSocket 實作 (Java)](https://github.com/aws-samples/amazon-nova-samples/tree/main/speech-to-speech/amazon-nova-2-sonic/sample-codes/websocket-java)：此範例實作雙向 WebSocket 型音訊串流應用程式，與 Amazon Nova 2 Sonic 整合，以使用 Java 進行即時speech-to-speech對話。
+ [NodeJS Websocket 實作 (NodeJS)](https://github.com/aws-samples/amazon-nova-samples/tree/main/speech-to-speech/amazon-nova-2-sonic/sample-codes/websocket-nodejs)：此範例實作雙向 WebSocket 型音訊串流應用程式，可與 Amazon Nova 2 Sonic 整合，以便使用 NodeJS 進行即時speech-to-speech對話。
+ [NodeJS Websocket 實作 (C\$1)](https://github.com/aws-samples/amazon-nova-samples/tree/main/speech-to-speech/amazon-nova-2-sonic/sample-codes/websocket-dotnet)：此範例實作雙向 WebSocket 型音訊串流應用程式，可與 Amazon Nova 2 Sonic 整合，以便使用 .NET 進行即時speech-to-speech對話。

## 進階使用案例
<a name="sonic-advanced-examples"></a>

如需示範更複雜使用案例的進階範例，請參閱下列實作：
+ [Amazon Bedrock 知識庫實作 (NodeJS)](https://github.com/aws-samples/amazon-nova-samples/tree/main/speech-to-speech/amazon-nova-2-sonic/repeatable-patterns/bedrock-knowledge-base)：此範例示範如何使用 NodeJS 將 Amazon Nova 2 Sonic 與 Amazon Bedrock 知識庫整合，以建置智慧型對話應用程式。
+ [聊天歷史記錄管理 (Python)](https://github.com/aws-samples/amazon-nova-samples/tree/main/speech-to-speech/amazon-nova-2-sonic/repeatable-patterns/chat-history-logger)：此範例包含聊天歷史記錄記錄系統，該系統使用 Python 擷取並保留使用者與 Amazon Nova 2 Sonic 之間的所有互動。
+ [飯店預訂取消 (NodeJS)](https://github.com/aws-samples/amazon-nova-samples/tree/main/speech-to-speech/amazon-nova-2-sonic/repeatable-patterns/customer-service/hotel-cancellation-websocket)：此範例示範了 Amazon Nova 2 Sonic 的實際客戶服務使用案例，並使用 NodeJS 實作飯店預訂取消系統。
+ [LangChain 知識庫整合 (Python)](https://github.com/aws-samples/amazon-nova-samples/tree/main/speech-to-speech/amazon-nova-2-sonic/repeatable-patterns/langchain-knowledge-base)：此實作示範如何將 Amazon Nova 2 Sonic speech-to-speech功能與 LangChain 支援的知識庫整合，以使用 Python 增強對話體驗。
+ [對話恢復 (NodeJS)](https://github.com/aws-samples/amazon-nova-samples/tree/main/speech-to-speech/amazon-nova-2-sonic/repeatable-patterns/resume-conversation)：此範例示範如何使用 Amazon Nova 2 Sonic 實作對話恢復功能。使用飯店預訂取消案例做為內容，應用程式會示範如何維持工作階段之間的對話狀態，讓使用者順暢地繼續之前使用 NodeJS 中斷的互動。
+ [Nova 2 Sonic Speaks First (NodeJS)](https://github.com/aws-samples/amazon-nova-samples/tree/main/speech-to-speech/amazon-nova-2-sonic/repeatable-patterns/nova-sonic-speaks-first)：此範例示範 Amazon Nova 2 Sonic 如何主動啟動對話。
+ [工作階段持續 (Python)](https://github.com/aws-samples/amazon-nova-samples/tree/main/speech-to-speech/amazon-nova-2-sonic/repeatable-patterns/session-continuation/console-python)：此範例示範如何實作無縫工作階段轉換，以啟用與 Amazon Nova 2 Sonic 的無限對話長度。應用程式會自動在背景建立並切換到新的工作階段，讓對話無限期地繼續，而不會中斷或失去內容。

## 實際操作工作坊
<a name="sonic-workshop"></a>

提供實作研討會，引導您使用 Amazon Nova 2 Sonic 搭配雙向串流介面建置語音聊天應用程式。您可以[存取研討會](https://catalog.us-east-1.prod.workshops.aws/workshops/5238419f-1337-4e0f-8cd7-02239486c40d/en-US)並找到[完整的程式碼範例](https://github.com/aws-samples/amazon-nova-samples/tree/main/speech-to-speech/amazon-nova-2-sonic/workshops)。