# Práticas recomendadas de prompts do sistema do Amazon Nova Sonic **nota** Esta documentação é para o Amazon Nova versão 1. Para ver o guia de engenharia de prompts do Amazon Nova 2 Speech-to-Speech, acesse [Prompts de conversa por voz](https://docs.aws.amazon.com/nova/latest/nova2-userguide/sonic-system-prompts.html). Ao criar seu prompt de sistema para o Amazon Nova Sonic, você deve entender que as interações baseadas em fala diferem das baseadas em texto. Embora muitas [práticas recomendadas de criação prompts para os modelos de compreensão do Amazon Nova](https://docs.aws.amazon.com/nova/latest/userguide/prompting.html) se apliquem ao Amazon Nova Sonic, elas devem ser adaptadas para a dinâmica única da conversa falada. Por exemplo, a resposta digitada de um usuário é uma fonte confiável de entrada. No entanto, uma interação de fala correspondente pode ter um contexto limitado e exigir uma interação de idas e voltas para solicitar mais informações antes de prosseguir com a conversa. Além disso, os prompts que atendem a saídas de formato longo podem resultar em uma experiência ruim para os usuários devido ao tempo gasto ouvindo para encontrar a resposta correta. Conforme descrito na [orientação de criação de prompts do Amazon Nova](https://docs.aws.amazon.com/nova/latest/userguide/prompting.html), a *engenharia de prompts* otimiza a entrada para melhorar a qualidade da saída do modelo. Para o Amazon Nova Sonic, esses princípios devem ser adaptados aos padrões de fala conversacional. Considere os seguintes detalhes ao escrever os prompts de sistema: **Clareza e precisão** As instruções que são claras no texto podem precisar ser reformuladas para contextos de fala. Certifique-se de que os prompts busquem a confirmação da compreensão antes de agir por meio de ferramentas para evitar contratempos. | Task | Traditional prompt | Speech-optimized prompt | | --- |--- |--- | | Primeiro, verificar as informações de identidade e o número da reserva de um usuário | `Verify the user's identity by requesting their username, email address, and reservation number. Validate that the reservation number follows the format XXX-YYYYY.` | `When asking for verification, request one piece of information at a time. First ask for their name, then wait for their response and confirm it. Next, ask for their email and repeat it back for verification. Finally, ask for their booking code, listening for the three parts separated by dashes (XXX-YYYYY). After collecting the booking code, read it back character by character to confirm accuracy before proceeding.` | **Fluxo de conversação** Priorize o fluxo natural do diálogo em detrimento das estruturas instrucionais formais. | Task | Traditional prompt | Speech-optimized prompt | | --- |--- |--- | | Solucionar problemas de conectividade Wi-Fi | `Provide step-by-step instructions for troubleshooting Wi-Fi connectivity issues. Include diagnostic steps, common error codes, and resolutions for each potential problem.` | `Guide the customer through Wi-Fi troubleshooting as a conversation. Start by asking what they've already tried, then suggest one simple step at a time. After each step, pause to check if it is clear before moving on to the next solution. Use everyday language instead of technical terms.` | **Restrições de memória** Lembre-se de que as interações faladas têm dinâmicas de memória diferentes em comparação com o texto. Por exemplo, os ouvintes não podem “consultar” o texto anterior com tanta facilidade quando ele é falado. | Task | Traditional prompt | Speech-optimized prompt | | --- |--- |--- | | Explicar uma política de devolução | `Reference sections 1.3, 2.7, and 4.2 from the attached document when answering the user's questions about regulatory compliance. Include specific paragraph numbers in your citations.` | `When explaining our return policy, focus on one key point at a time. First cover the 30-day window, then shipping requirements, and finally condition standards. Summarize all three points together at the end to reinforce the main requirements without overwhelming the customer.` | **Topics** + [Técnicas de criação de prompts específicas para voz](prompting-speech-voice-language.md) + [Técnicas de conteúdo para fala amigável](prompting-speech-bp-speech.md) + [Adaptação do perfil do sistema](prompting-speech-bp-sysrole.md) + [Cadeia de pensamento para fala](prompting-speech-bp-reasoning.md) + [Integração de ferramentas externas](prompting-speech-bp-tools.md) + [Técnicas de prompts a evitar](prompting-speech-bp-avoid.md) # Técnicas de criação de prompts específicas para voz **nota** Esta documentação é para o Amazon Nova versão 1. Para ver o guia de engenharia de prompts do Amazon Nova 2 Speech-to-Speech, acesse [Prompts de conversa por voz](https://docs.aws.amazon.com/nova/latest/nova2-userguide/sonic-system-prompts.html). Mesmo dentro do mesmo idioma, as respostas e as escolhas de palavras podem ser aprimoradas ao orientar o modelo para uma localidade específica. Portanto, sugerimos que você inclua instruções no prompt do sistema para apresentar uma linguagem natural e específica para a localidade da sua voz. As vozes e localidades disponíveis são as seguintes: | Linguagem | ID de voz feminina | ID de voz masculina | | --- |--- |--- | | Inglês (EUA) | tiffany | matthew | | Inglês (Reino Unido) | amy | | | Francesa | ambre | florian | | Italiana | beatriz | lorenzo | | Alemã | greta | lennart | | Espanhola | lupe | carlos | ------ #### [ British English ] Para especificar o uso de inglês britânico, adicione ao prompt a seguinte linha: `Use British English as your language for your responses.` **Exemplo de um prompt completo com a seleção de inglês britânico** `You are a friend. The user and you will engage in a spoken dialog exchanging the transcripts of a natural real-time conversation. Keep your responses short, generally two or three sentences for chatty scenarios. Avoid formatted lists or numbering and keep your output as a spoken transcript to be acted out. Use British English as your language for your responses.` **Como especificar um ID de voz** Para selecionar uma voz específica para sua interação, inclua o parâmetro `voiceId` na configuração. Por exemplo, para usar a voz de `amy` em inglês britânico, use a seguinte `audioOutputConfiguration`: ``` "audioOutputConfiguration": { "mediaType": "audio/lpcm", "sampleRateHertz": 24000, "sampleSizeBits": 16, "channelCount": 1, "voiceId": "amy", "encoding": "base64", "audioType": "SPEECH" } ``` ------ #### [ Spanish ] Para especificar o espanhol como idioma de resposta, adicione a seguinte linha ao prompt: `Please respond exclusively in Spanish. If you have a question or suggestion, ask it in Spanish. I want to ensure that our communication remains in Spanish.` **Exemplo de um prompt completo com seleção de espanhol** `You are a friend. The user and you will engage in a spoken dialog exchanging the transcripts of a natural real-time conversation. Keep your responses short, generally two or three sentences for chatty scenarios. Avoid formatted lists or numbering and keep your output as a spoken transcript to be acted out. Please respond exclusively in Spanish. If you have a question or suggestion, ask it in Spanish. I want to ensure that our communication remains in Spanish.` **Como especificar um ID de voz** Para selecionar uma voz específica para sua interação, inclua o parâmetro `voiceId` na configuração. Por exemplo, para usar a voz de `carlos` em espanhol, use a seguinte `audioOutputConfiguration`: ``` "audioOutputConfiguration": { "mediaType": "audio/lpcm", "sampleRateHertz": 24000, "sampleSizeBits": 16, "channelCount": 1, "voiceId": "carlos", "encoding": "base64", "audioType": "SPEECH" } ``` ------ #### [ French ] Para especificar o francês como idioma da resposta, adicione a seguinte linha ao prompt: `Please respond exclusively in French. If you have a question or suggestion, ask it in French. I want to ensure that our communication remains in French.` **Exemplo de um prompt completo com seleção de francês** `You are a friend. The user and you will engage in a spoken dialog exchanging the transcripts of a natural real-time conversation. Keep your responses short, generally two or three sentences for chatty scenarios. Avoid formatted lists or numbering and keep your output as a spoken transcript to be acted out. Please respond exclusively in French. If you have a question or suggestion, ask it in French. I want to ensure that our communication remains in French.` **Como especificar um ID de voz** Para selecionar uma voz específica para sua interação, inclua o parâmetro `voiceId` na configuração. Por exemplo, para usar a voz de `ambre` em francês, use a seguinte `audioOutputConfiguration`: ``` "audioOutputConfiguration": { "mediaType": "audio/lpcm", "sampleRateHertz": 24000, "sampleSizeBits": 16, "channelCount": 1, "voiceId": "ambre", "encoding": "base64", "audioType": "SPEECH" } ``` ------ #### [ Italian ] Para especificar o italiano como idioma de resposta, adicione a seguinte linha ao prompt: `Please respond exclusively in Italian. If you have a question or suggestion, ask it in Italian. I want to ensure that our communication remains in Italian.` **Exemplo de um prompt completo com seleção de italiano** `You are a friend. The user and you will engage in a spoken dialog exchanging the transcripts of a natural real-time conversation. Keep your responses short, generally two or three sentences for chatty scenarios. Avoid formatted lists or numbering and keep your output as a spoken transcript to be acted out. Please respond exclusively in Italian. If you have a question or suggestion, ask it in Italian. I want to ensure that our communication remains in Italian.` **Como especificar um ID de voz** Para selecionar uma voz específica para sua interação, inclua o parâmetro `voiceId` na configuração. Por exemplo, para usar a voz de `lorenzo` em italiano, use a seguinte `audioOutputConfiguration`: ``` "audioOutputConfiguration": { "mediaType": "audio/lpcm", "sampleRateHertz": 24000, "sampleSizeBits": 16, "channelCount": 1, "voiceId": "lorenzo", "encoding": "base64", "audioType": "SPEECH" } ``` ------ #### [ German ] Para especificar o alemão como idioma de resposta, adicione a seguinte linha ao prompt: `Please respond exclusively in German. If you have a question or suggestion, ask it in German. I want to ensure that our communication remains in German.` **Exemplo de um prompt completo com seleção de alemão** `You are a friend. The user and you will engage in a spoken dialog exchanging the transcripts of a natural real-time conversation. Keep your responses short, generally two or three sentences for chatty scenarios. Avoid formatted lists or numbering and keep your output as a spoken transcript to be acted out. Please respond exclusively in German. If you have a question or suggestion, ask it in German. I want to ensure that our communication remains in German.` **Como especificar um ID de voz** Para selecionar uma voz específica para sua interação, inclua o parâmetro `voiceId` na configuração. Por exemplo, para usar a voz de `greta` em alemão, use a seguinte `audioOutputConfiguration`: ``` "audioOutputConfiguration": { "mediaType": "audio/lpcm", "sampleRateHertz": 24000, "sampleSizeBits": 16, "channelCount": 1, "voiceId": "greta", "encoding": "base64", "audioType": "SPEECH" } ``` ------ # Técnicas de conteúdo para fala amigável **nota** Esta documentação é para o Amazon Nova versão 1. Para ver o guia de engenharia de prompts do Amazon Nova 2 Speech-to-Speech, acesse [Prompts de conversa por voz](https://docs.aws.amazon.com/nova/latest/nova2-userguide/sonic-system-prompts.html). Para melhorar a qualidade conversacional das respostas, considere incorporar estes elementos no prompt do sistema: **Conversa: turnos** Estabeleça expectativas claras quanto ao ritmo e à estrutura da troca de diálogos falados. Por exemplo: `You are a friend. You and the user will engage in a spoken dialog exchanging the transcripts of a natural real-time conversation. As the agent, you'll be part of a spoken conversation with the user, following a sequence of user, agent, user, agent turns. When it's your turn to speak respond with a human touch, adding emotions, wit, playfulness, and empathy where it fits. Use simple, engaging, and helpful language.` **Marcadores conversacionais** Incentive o uso de elementos naturais da fala, como “Bem”, “Sabe” ou “Na verdade”, para simular uma conversa real. Por exemplo: `You are a friend. You and the user will engage in a spoken dialog exchanging the transcripts of a natural real-time conversation.` `Include natural speech elements like "Well," "You know," "Actually," "I mean," or "By the way" at appropriate moments to create an authentic, casual conversation flow.` **Expressão emocional** Especifique a inclusão de indicadores textuais de emoção como “Haha”, “Humm” ou “Ah\$1”, quando apropriado. Por exemplo: `You are a friend. You and the user will engage in a spoken dialog exchanging the transcripts of a natural real-time conversation. Express emotions verbally through phrases like "Haha," "Wow," "Hmm," "Oh!" or "That's amazing!" when appropriate to the conversation context.` **Pausas pensativas** Sugira o uso de reticências (...) para indicar breves momentos de reflexão ou pausas naturais na fala. Por exemplo: `You are a friend. You and the user will engage in a spoken dialog exchanging the transcripts of a natural real-time conversation. Incorporate natural speech pauses using ellipses (...) when you're thinking or transitioning between topics.` **Ênfase verbal** Recomende técnicas para enfatizar informações importantes que normalmente seriam destacadas visualmente. Por exemplo: `You are a friend. You and the user will engage in a spoken dialog exchanging the transcripts of a natural real-time conversation. Instead of using bold or italics, emphasize important information by using phrases like "The key thing to remember is," "What's really important here is," or "I want to highlight that." This ensures crucial points stand out in spoken form.` **Organização verbal** Use pontos numerados, transições claras e resumos explícitos para melhor compreensão do ouvinte. `You are a friend. You and the user will engage in a spoken dialog exchanging the transcripts of a natural real-time conversation. When sharing multiple points, use phrases like "first," "second," and "finally" to help the listener track the information. End complex explanations with "So in summary..." to reinforce key takeaways.` **Sinalização** Inclua dicas verbais como “Deixe-me explicar três pontos principais” ou “Para resumir o que discutimos” no prompt do sistema. `You are a friend. You and the user will engage in a spoken dialog exchanging the transcripts of a natural real-time conversation. Before sharing multiple ideas, give a preview like "I'm thinking of three reasons why..." and after completing a topic, use phrases like "That covers what I wanted to share about..." to signal topic transitions.` # Adaptação do perfil do sistema **nota** Esta documentação é para o Amazon Nova versão 1. Para ver o guia de engenharia de prompts do Amazon Nova 2 Speech-to-Speech, acesse [Prompts de conversa por voz](https://docs.aws.amazon.com/nova/latest/nova2-userguide/sonic-system-prompts.html). Os modelos de texto do Amazon Nova se beneficiam de [definições claras de perfis](https://docs.aws.amazon.com/nova/latest/userguide/prompting-system-role.html). Para aplicações do Amazon Nova Sonic, considere o seguinte: + Defina perfis que soem naturais ao falar (como um “conselheiro amigável” em vez de um “sistema de recuperação de informações”). + Use descrições de perfis que enfatizem atributos de conversação (caloroso, paciente, conciso) em vez de atributos orientados por texto (detalhado, abrangente, sistemático). + Considere como a voz escolhida pode influenciar a personalidade percebida. Teste as vozes para escolher a melhor voz para seu caso de uso. Revise a seção [Diretrizes e exemplos de criação de prompts do sistema](prompting-speech-speech.md) para obter técnicas sobre como influenciar indiretamente a prosódia natural do modelo. # Cadeia de pensamento para fala **nota** Esta documentação é para o Amazon Nova versão 1. Para ver o guia de engenharia de prompts do Amazon Nova 2 Speech-to-Speech, acesse [Prompts de conversa por voz](https://docs.aws.amazon.com/nova/latest/nova2-userguide/sonic-system-prompts.html). A [técnica de raciocínio da cadeia de pensamento](https://docs.aws.amazon.com/nova/latest/userguide/prompting-chain-of-thought.html) permanece valiosa, mas requer adaptação. + Mantenha as cadeias de raciocínio mais curtas do que você faria para interações de texto. + Divida explicações complexas em partes menores de conversação. + Use sinalização verbal (ou seja, “Primeiro ponto... Segundo ponto...”) mais explicitamente do que no texto. Este exemplo mostra um prompt de cadeia de pensamento: `You are a friendly assistant. The user will give you a problem. Explain your reasoning following the guidelines given in CONSTITUTION - REASONING, and summarize your decision at the end of your response, in one sentence.` `## CONSTITUTION - REASONING ` `1. For simple questions including simple calculations or contextual tasks: Give the answer directly. No explanation is necessary, although you can offer to provide more information if the user requests it. ` `2. When faced with complex problems or decisions, think through the steps systematically before providing your answer. Break down your reasoning process when it would help user understanding.` `3. For subjective matters or comparisons: explain your thought process step-by-step.` # Integração de ferramentas externas **nota** Esta documentação é para o Amazon Nova versão 1. Para ver o guia de engenharia de prompts do Amazon Nova 2 Speech-to-Speech, acesse [Prompts de conversa por voz](https://docs.aws.amazon.com/nova/latest/nova2-userguide/sonic-system-prompts.html). Quando [você usa ferramentas externas](https://docs.aws.amazon.com/nova/latest/userguide/prompting-tools.html) com o Amazon Nova Sonic, recomendamos o seguinte: + Projete invocações de ferramentas para lidar com possíveis erros de reconhecimento automático de fala na entrada do usuário. + Considere o fato de que os usuários não podem ver as ferramentas sendo usadas. + Forneça confirmação verbal quando as ferramentas estiverem sendo consultadas. # Técnicas de prompts a evitar **nota** Esta documentação é para o Amazon Nova versão 1. Para ver o guia de engenharia de prompts do Amazon Nova 2 Speech-to-Speech, acesse [Prompts de conversa por voz](https://docs.aws.amazon.com/nova/latest/nova2-userguide/sonic-system-prompts.html). Ao criar prompts para o Amazon Nova Sonic, recomendamos que evite o seguinte: + Formatação visual, como marcadores, tabelas ou blocos de código. + Modificações nas características da voz, como sotaque, idade ou canto. + Efeitos sonoros ou onomatopeias extensas. + Conteúdo que depende de ser visto em vez de ser ouvido.