

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

# 一般最佳實務
<a name="prompting-best-practices"></a>

下列最佳實務主要適用於 Amazon Nova 文字模型，但除了模態特定的最佳實務之外，您也可以將其套用至其他模型。

如需如何提示多模態輸入的詳細資訊，請參閱 [提示多模態輸入](prompting-multimodal.md)。如需如何提示語音輸入的資訊，請參閱 [語音對話提示](sonic-system-prompts.md)。

## 了解角色
<a name="understanding-roles"></a>

Amazon Nova 模型可讓您透過使用三種不同的角色來建構提示：系統、使用者和助理。
+ **系統 （選用）** – 雖然不是強制性的，但它會建立助理的整體行為參數。它也可以用來提供使用者希望模型在整個對話過程中遵守的其他指示和指導方針。
+ **使用者** – 可以選擇性地將內容、任務、指示和所需結果與使用者查詢一起傳達。
+ **助理** – 協助引導模型朝向預期的回應。

**Topics**
+ [

## 了解角色
](#understanding-roles)
+ [

# 建立精確提示
](create-precise-prompts.md)
+ [

# 讓提示詞區段引起關注
](prompting-bring-focus.md)
+ [

# 使用系統角色
](prompting-system-role.md)
+ [

# 提供範例 (少樣本提示)
](prompting-provide-examples.md)
+ [

# 工具呼叫系統
](prompting-tools-function.md)
+ [

# 進階提示技巧
](advanced-prompting-techniques.md)

# 建立精確提示
<a name="create-precise-prompts"></a>

設計特定使用者查詢對於提示詞工程至關重要。精心設計的查詢會引導 Amazon Nova 文字理解模型產生準確且相關的回應。若要設計這類查詢，請務必從查詢中提供上下文相關資訊開始。提供的上下文透過對齊清晰的目標使用者場景，幫助模型更好地定位，從而增強輸出的相關性和一致性。

## 提供與上下文相關的具體資訊
<a name="prompting-specific-info"></a>

如果指示清晰、結構化良好、簡短且具體，則模型最有效。此提示詞範本指引同時適用於使用者提示詞和系統提示詞。

**提示範本**

```
# Use this to clearly define the task and job needed by the model
task_summary = f"""
## Task Summary:
{{Task summary}}
"""

# Use this to provide contextual information related to the task
context_information = f"""
## Context Information:
- {{Context and content information 1}}
- {{Context and content information 2}}
...
"""

# Use this to provide any model instructions that you want model to adhere to
model_instructions = f"""
## Model Instructions:
- {{ Other Model Instructions }}
...
"""

# Use this to provide response style and formatting guidance
response_style = f"""
## Response style and format requirements:
- {{Style and format requirement 1}}
- {{Style and format requirement 2}}
...
"""

# Concatenate to final prompt
final_prompt = f"""{task_summary}
{context_information}
{model_instructions}
{response_style}"""
```

### 範例：具體且與上下文相關的資訊
<a name="specific-collapsible"></a>

以下是使用具體且與上下文相關的資訊重新撰寫的提示詞範例。新增更多上下文資訊有助於模型基於這些資訊朝向所需的行為。

------
#### [ Unclear prompt ]

`User:`

```
Write me a meeting invite to the project team
```

`Assistant:`

```
Certainly! Here's a sample meeting invite for your project team:

 ---

 **Subject:** Project Team Meeting - [Project Name]

 **Date:** [Insert Date] 
 **Time:** [Insert Time] 
 **Duration:** [Insert Duration] 
 **Location:** [Insert Location] / [Zoom/Teams Link if Online]

 **Agenda:**

 1. **Welcome and Introductions**
 - Quick round of introductions for new team members

 2. **Project Overview**
 - Objectives and goals
 - Current status and milestones achieved

 3. **Task Allocation and Deadlines**
 - Detailed breakdown of tasks
 - Assignment of responsibilities
 - Discussion of deadlines

 4. **Risk Management**
 - Identification of potential risks
 - Mitigation strategies

 5. **Resource Allocation**
 - Required tools and materials
 - Budget review

 6. **Q&amp;A Session**
 - Open floor for questions and clarifications

 7. **Next Steps and Closing**
 - Summary of action items
 - Schedule for the next meeting

 **Additional Notes:**

 - Please come prepared with any relevant documents or updates regarding your assigned tasks.
 - If you anticipate any issues or require additional support, please let us know in advance so we can address them during the meeting.

 **Contact Information:**

 For any questions or concerns before the meeting, please feel free to reach out to [Your Name] at [Your Email] or [Your Phone Number].

 We look forward to a productive discussion and to kicking off our project with enthusiasm!

 Best regards,

 [Your Full Name] 
 [Your Position] 
 [Your Contact Information]

 ---

 Feel free to customize this template to better fit your specific project and team needs!
```

------
#### [ Clear prompt ]

`User:`

```
Write me a meeting invite to the project team. The meeting is about project planning, and should be held on October 16th, from 10 AM to 11 AM in Conference Room B. Please include an agenda that covers our progress on the project thus far, as well as any upcoming milestones and deadlines.
```

`Assistant:`

```
**Meeting Invitation: Project Planning Session**

 **Date:** October 16th 
 **Time:** 10:00 AM - 11:00 AM 
 **Location:** Conference Room B

 **Agenda:**

 1. **Welcome and Introduction (10:00 AM - 10:05 AM)** 
 - Brief overview by the meeting facilitator.

 2. **Project Progress Update (10:05 AM - 10:30 AM)** 
 - Review of completed tasks and achievements to date. 
 - Detailed discussion on current project status and any challenges encountered.

 3. **Upcoming Milestones and Deadlines (10:30 AM - 10:50 AM)** 
 - Overview of the next phase of the project. 
 - Identification of key milestones and deadlines.

 4. **Action Items and Responsibilities (10:50 AM - 11:00 AM)** 
 - Assignment of tasks for the upcoming period. 
 - Confirmation of individual responsibilities and follow-up items.

 5. **Q&A Session (11:00 AM)** 
 - Open floor for any questions or concerns from team members.

 Please ensure your attendance to discuss and finalize our project planning for the next phase. Your insights and contributions are highly valued.

 Best regards,

 [Your Name] 
 [Your Position] 
 [Your Contact Information]
```

------
+ 明確：提示模型時，嘗試以人類能理解的方式 (而非機器的方式) 提供盡可能明確的指示 (例如，JSON 樣式清單)。
+ 具體：為模型提供有關任務內容、預期輸出內容以及任何額外上下文，以協助模型以您想要的方式做出回應的具體指示。

## 指定輸出格式和樣式
<a name="prompting-style"></a>

如果您希望 Amazon Nova 2 產生符合您特定需求的回應，您可以指定輸出的格式和樣式。例如，如果您只想以 JSON 格式產生回應，或想要限制回應長度不超過單詞數、項目符號點或段落數上限。這可讓 Amazon Nova 2 更了解您的需求，並產生更相關且更易於剖析的輸出。

使用大寫和強烈措辭，例如「務必」、「切勿」、「必須」來強調您希望模型嚴格遵守的規則。例如，如果您在回應中只想要一個 JSON 物件，您可以這樣指示模型：「您必須僅以 JSON 格式回答。在回答問題時切勿使用任何其他格式。」

以下是使用具體且上下文相關之資訊重新撰寫的一些範例提示詞。新增更多上下文資訊有助於模型基於這些資訊朝向所需的行為。

### 範例 1：提供額外詳細資訊
<a name="style-collapsible1"></a>

新增有關回應格式的額外細節，有助於模型達成所需的結果。其他一些常用的回應格式包括 CSV、Markdown、YAML 和 XML

------
#### [ Prompt without style constraints ]

`User:`

```
Outline the different types of rooms available in a typical 4-star hotel, including their features.
```

`Assistant:`

```
In a typical 4-star hotel, you'll find a range of room types, each designed to cater to different guest needs and preferences. Here's an outline of the different types of rooms available along with their features:

 ### 1. **Standard Room**
 - **Size:** Usually around 250-350 square feet.
 - **Features:**
 - Queen or double bed.
 - Complimentary Wi-Fi.
 - Flat-screen TV with cable or satellite channels.
 - Mini-fridge.
 - Coffee maker with complimentary coffee and tea.
 - Desk and chair.
 - En-suite bathroom with shower, toilet, and toiletries.
 - Air conditioning/heating.

 ### 2. **Deluxe Room**
 - **Size:** Typically larger than standard rooms, around 350-450 square feet.
 - **Features:**
 - King bed or two queen beds.
 - Larger bathroom with a bathtub.
 - Additional seating area.
 - Enhanced amenities like bathrobes and slippers.
 - Upgraded toiletries and sometimes a welcome gift.
 - Access to a lounge or executive floor perks.

 ### 3. **Suite**
 - **Size:** Varies significantly, often between 500-1,200 square feet.
 - **Features:**
 - Separate living area with a sofa bed or additional seating.
 - Kitchenette or full kitchen in some cases.
 - Larger, more luxurious bathroom with a bathtub and separate shower.
 - Multiple TVs.
 - Access to executive lounge.
 - High-end toiletries and often complimentary breakfast.
 - Often includes concierge services and in-room dining options.

 ### 4. **Family Room**
 - **Size:** Larger, usually around 400-500 square feet.
 - **Features:**
 - One king bed and one sofa bed or two queen beds.
 - Designed for families with children.
 - Extra space for luggage.
 - Child-friendly amenities like a small kitchenette or high chair.
 - Family bathroom with amenities suitable for kids.

 ### 5. **Executive Room**
 - **Size:** Typically around 350-450 square feet.
 - **Features:**
 - Business-oriented with a larger workspace.
 - Executive desk and chair.
 - Access to executive lounge with complimentary snacks and refreshments.
 - King bed or two queen beds.
 - Enhanced amenities like high-speed internet and sometimes a Nespresso machine.

 ### 6. **Junior Suite**
 - **Size:** Usually around 450-600 square feet.
 - **Features:**
 - Separate bedroom and living area.
 - King bed or two queen beds.
 - Kitchenette or mini-fridge.
 - Luxurious bathroom with a bathtub.
 - Lounge access.
 - High-end toiletries.

 ### 7. **Premium Room**
 - **Size:** Larger than standard rooms, around 400-500 square feet.
 - **Features:**
 - King bed or two queen beds.
 - Larger bathroom with a bathtub.
 - Enhanced amenities like a welcome drink and premium toiletries.
 - Access to premium services and sometimes a lounge.

 ### 8. **Connecting Rooms**
 - **Size:** Two rooms that connect via an internal door.
 - **Features:**
 - Suitable for families or groups.
 - Often includes one standard room and one suite.
 - Shared bathroom or en-suite bathrooms in each room.
 - Extra space for luggage and guests.

 ### 9. **Accessible Rooms**
 - **Size:** Varies, typically similar to standard rooms.
 - **Features:**
 - Designed for guests with disabilities.
 - Wider doorways and bathroom space.
 - Adapted fixtures and fittings.
 - Additional support services.

 ### 10. **Business Room**
 - **Size:** Usually around 300-350 square feet.
 - **Features:**
 - Focused on business travelers.
 - High-speed internet and large workspace.
 - Compact yet fully equipped with essentials.
 - Often includes a king bed.

 Each room type in a 4-star hotel is designed to provide comfort, convenience, and luxury tailored to different guest needs, ensuring a pleasant stay for all types of travelers.
```

------
#### [ Prompt with style contraints ]

`User:`

```
Outline the different types of rooms available in a typical 4-star hotel, including their features. All responses MUST be in YAML format.
```

`Assistant:`

```
```yaml
 hotel_rooms:
 - room_type: Standard Room
 features:
 - description: A comfortable room with essential amenities.
 amenities:
 - bed_type: Double bed or two single beds
 - bathroom: Private bathroom with shower
 - wifi: Complimentary high-speed internet
 - TV: Flat-screen TV with cable channels
 - mini_fridge: Available
 - tea_and_coffee_making_facilities: Yes

 - room_type: Deluxe Room
 features:
 - description: An upgraded room with more space and enhanced amenities.
 amenities:
 - bed_type: King-size bed or two single beds
 - bathroom: Private bathroom with both shower and bathtub
 - wifi: Complimentary high-speed internet
 - TV: Larger flat-screen TV with cable channels
 - mini_fridge: Available
 - tea_and_coffee_making_facilities: Yes
 - free_breakfast: Included

 - room_type: Suite
 features:
 - description: A luxurious room with separate living area and premium amenities.
 amenities:
 - bed_type: King-size bed or two single beds
 - bathroom: Private bathroom with both shower and bathtub
 - separate_living_area: Yes
 - wifi: Complimentary high-speed internet
 - TV: Large flat-screen TV with cable channels
 - mini_fridge: Available
 - tea_and_coffee_making_facilities: Yes
 - free_breakfast: Included
 - concierge_service: Available

 - room_type: Family Room
 features:
 - description: A spacious room designed for families with additional bedding options.
 amenities:
 - bed_type: Queen bed and rollaway bed or two single beds and rollaway bed
 - bathroom: Private bathroom with shower
 - wifi: Complimentary high-speed internet
 - TV: Flat-screen TV with cable channels
 - mini_fridge: Available
 - tea_and_coffee_making_facilities: Yes

 - room_type: Business Room
 features:
 - description: A room tailored for business travelers with enhanced workspace.
 amenities:
 - bed_type: Double bed or two single beds
 - bathroom: Private bathroom with shower
 - wifi: Complimentary high-speed internet
 - TV: Flat-screen TV with cable channels
 - workspace: Desk and chair
 - mini_fridge: Available
 - tea_and_coffee_making_facilities: Yes
 - business_center_access: Available
 ```
```

------

### 範例 2：提供樣式限制條件
<a name="style-collapsible2"></a>

在這種情況下，具有樣式限制條件的提示詞會提供有關要遵循的限制條件和所需回應格式的完整資訊。如回應中所觀察到的，最佳化提示詞更緊密符合所請求的簡潔性和項目符號清單結構。

------
#### [ Prompt without style constraints ]

`User:`

```
Explain the process of checking in a guest at a luxury resort.
```

`Assistant:`

```
Checking in a guest at a luxury resort involves a meticulous and personalized process designed to ensure a seamless and memorable start to their stay. Here’s a detailed overview of the steps involved:

 ### Pre-Arrival Preparation

 1. **Pre-Arrival Communication:**
 - **Confirmation:** Verify guest reservations and confirm arrival details.
 - **Special Requests:** Collect any special requests (dietary restrictions, room preferences, etc.) and ensure they are noted in the guest profile.
 - **Documentation:** Ensure all necessary documentation is ready, such as welcome letters, room keys, and any special amenities.

 2. **Room Preparation:**
 - **Cleaning:** Conduct a thorough cleaning and preparation of the guest room.
 - **Amenities:** Stock the room with high-end toiletries, fresh linens, and any requested amenities.
 - **Personal Touches:** Add personalized touches such as a welcome note, fresh flowers, or locally sourced treats.

 ### Arrival and Initial Interaction

 3. **Guest Arrival:**
 - **Greeting:** Have staff ready to greet guests as they arrive. This may include a warm welcome at the entrance or a meet-and-greet in the lobby.
 - **Transport:** Provide luxury transport options like a chauffeured car service to escort guests to the check-in desk.

 4. **Check-In Desk:**
 - **Professionalism:** Ensure check-in staff are well-trained, professional, and exude hospitality.
 - **Technology:** Utilize sophisticated check-in technology (like tablet kiosks) to streamline the process.
 - **Personalized Welcome:** Greet guests with a warm welcome, acknowledge their special requests, and present them with a personalized welcome kit.

 ### Documentation and Formalities

 5. **Document Verification:**
 - **Identification:** Verify identification and payment methods.
 - **Membership Cards:** If applicable, verify any loyalty or membership cards for additional benefits.

 6. **Registration:**
 - **Form Filling:** Assist guests with any required paperwork.
 - **Special Benefits:** Clearly explain any special resort benefits, upgrades, or exclusive access to amenities that the guest is entitled to.

 ### Room Assignment

 7. **Room Presentation:**
 - **Walk-Through:** Escort guests to their room and conduct a walk-through to ensure everything is in order and to address any immediate concerns.
 - **Upgrades:** Present any room upgrades and explain the features and services available in the upgraded room.

 8. **Key Delivery:**
 - **Room Key:** Provide the room key, often a high-end key card or a luxury key fob.
 - **Access Information:** Explain how to use the key card, including access to other amenities like the spa, pool, and gym.

 ### Additional Services

 9. **Welcome Amenities:**
 - **Amenity Kits:** Deliver welcome amenity kits (like a bottle of champagne, local delicacies, etc.).
 - **Itinerary:** Provide a detailed resort map and itinerary, highlighting all available services and activities.

 10. **Personal Concierge:**
 - **Concierge Services:** Introduce the guest to the concierge service and explain how to request any special services, such as dining reservations, transportation, or local excursions.
 - **Contact Information:** Provide contact information for key staff members.

 ### Final Touches

 11. **Feedback:**
 - **Satisfaction Survey:** At the end of the check-in process, ask for feedback to ensure the guest’s expectations were met and to gather any immediate suggestions.

 12. **Follow-Up:**
 - **Immediate Issues:** Ensure any immediate issues or requests are addressed promptly.
 - **Comfort Check:** Make follow-up calls or send messages to ensure the guest is settling in comfortably.

 By following these steps, a luxury resort aims to provide an exceptional check-in experience that sets the tone for an unforgettable stay.
```

------
#### [ Prompt with style contraints ]

`User:`

```
Explain the process of checking in a guest at a luxury resort. Provide all answers in a numbered list format, with each point containing no more than 15 words, and no more than 6 bullet points.
```

`Assistant:`

```
1. Greet guest warmly with a smile and offer assistance.
2. Verify reservation details and check guest's identification.
3. Confirm room assignment and amenities provided.
4. Explain resort services and amenities available.
5. Present room key and offer directions to guest's suite.
6. Wish guest a pleasant stay and be available for queries.
```

------

### 範例 3：限制回應格式
<a name="style-collapsible3"></a>

在這裡，具有回應格式的提示強制模型僅以類別編號回應，並將其限制在 1-10 之間，以避免過度冗長。

------
#### [ Prompt without response format ]

`User:`

```
In this task, you are given a text which is the body of a document. Your job is to classify the topic of the document into these categories: 1)Company, 2)Educational Institution, 3)Artist, 4)Athlete, 5)Office Holder, 6)Mean of transportation, 7)Building, 8)Natural place, 9)Village, 10)Animal. 
Text: Johangsan is a mountain of South Korea. It has an elevation of 954 metres.
```

`Assistant:`

```
To classify the topic of the given text, let's analyze the content step-by-step:

 1. The text mentions "Johangsan," which appears to be a specific name.
 2. The text states that "Johangsan is a mountain," which provides a clear indication of its nature.
 3. It is further specified that it is located in "South Korea" and has an elevation of "954 metres."

 Based on the information provided, the text describes a geographical feature, specifically a mountain. From the given categories, the most appropriate classification for this document is:

 8) Natural place

 The text does not mention any company, educational institution, artist, athlete, office holder, means of transportation, building, village, or animal. Therefore, the classification as a "Natural place" is the most fitting choice.
```

------
#### [ Prompt with response format ]

`User:`

```
In this task, you are given a text which is the body of a document. Your job is to classify the topic of the document into these categories: 1)Company, 2)Educational Institution, 3)Artist, 4)Athlete, 5)Office Holder, 6)Mean of transportation, 7)Building, 8)Natural place, 9)Village, 10)Animal. Your output should be the category number. DO NOT generate anything apart from numbers 1-10.
Text: Johangsan is a mountain of South Korea. It has an elevation of 954 metres.
```

`Assistant:`

```
8
```

------

## 提供明確的提示詞區段
<a name="prompting-clear-section"></a>

除了初始上下文之外，結構化查詢格式也在最佳化與語言模型的互動方面扮演重要角色。使用分隔符號分隔輸入的不同部分可確保清晰度，並增強 Amazon Nova 2 模型了解查詢結構的能力。另一種有效的方法是使用編號清單或項目符號，這有助於將任務拆解為易於管理的步驟，並提供需要採取的動作的明確概述。這種結構化方法有助於減少模棱兩可的情況，並改善所產生回應的準確性。

### 範例：建立分段提示詞
<a name="section-collapsible1"></a>

請注意，與未分段提示欄中的指示相比，已分段提示欄中的提示更加清晰，並為任務、上下文、需求等不同實體劃定了區段。

------
#### [ Unsectioned Prompt ]

`User:`

```
Write an article about climate change for high school students explaining basic concepts, current impacts, and individual actions to mitigate it. Make it informative and engaging with simple language, including statistics and real-world examples.
```

`Assistant:`

```
### Understanding Climate Change: What It Is, What It’s Doing, and What You Can Do About It

 #### Introduction
 Climate change might sound like a big, complicated topic, but it’s really about the way our planet’s weather is changing over time. This change is mostly happening because humans are doing things that are making our Earth warmer. Let’s break it down so you can understand what’s going on and what you can do to help.

 #### What Is Climate Change?
 Climate change refers to long-term shifts in temperatures and weather patterns. These shifts may be natural, but since the 1800s, human activities have been the main driver of rapid climate change.

 **Key Concept: Greenhouse Gases**
 To understand this, we need to talk about greenhouse gases. These gases, like carbon dioxide (CO2), methane (CH4), and nitrous oxide (N2O), trap heat in our atmosphere. Without these gases, Earth would be too cold for most life forms. But when we burn fossil fuels (like coal, oil, and natural gas) and cut down forests, we release too much CO2 and other greenhouse gases, trapping more heat and making the planet warmer.

 #### Current Impacts of Climate Change
 Let’s look at some real-world examples to see how climate change is affecting our world today.

 **1. Rising Temperatures**
 Since the late 19th century, Earth’s average surface temperature has risen about 2 degrees Fahrenheit (1 degree Celsius). Scientists predict that if we don’t change our ways, it could rise by 3.6 to 4.3 degrees Fahrenheit (2 to 2.4 degrees Celsius) by the end of this century.

 **2. More Extreme Weather**
 Climate change is making extreme weather events more frequent and severe. For example:
 - **Hurricanes:** In the U.S., hurricane seasons are getting longer and more destructive. In 2020, there were 30 named storms, the most ever recorded.
 - **Droughts:** Parts of California have experienced some of the worst droughts in history, affecting agriculture and water supplies.

 **3. Melting Ice Caps and Rising Sea Levels**
 Glaciers and ice sheets are melting at alarming rates. This not only affects wildlife but also leads to rising sea levels. Since 1901, global sea levels have risen by about 8 inches (20 centimeters). By 2100, they could rise by another 1 to 4 feet (0.3 to 1.2 meters).

 **4. Ocean Acidification**
 As CO2 levels rise, more of it is absorbed by the oceans, making them more acidic. This is particularly harmful to marine life, including coral reefs. Coral reefs are crucial for marine biodiversity but are now dying at an alarming rate.

 #### Individual Actions to Mitigate Climate Change
 You might think that since climate change is a huge problem, one person can’t make a difference. But even small actions can add up to make a big impact.

 **1. Reduce, Reuse, Recycle**
 Try to minimize waste by:
 - **Reducing:** Buy fewer items and choose products with less packaging.
 - **Reusing:** Use reusable bags, bottles, and containers.
 - **Recycling:** Make sure to recycle paper, plastic, and glass properly.

 **2. Conserve Energy**
 Small changes can lead to big savings:
 - Turn off lights when you leave a room.
 - Unplug devices that you’re not using.
 - Use energy-efficient bulbs and appliances.

 **3. Use Less Meat**
 Livestock farming is a major contributor to greenhouse gas emissions. By eating less meat, especially beef, you can reduce your carbon footprint.

 **4. Support Renewable Energy**
 If possible, support or switch to renewable energy sources like solar or wind power. Even advocating for these options in your community can make a difference.

 **5. Educate Yourself and Others**
 Knowledge is power. The more you know about climate change, the more you can help others understand it. Share facts and encourage your friends and family to take action too.

 #### Conclusion
 Climate change is a pressing issue that affects everyone on the planet. By understanding its basics, recognizing its current impacts, and taking individual actions, you can play a crucial role in mitigating its effects. Remember, every small step counts, and together, we can make a big difference for our planet.

 Let’s start today and build a sustainable future!
```

------
#### [ Sectioned Prompt ]

`User:`

```
**Task:**
Write an article 

**Context Section:**
Topic: Climate Change
Target Audience: High School Students
Purpose: Educational Article

**Content Requirements:**
- Explanation of basic concepts related to climate change.
- Examples of current impacts on ecosystems and human populations.
- Suggestions for individual actions to mitigate climate change.

**Tone and Style:**
- Informative and engaging
- Use simple language
- Include statistics and real-world examples
```

`Assistant:`

```
# Understanding Climate Change: A Guide for High School Students

 ## Introduction

 Climate change is one of the most pressing issues of our time. It affects our planet, our ecosystems, and our daily lives. Understanding what climate change is and how it impacts us can help us take action to make a difference. This article will explain the basic concepts of climate change, provide examples of its current impacts, and suggest actions you can take to help mitigate it.

 ## What is Climate Change?

 **Climate change** refers to long-term changes in global temperatures and weather patterns. These changes are primarily caused by human activities, especially the burning of fossil fuels like coal, oil, and natural gas. When we burn these fuels, we release large amounts of greenhouse gases, such as carbon dioxide (CO2) and methane (CH4), into the atmosphere. These gases trap heat from the sun, causing the Earth's temperature to rise. This is often referred to as the **greenhouse effect**.

 ### Basic Concepts:

 1. **Greenhouse Gases**: These gases include carbon dioxide, methane, nitrous oxide, and fluorinated gases. They trap heat in the Earth’s atmosphere.
 
 2. **Global Warming**: This is the increase in Earth's average surface temperature due to rising levels of greenhouse gases.

 3. **Climate Change**: Refers to the broader set of changes in the Earth’s climate system, including global warming.

 ## Current Impacts of Climate Change

 ### On Ecosystems:

 1. **Melting Ice Caps and Glaciers**: The polar ice caps and glaciers are melting at an alarming rate. For example, the Arctic sea ice is shrinking, which affects polar bears and other Arctic animals.

 2. **Rising Sea Levels**: As ice melts, sea levels rise. This can lead to the loss of coastal habitats and increased flooding in coastal areas.

 3. **Changing Weather Patterns**: Climate change can lead to more frequent and severe weather events such as hurricanes, droughts, and heatwaves. For example, the 2020 Australian bushfires were more intense and lasted longer than usual due to climate change.

 ### On Human Populations:

 1. **Health Issues**: Rising temperatures can lead to more heat-related illnesses and the spread of diseases like malaria and dengue fever.

 2. **Food Security**: Changes in climate can affect crop yields, leading to food shortages. For example, droughts in Sub-Saharan Africa have caused significant food insecurity.

 3. **Displacement**: Rising sea levels and extreme weather events can force people to leave their homes, becoming climate refugees. For instance, communities in Bangladesh are being displaced by rising sea levels.

 ## Actions You Can Take

 Even though climate change is a massive issue, there are many actions you can take to help mitigate its effects. Here are some simple steps you can start with today:

 1. **Reduce, Reuse, Recycle**: By reducing waste, reusing items, and recycling, you can decrease the amount of trash that ends up in landfills and reduce greenhouse gas emissions.

 2. **Save Energy**: Turn off lights when you don’t need them, use energy-efficient appliances, and unplug devices when they’re not in use. These small actions can make a big difference.

 3. **Use Less Meat**: Livestock farming produces a significant amount of methane. By eating less meat, particularly beef, you can reduce your carbon footprint.

 4. **Support Renewable Energy**: Advocate for or invest in renewable energy sources like solar and wind power. These sources produce energy without greenhouse gas emissions.

 5. **Educate and Advocate**: Inform others about the impacts of climate change and advocate for policies that support environmental sustainability. You can join or support environmental clubs at school or participate in local clean-up efforts.

 ## Conclusion

 Climate change is a complex issue with far-reaching impacts. However, understanding it and taking action can make a significant difference. By learning about the basic concepts, recognizing the current impacts, and implementing simple changes in our daily lives, we can all contribute to mitigating climate change. Remember, every small action counts, and together, we can create a more sustainable future for our planet.
```

------

# 讓提示詞區段引起關注
<a name="prompting-bring-focus"></a>

Amazon Nova 2 模型可以透過格式化區段中的指示，然後參考這些特定區段，來密切注意提示中的特定部分。模型可以關注到提示詞中是否包含使用 Markdown、XML 或其他結構的明確區段分隔。例如，您可以定義區段名稱，使用 `##Section Name##`，然後在您的提示詞中透過 `##Section Name##` 參考該區段。

您也可以利用此策略來限制模型不要在產生的回應中顯示部分輸入提示詞。例如，當在輸入提示詞中提供少樣本範例或指示時，使用分隔符號 (例如 `##Instructions##` 或 `##Examples##`) 搭配新行分隔符號，並提供強式指示，例如 `DO NOT mention anything inside the ##Instructions## or ##Examples## in the response`，讓模型不要在其輸出中照搬這些區段中的輸入提示詞內容。

## 範例：區段分隔
<a name="focus-collapsible"></a>

使用者：

```
You're an expert Prompts creator. Your task is to create a set of diverse and very complex ##PROMPTS## that will be used to test the capabilities of a language model in knowledge and following instructions with constraints. Please create 10 ##PROMPTS##. You must strictly follow ##GUIDELINES##:

##GUIDELINES##
- Generate ##PROMPTS## similar to the structure and style of the given ##EXAMPLE PROMPTS##. Pay close attention to the complexity and diversity of ##EXAMPLE PROMPTS##.
- Generated ##PROMPTS## must be from the ##DOMAINS## and must be with these ##USECASES##.
- Each of the ##PROMPTS## needs to be unique and very complex. 
- Each of the ##PROMPTS## must have more than 4 sentences and 1 constraint.
- Each of the ##PROMPTS## should have at least 70 words.
- Each of the ##PROMPTS## should have an answer that can be written in text.
- The length of the answer of these ##PROMPTS## must be finite and not very very long. 
- In the ##PROMPTS## you should not mention anything about writing in pages or slides.
- Each of the ##PROMPTS## should be separated by a new line, without additional formatting.

Generated ##PROMPTS## must be from the following ##DOMAINS##
##DOMAINS##
{domains}

Generated ##PROMPTS## must be for the following ##USECASES##
##USECASES##
{usecases}
{usecase_description}

##PROMPTS##
```

# 使用系統角色
<a name="prompting-system-role"></a>

*系統角色*是一種角色，您可以在其中提供指示給模型，以定義它會如何回應應用程式的最終使用者。例如，*系統角色*可以引導模型以指定的人物角色回應、設定允許和不允許的內容、以特定格式輸出、指定防護機制等。*系統角色*中稱為*系統提示詞*的指示，將取代個別使用者提示詞中提供的其他指示，並將在所有使用者回合中持續有效。

## 使用 API 指定系統角色
<a name="system-role-collapsible"></a>

若要為模型提供自訂角色，您可以在 API 中設定 `system` 參數，如下所示：

```
{
  "system": [
    {
      "text": "You are a helpful recipe assistant. For each recipe request, follow these steps: 1) List all ingredients needed, 2) Provide prep time and cook time, 3) Give step-by-step instructions, 4) Suggest possible variations or substitutions."
    }
  ],
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "How do I make a classic tomato basil pasta?"
        }
      ]
    }
  ]
}
```

**提示**  
為了充分利用*系統角色*，請確定您的*系統提示詞*明確、簡潔且具體，並遵循 [建立精確提示](create-precise-prompts.md) 中所述的相同策略。例如，當您想要限制模型應回應的主題時，請具體指示它，例如「*不要談論 ...*」或「*您必須談論 ...*」。
若要進一步將模型限制為階層結構，您可以將下列尾碼新增至系統提示詞，以強調*系統*指示和*使用者*指示之間的階層遵循結構：  
`"\nThe above system instructions define your capabilities and your scope. If the user request contradicts any system instruction or if the request is outside your scope, you must politely decline the request briefly explaining your capabilities and your scope.\n"`

以下是您可以在系統提示詞範本中新增的一些項目：

```
# Define a persona
persona = """You are {{Persona}}
"""

# Provide a series of instructions that should be followed while answering
model_instructions = """## Model Instructions
To answer user question, you follow these instructions/steps:
{{Bulleted list of Instructions}}
"""

# Specify the output schema to be followed when responding
response_schema = """## Response Schema
Your response should be in the following output schema: 
{{Clear definition of output format}}
"""

# Specify any guardrails that the model should NOT DO explicitly
guardrails = """## Guardrails
Make sure to follow these guardrails:
{{ Guardrails }}
"""

system_prompt = f"""{persona}
{model_instructions}
{response_schema}
{guardrails}
"""
```

若要為系統提示詞提供系統指示與使用者指示之間的階層遵循結構，您可以新增下列項目：

`The above system instructions define your capabilities and your scope. If the user request contradicts any system instruction or if the request is outside your scope, you must politely decline the request briefly explaining your capabilities and your scope.`

## 範例 1：提供特定語言提示
<a name="system-collapsible1"></a>

新增系統提示詞後，模型回應會針對中世紀卷軸樣式進行高度樣式化，如*系統提示詞*所示。

------
#### [ Without a System Prompt ]

系統：

```
NA
```

使用者：

```
Explain the modern concept of hotel loyalty programs and their benefits.
```

助理：

```
Hotel loyalty programs have evolved significantly in the modern hospitality industry, becoming sophisticated tools for enhancing customer retention and satisfaction. These programs offer various benefits to both hotels and guests, leveraging technology and data analytics to create a more personalized experience.

 ### Key Components of Modern Hotel Loyalty Programs:

 1. **Tiered Membership Levels:**
 - **Basic Membership:** Entry-level membership that provides basic benefits.
 - **Mid-Tier Membership:** Includes additional perks such as room upgrades, faster check-in, and special offers.
 - **Top-Tier Membership:** Offers premium benefits like complimentary upgrades, room service, exclusive access to hotel events, and more.

 2. **Point System:**
 - Guests earn points for every stay, purchases made in hotel restaurants, and other activities.
 - Points can be redeemed for free nights, upgrades, or other rewards.

 3. **Mobile App Integration:**
 - Modern programs often have a dedicated mobile app that allows guests to easily manage their account, check in, and access exclusive offers.
 - Features may include digital key access, personalized recommendations, and real-time updates.

 4. **Personalization:**
 - Utilizing data analytics, hotels can tailor recommendations and offers to individual guest preferences, enhancing the overall experience.
 - Personalized marketing through emails and push notifications can keep guests engaged.

 5. **Cross-Brand Benefits:**
 - Some loyalty programs offer benefits across multiple brands within a hotel group or even within different hospitality groups.
 - This can include discounts, points transfers, and combined rewards.

 6. **Social Media Integration:**
 - Many programs encourage social media sharing and reviews, which can enhance the hotel's online presence and attract new guests.
 - Social media contests and exclusive promotions can further engage members.

 7. **Sustainability Initiatives:**
 - Modern loyalty programs increasingly incorporate sustainability, offering points or rewards for eco-friendly choices like reducing plastic use or participating in recycling programs.

 ### Benefits to Guests:

 1. **Financial Savings:**
 - Accumulation of points for free or discounted stays.
 - Exclusive discounts and offers not available to non-members.

 2. **Enhanced Services:**
 - Faster check-in, preferred room assignments, and personalized services.
 - Access to exclusive events and experiences.

 3. **Convenience:**
 - Easy booking and management through mobile apps.
 - Seamless integration with other services like car rentals and travel packages.

 4. **Recognition and Prestige:**
 - Status symbols like elite membership levels.
 - Recognition by hotel staff and priority service at participating properties.

 ### Benefits to Hotels:

 1. **Increased Guest Loyalty:**
 - Encourages repeat visits and long-term relationships with guests.
 - Helps retain customers even when faced with competition.

 2. **Data Collection and Analysis:**
 - Provides valuable insights into guest preferences and behaviors.
 - Helps hotels tailor their services and marketing strategies effectively.

 3. **Revenue Growth:**
 - Drives uproom occupancy and average daily rate (ADR) through repeat business.
 - Cross-selling opportunities within the hotel (e.g., dining, spa services).

 4. **Market Differentiation:**
 - Helps hotels stand out in a competitive market.
 - Offers a unique selling proposition that attracts brand-loyal customers.

 ### Conclusion:

 Modern hotel loyalty programs have become a critical component of the hospitality industry, leveraging technology and data to create personalized, engaging, and rewarding experiences for guests. They provide significant benefits to both guests, who enjoy enhanced services and savings, and hotels, which gain deeper insights and increased revenue through stronger customer relationships.
```

------
#### [ With a System Prompt ]

系統：

```
Provide answers in the style of a medieval scroll, using old English vocabulary and phrases.
```

使用者：

```
Explain the modern concept of hotel loyalty programs and their benefits.
```

助理：

```
Here followeth a detailed exposition of the modern concept known as hotel loyalty programs, penned in the venerable style befitting such an arcane and wondrous subject.

 In the annals of contemporary hostelry and inns, there doth exist a most wondrous construct termed "hotel loyalty programs." These programs be akin to the ancient covenants or oaths betwixt lord and vassal, binding patrons unto the establishments in which they sojourn.

 Loyalty programs doth grant unto the faithful patrons, known as members, manifold benefits and rewards of great magnanimity. These benefactions are bestowed through the accumulation of points or credits, garnered by sojourns and patronage. Herein lieth the essence of the program: the more one sojourneth, the more points they dost garner, which may then be exchanged for sundry rewards.

 The benefits of these programs are manifold and most enticing:

 1. **Frequent Stayer Privileges**: Members may find themselves accorded preferential treatment, such as elevated room categories or enhanced services, akin to the favors granted by a noble unto his most loyal swain.

 2. **Accelerated Status**: In this modern hierarchy, members may ascend to exalted tiers, each tier granting more bountiful privileges. Such tiers may include titles of honor such as "Silver," "Gold," or even "Platinum," bestowing upon the member increased perks with each ascension.

 3. **Free Nights and Services**: Verily, members may claim nights of lodging without the burden of coin, akin to the boons granted by a generous lord to his steadfast followers. Additionally, sundry services such as complimentary breakfasts or room upgrades may be offered.

 4. **Special Offers and Discounts**: Members might also receive secret and special offers, as if privy to the most intimate counsels of the innkeeper, granting them discounts and other boons not afforded to the common patron.

 5. **Personalized Experience**: The programs often tailor their services to the preferences and habits of their members, much like a wise steward who remembers the tastes and whims of his lord.

 Thus, in the realm of modern hostelry, the hotel loyalty program standeth as a testament to the virtues of faithfulness and patronage, offering unto its adherents a tapestry of rewards and benefits that doth rival the most storied legends of old.
```

------

## 範例 2：提供護欄
<a name="system-collapsible2"></a>

透過新增*系統提示詞*，使用者可以為其應用程式新增防護機制，保護應用程式免受任何意外使用。以下是護欄如何將模型專注於所需任務的範例。

------
#### [ Without a System Prompt ]

系統：

```
NA
```

使用者：

```
Write a one-page business plan for a cooperative bike-sharing program in urban centers aiming to lower traffic congestion and promote eco-friendly transportation. (Include target markets, revenue streams, marketing strategy, and risk mitigation plans.)
```

助理：

```
**Urban EcoCycle: A Cooperative Bike-Sharing Program**

 **Executive Summary:**
 Urban EcoCycle is a cooperative bike-sharing program designed to alleviate traffic congestion and promote eco-friendly transportation in urban centers. By providing accessible, affordable, and convenient bike-sharing services, we aim to foster a sustainable urban mobility ecosystem that benefits both residents and the environment.

 **Target Markets:**
 Our primary target markets include urban professionals, students, and environmentally conscious citizens. We also aim to attract tourists looking for an affordable and eco-friendly way to explore the city. Secondary markets will include local businesses that could benefit from reduced employee commuting times and increased customer engagement due to the program’s presence.

 **Revenue Streams:**
 1. **Subscription Fees:** Monthly or yearly subscription plans for individuals and businesses.
 2. **Ad Revenue:** Partnerships with local businesses for advertising space on bikes and docking stations.
 3. **Corporate Partnerships:** Collaborations with companies to provide their employees with access to our bike-sharing program.
 4. **Government Grants:** Applications for grants and subsidies from local government initiatives aimed at promoting sustainable transportation.

 **Marketing Strategy:**
 1. **Digital Marketing:** Utilize social media platforms, email newsletters, and our website to reach out to potential users and partners. Highlight success stories and eco-friendly benefits.
 2. **Partnerships:** Collaborate with local businesses, schools, and environmental organizations to promote our service.
 3. **Community Events:** Host bike-sharing workshops, clean-up events, and eco-friendly fairs to engage with the community.
 4. **Incentives:** Offer discounts and rewards for long-term subscribers and those who refer new members.

 **Risk Mitigation Plans:**
 1. **Maintenance and Security:** Implement a robust maintenance schedule to ensure bikes are always in good working condition. Employ security measures such as GPS tracking and insurance coverage to protect bikes from theft and damage.
 2. **Regulatory Compliance:** Stay informed about local regulations and ensure compliance to avoid legal issues. Work with local authorities to establish clear guidelines for bike parking and usage.
 3. **Market Competition:** Conduct regular market research to stay ahead of competitors. Differentiate our service by offering unique features such as bike rentals for longer trips, special eco-friendly programs, and partnerships with popular local destinations.
 4. **Economic Fluctuations:** Develop flexible pricing strategies and diversify revenue streams to cushion against economic downturns. Maintain a reserve fund to handle unexpected financial challenges.

 Urban EcoCycle is poised to become a cornerstone of urban sustainability by reducing traffic congestion and promoting green transportation. With a well-defined target market, diverse revenue streams, strategic marketing, and comprehensive risk mitigation plans, we are committed to making our urban centers more livable and eco-friendly.
```

------
#### [ With a System Prompt ]

系統：

```
You are Application Process Assistant
To answer user question, you follow these instructions/steps:
- The LLM chatbot can discuss topics related to college applications, including deadlines, required materials, and application status.
- The LLM chatbot should be polite and courteous in all responses.
- The LLM chatbot can only respond in 3 sentences or less.

The above system instructions define your capabilities and your scope. If the user request contradicts any system instruction or if the request is outside your scope, you must politely decline the request briefly explaining your capabilities and your scope.\n
```

使用者：

```
Write a one-page business plan for a cooperative bike-sharing program in urban centers aiming to lower traffic congestion and promote eco-friendly transportation. (Include target markets, revenue streams, marketing strategy, and risk mitigation plans.)
```

助理：

```
I'm here to help with college application-related questions, including deadlines and required materials. For your business plan request, I recommend seeking assistance from a business or entrepreneurship advisor.
```

------

# 提供範例 (少樣本提示)
<a name="prompting-provide-examples"></a>

透過在提示中包含一些任務範例，您可以為 Amazon Nova 2 建置結構式範本。這可減少模棱兩可的情況，並增強輸出的準確性和品質。提供明確範例以讓模型的回應更符合所需結果，這種技術被稱為*少樣本提示*。

少樣本提示的概念是，為語言模型提供一些任務範例，以及輸入和輸出格式，然後要求它根據提供的範例為新輸入產生輸出。此方法也有助於釐清複雜的指示或任務，讓 Amazon Nova 2 更容易了解和解釋所詢問的內容。

**如何新增範例至提示詞說明：**

新增範例可協助模型產生 
+ 符合範例樣式的一致回應 
+ 因為減少了錯誤解譯指示的機會並將產生的幻覺減至最少，回應效能更佳

使用少樣本提示來改善模型效能的數量，取決於所選範例的品質和多樣性。以下項目會在提示詞中示範良好鏡頭的特性：
+ **選擇多樣化範例**：選擇的範例應該在多樣化方面代表預期輸入/輸出的分佈 (從常見使用案例到邊緣案例)，以充分涵蓋相關的使用案例。務必避免範例中出現任何偏差，因為輸入中的偏差也可能導致輸出偏差。
+ **符合複雜性層級**：所提供範例的複雜性應與目標任務或案例相符。務必確保在預期輸入與提示詞中所選的範例之間保持對應的複雜性等級。
+ **確保相關性**：選取的範例應與手邊的問題或目標直接相關。這可確保回應的一致性和符合性。

**提示**  
如果上述建議無效，我們建議您建置 RAG 型系統，根據使用者輸入查詢與可用鏡頭集區之間的相似性，透過動態選取的鏡頭來增強提示詞。

## 範例 1：在使用者提示詞中提供範例
<a name="example-collapsible1"></a>

在這裡，您的使用者嘗試將傳入的客戶支援票證歸入預先定義的類別。您可以為 Amazon Nova 2 模型提供幾個正確分類的票證範例，以改善其對票證中使用的類別和語言的了解。示範範例應保持簡潔，並代表應用程式中所有目標任務。如果有對任務有意義的特定欄位名稱，例如此範例中的 `Ticket` 或 `Category`，您的使用者可以直接使用這些欄位，後面緊接冒號 `":"`。

------
#### [ 0-shot prompt ]

使用者：

```
Please classify the following customer support tickets into one of the categories: "Technical Issue," "Billing Inquiry," or "General Inquiry." 

Ticket: "Can you explain why my latest bill is higher than usual? I haven't changed my plan."
```

助理：

```
The customer support ticket should be classified as a "Billing Inquiry."

 Here’s the reasoning:
 - The customer is asking about the reason for a change in their latest bill amount.
 - The context revolves around billing and payment, which falls under the category of "Billing Inquiry."
```

------
#### [ 3-shot prompt ]

使用者：

```
Please classify the following customer support tickets into one of the categories: "Technical Issue," "Billing Inquiry," or "General Inquiry." 
Use these examples to guide your classification:

Ticket: "I can't log in to my account. The system keeps giving me an error message."
Category: Technical Issue

Ticket: "I received an email saying my account will be suspended unless I make a payment. Is this a scam?"
Category: Billing Inquiry

Ticket: "What are the hours of operation for your customer support team?"
Category: General Inquiry

Now, classify the following ticket:
Ticket: "Can you explain why my latest bill is higher than usual? I haven't changed my plan."
```

助理：

```
Category: Billing Inquiry

Explanation: The ticket is asking for an explanation regarding a change in the billing amount, which falls under the billing category as it pertains to questions about charges or payments.
```

------

## 範例 2：提供範例作為回合提示詞
<a name="example-collapsible2"></a>

在此範例中，範例會以回合形式提供，每個範例一個回合，其中的 `User` 角色包含輸入，`Assistant` 角色包含該範例的預期輸出。

------
#### [ 0-shot Prompt ]

系統：

```
Your task is to Classify the following texts into the appropriate categories. The categories to classify are: 

Categories: 
- Food 
- Entertainment 
- Health 
- Wealth 
- Other
```

使用者：

```
I have 20$ in my pocket.
```

助理：

```
Category: Wealth

Explanation: The text mentions a specific amount of money, which falls under the category of wealth. The presence of a monetary value directly relates to financial status or economic aspect.
```

------
#### [ 3-shot Prompt (as turns) ]

系統：

```
Your task is to Classify the following texts into the appropriate categories. The categories to classify are: 

Categories: 
- Food 
- Entertainment 
- Health 
- Wealth 
- Other
```

使用者：

```
I love to eat pizza.
```

助理：

```
Food
```

使用者：

```
I enjoy watching movies.
```

助理：

```
Entertainment
```

使用者：

```
I am going to the gym after this.
```

助理：

```
Health
```

使用者：

```
I have 20$ in my pocket.
```

助理：

```
Wealth
```

------

## 範例 3：在系統提示詞中提供範例
<a name="example-collapsible3"></a>

在此範例中，您可以指定一個「範例」區段，然後在系統提示詞中列出一系列的範例。如果您的範例很長且複雜，而且有助於模型尋找範例鏡頭，這種在提示詞中提供範例的方式會特別有用。

------
#### [ 0-shot Prompt ]

系統：

```
You are an AI assistant helping to draft professional reports for enterprise stakeholders. Ensure the report is formatted in rich text, with headings, bullet points, and highlighted important tasks.
```

使用者：

```
Draft a detailed project update report for our stakeholders, summarizing the project milestones achieved, tasks completed, and future plans.
```

助理：

```
# Project Update Report

## Executive Summary
This report provides a comprehensive update on the project milestones achieved, tasks completed, and future plans. Our team has made significant progress, and we are on track to meet the project goals. The following sections outline the details of our accomplishments and upcoming activities.

---

## Project Milestones Achieved

### **1. Project Initiation**
- **Milestone Date:** July 15, 2023
- **Description:** Completed initial project planning and secured stakeholder approval.

### **2. System Design Completion**
- **Milestone Date:** September 30, 2023
- **Description:** Finished the detailed system design and received positive feedback from technical review meetings.

### **3. Prototype Development**
- **Milestone Date:** November 15, 2023
- **Description:** Developed and tested a working prototype of the system.

---

## Tasks Completed

### **1. Requirement Gathering**
- **Description:** Conducted comprehensive stakeholder interviews and collected detailed requirements.
- **Highlighted Important Tasks:**
  - **User Story Mapping:** Mapped out user stories to ensure all user needs are addressed.
  - **Requirement Documentation:** Created detailed requirement specifications.

### **2. System Architecture Design**
- **Description:** Designed the system architecture, focusing on scalability and maintainability.
- **Highlighted Important Tasks:**
  - **Technology Stack Selection:** Chose the appropriate technology stack based on project requirements.
  - **Architecture Diagrams:** Developed detailed architecture diagrams for easy understanding.

### **3. Prototype Development and Testing**
- **Description:** Developed and rigorously tested the prototype.
- **Highlighted Important Tasks:**
  - **Coding:** Implemented core functionalities of the prototype.
  - **Testing:** Conducted unit and integration testing to ensure prototype reliability.

---

## Future Plans

### **1. Full System Development**
- **Description:** Begin the full-scale development of the system based on the approved design and prototype.
- **Highlighted Important Tasks:**
  - **Module Development:** Develop each module as per the design specifications.
  - **Code Reviews:** Implement regular code reviews to maintain code quality.

### **2. User Acceptance Testing (UAT)**
- **Description:** Conduct UAT to ensure the system meets user requirements and is ready for deployment.
- **Highlighted Important Tasks:**
  - **Test Plan Development:** Create detailed UAT plans and test cases.
  - **UAT Execution:** Execute UAT and gather feedback for final adjustments.

### **3. Deployment and Training**
- **Description:** Deploy the system and provide necessary training to end-users.
- **Highlighted Important Tasks:**
  - **Deployment:** Roll out the system to the production environment.
  - **Training Sessions:** Organize training sessions for users to familiarize them with the new system.

---

## Conclusion
Our project has successfully achieved key milestones and completed significant tasks. With the current momentum, we are well-positioned to meet our future objectives. We remain committed to delivering a high-quality system that meets all stakeholder expectations.

---

**Prepared by:**
[Your Name]
[Your Position]
[Date]

**Contact Information:**
[Your Email]
[Your Phone Number]

---

This detailed update aims to keep stakeholders informed and reassured about the project's progress and future direction. For any queries or further information, please do not hesitate to contact me directly.
```

------
#### [ 2-shot Prompt ]

系統：

```
You are an AI assistant helping to draft professional reports for enterprise stakeholders. Below are a few examples of well-formatted project update reports to guide your response. 

<Example 1>

<b>Project Update Report</b><br>
<i>Date:</i> January 15, 2023<br>
<hr>


<b>Project Milestones Achieved:</b><br>
- Successfully launched the new CRM system.<br>
- Integrated the marketing automation tool.<br>
- Completed the employee training sessions.

<b>Tasks Completed:</b><br>
- Developed the user manual.<br>
- Conducted system testing.<br>
- Prepared the training materials.

<b>Future Plans:</b><br>
- Roll out the CRM system to all departments.<br>
- Schedule follow-up training sessions.<br>
- Monitor system performance and make necessary adjustments.

<hr>
<b>Prepared by:</b><br>
[Your Name]<br>
[Your Position]<br>
[Your Contact Information]

<Example 2>

<b>Project Update Report</b><br>
<i>Date:</i> February 20, 2023<br>
<hr>

<b>Project Milestones Achieved:</b><br>
- Launched the new website.<br>
- Completed the SEO optimization.<br>
- Organized the stakeholder meeting.

<b>Tasks Completed:</b><br>
- Designed the website layout.<br>
- Wrote the content for the website.<br>
- Tested the website functionality

<b>Future Plans:</b><br>
- Implement the analytics tracking.<br>
- Launch the social media campaign.<br>
- Gather feedback from stakeholders.

<hr>
<b>Prepared by:</b><br>
[Your Name]<br>
[Your Position]<br>
[Your Contact Information]
```

使用者：

```
Draft a detailed project update report for our stakeholders, summarizing the project milestones achieved, tasks completed, and future plans.
```

助理：

```
<b>Project Update Report</b><br>
<i>Date:</i> October 5, 2023<br>
<hr>

<b>Project Milestones Achieved:</b><br>
- Successfully completed the implementation of the new enterprise resource planning (ERP) system.<br>
- Conducted and completed the first phase of the data migration process.<br>
- Successfully launched the new inventory management module.

<b>Tasks Completed:</b><br>
- Developed and finalized the comprehensive user training program, including detailed user manuals and video tutorials.<br>
- Conducted extensive system integration testing with all existing systems and ensured seamless interoperability.<br>
- Executed the initial data migration from the legacy system to the new ERP system, resulting in a 95% accuracy rate.

<b>Future Plans:</b><br>
- Roll out the new ERP system to all departments in the next two phases.<br>
- Schedule and conduct follow-up training sessions for all employees.<br>
- Implement the remaining modules of the ERP system, including financial management and human resources.<br>
- Establish a robust monitoring and support framework to ensure smooth system operation and address any issues promptly.

<hr>
<b>Prepared by:</b><br>
[Your Name]<br>
[Your Position]<br>
[Your Contact Information]

---

This detailed report provides a clear and concise overview of the project's progress, highlighting the milestones achieved, tasks completed, and future plans. It ensures stakeholders are well-informed and can make strategic decisions based on the current status of the project.
```

------

# 工具呼叫系統
<a name="prompting-tools-function"></a>

透過在請求中傳遞工具組態結構描述，Amazon Nova 模型可以使用工具呼叫。模型的提示詞將透過此工具組態得到加強，因此它是開始最佳化工具呼叫系統的重要位置。

請考慮下列重要原則：
+ 工具定義應清晰、簡潔。它們應該很容易理解，意圖必須非常明顯。
+ 使用關鍵差異化和邊界條件來定義何時應使用一個工具而非另一個工具。
+ 請注意輸入引數類型。問：它們是否合理，是否預期以這種方式正常使用？

**使用「工具選擇」來控制呼叫工具的時間**

工具選擇參數可讓您自訂模型的工具呼叫行為。建議您使用此值來精細控制呼叫哪些工具以及何時呼叫。

例如，對於結構化輸出等使用案例，您可能希望在每次調用 Amazon Nova 時呼叫特定工具。您可以將輸出的結構描述定義為工具，然後將工具選擇設定為該工具的名稱。

```
{
   "toolChoice": {
        "tool": {
            "name": "name_of_tool"
        }
    }
}
```

對於許多代理式使用案例，您可能想要確保模型一律選取其中一個可用的工具。若要這樣做，您可以將工具選擇設定為 `any`，每次調用模型時呼叫且僅呼叫一個工具。

```
{
   "toolChoice": {
        "any": {}
    }
}
```

最後，對於是否呼叫工具高度依賴於對話上下文的使用案例，您可以將工具選擇設定為 `auto`。這是預設行為，會將工具選擇完全交由模型來判斷。

```
{
   "toolChoice": {
        "auto": {}
    }
}
```

# 進階提示技巧
<a name="advanced-prompting-techniques"></a>

這些章節提供進階指引，說明如何改善提示的品質，並利用延伸思考等重要功能。

## 使用原因模式
<a name="use-reasoning-mode"></a>

Amazon Nova 2 模型提供選用的推理模式，透過讓模型在回應之前有系統地處理問題，增強模型解決複雜問題的方法。利用模型的推理模式是改善提示準確性的強大方式。

**使用時機：**建議將合理模式用於複雜任務，例如具有下列項目的使用案例：
+ **多個推理步驟：**數學驗證、演算法設計、系統架構
+ **交互參考資訊：**文件分析、選項比較、權衡評估
+ **容易出錯的計算：**財務建模、資料分析、複雜偵錯
+ **使用限制進行規劃：**資源最佳化、相依性管理、風險評估
+ **複雜分類：**多標籤分類、階層式分類法、細微決策界限
+ **工具呼叫案例：**多步驟 API 工作流程、資料庫查詢最佳化、協調系統整合

**注意**  
如需推理模式的詳細資訊，請參閱 [使用推理](using-converse-api.md#converse-api-reasoning)。

## 採取由上而下的方法
<a name="top-down-approach"></a>

對於模型需要評估多種方法來解決問題的情況，請指示它採取**由上而下**的方法。
+ 當模型從大局開始，然後分解為更小、更詳細的子問題或步驟時，Amazon Nova 2 模型的效能更好。
+ 明確指示模型先識別主要目標，然後將其分解為可管理的元件，然後再處理每個部分的詳細資訊。
+ 這種結構化方法有助於模型組織其思維，並產生更一致的推理鏈。

**範例**：

```
{{User query}}. Start with the big picture and break it down into progressively smaller, more detailed subproblems or steps.
```

## 行進思維鏈
<a name="steer-chain-of-thought"></a>

雖然推理模式透過系統化問題解決來提高準確性，但在某些情況下，以非合理模式發出 Chain of Thought (CoT) 提示可能會更好地滿足您的需求。

**使用時機：**
+ **透明度和可稽核性：**當您想要查看、驗證或稽核模型的推理程序時，CoT 會提供每個步驟的完整可見性。這對於受管制產業、高風險決策，或您想要記錄答案背後的邏輯時至關重要。
+ **自訂推理結構：**使用 CoT 強制執行特定推理模式或方法。您可以引導模型遵循組織的決策架構、使用特定領域的問題解決方法，或確保依特定順序考慮因素。
+ **提示詞開發和偵錯：**在提示詞工程階段期間，CoT 可協助您了解模型如何處理問題，找出原因分解的位置，並更有效地重複提示詞。
+ **混合方法：**考慮在開發期間使用 CoT 來完善您的提示，然後在您對模型對特定使用案例的方法有信心之後，切換至生產部署的推理模式。

**注意**  
並非所有任務都需要 CoT。對於更簡單的任務，允許模型使用自己的推理程序。

**引導模型的 CoT 方向：**

```
{{User query}} Please follow these steps:

1. {{Step 1}}
2. {{Step 2}}
...
```

## 使用長上下文視窗
<a name="utilizing-long-context"></a>

Amazon Nova 2 模型支援的內容長度為 100 萬個字符，並擅長理解程式碼和回答長文件的問題。其效能 （包括系統提示遵循和工具使用） 可能會隨著內容大小的增加而稍微下降。

**如何使用它：**
+ **將長格式資料放在開頭**：將長文件和輸入放在提示詞的開頭附近。將它們放在查詢、指示和範例之前。
+ **將指示放在末尾**：將指示放在提示詞的末尾。當先提供上下文，並在末尾提供指示時，模型會發揮最佳效能。
+ **結構文件內容開始和結束標記：**使用開始和結束標記，例如 `DOCUMENT {idx} START`和 `DOCUMENT {idx} END`來表示長文件的開始和結束，其中 \$1idx\$1 代表特定文件的索引。

**範本範例：**

```
// Provide your long inputs at the top of your prompt
BEGIN INPUT DOCUMENTS

DOCUMENT 1 START
{{Your document}}
DOCUMENT 1 END

END INPUT DOCUMENTS

// Then specify your query and instructions
BEGIN QUESTION
{{User query}}
END QUESTION

BEGIN INSTRUCTIONS
{{Instructions}}
END INSTRUCTIONS
```

## 支援文字中的基本答案
<a name="ground-answers-supporting-text"></a>

我們建議您為模型提供與輸入查詢相關的可信資訊。此資訊與輸入查詢通常是系統的一部分，稱為擷取擴增產生 (RAG)。
+ 在此過程中，某些相關的情境文件或資訊會擴增為實際的使用者提示，以便模型獲得可信的內容，以產生相關且準確的回應。
+ 指示 Amazon Nova 2 使用來自可信任來源的參考文字來回答 ，可以引導它根據提供的資料編寫回應，並確保其回應以準確且相關的資訊為基礎，從而增強所產生內容的可靠性和可信度。
+ 使用參考文字有助於避免幻覺，從而改善回應的整體品質和可信度。為了將幻覺降至最低，我們建議您在模型提示中明確提及 `DO NOT USE INFORMATION THAT IS NOT IN REFERENCE TEXTS!`。

提示範本

```
System:
In this session, the model has access to search results and a user's question, your job is to answer the user's question using only information from the search results. 

Model Instructions:
- DO NOT USE INFORMATION THAT IS NOT IN SEARCH RESULTS!

User: {Query} 
Resource: Search Results: {Reference texts}
```

### 範例：提供接地內容有助於防止模型幻覺
<a name="grounding-example"></a>

此範例顯示接地內容如何防止模型幻覺。

系統：

```
In this session, the model has access to search results and a user's question, your job is to answer the user's question using only information from the search results. Model Instructions:- DO NOT USE INFORMATION THAT IS NOT IN SEARCH RESULTS!
```

使用者：

```
What were the economic impacts of the COVID-19 pandemic on the United States in 2020?

Resource: Search Results: In 2020, the United States experienced significant economic impacts due to the COVID-19 pandemic. The U.S. economy contracted by 3.5% in 2020, according to the Bureau of Economic Analysis. Unemployment rates surged to 14.7% in April 2020, the highest since the Great Depression, before gradually declining. Small businesses faced severe challenges, with millions of firms closing permanently. Additionally, consumer spending dropped sharply as people reduced non-essential expenditures and saved more. Government intervention played a critical role in mitigating these impacts through stimulus packages and support programs, such as the Paycheck Protection Program (PPP) for small businesses and direct payments to individuals. Despite these measures, the economic recovery remained uneven across different sectors and regions.
```

### 使用引文標記的 Ground
<a name="grounding-citations"></a>

對於長文件任務，我們建議您指示 Amazon Nova 2 模型在繼續任務之前，使用文件相關區段的引文來建立回應。

這種方法有助於模型專注於最相關的資訊，避免因不必要的內容而分心。當您請求模型以其回應為基礎時，應該對可引用的區段進行編號。例如， `Passage %[1]%``Passage %[2]%`等。

#### 範例：使用引文標記
<a name="citations-example"></a>

**Example 引文標記提示**  

```
You are an AI financial assistant. Your task is to find patterns and insights from multi-year financial documents 

Passage %[1]%
{{Your document}}

Passage %[2]%
{{Your document}}

## Task:
Analyze my LLC's reports across multiple years to identify significant performance trends, segment growth patterns and strategic shifts.

## Context information:
- You have access to my LLC's annual financial reports (10-K) for multiple fiscal years in PDF format
- These reports contain comprehensive financial data including income statements, balance sheets, cash flow statements and management discussions
- The analysis should focus on year-over-year comparisons to identify meaningful trends
- I operate two business segments, one in Massachusetts and one in New York

Based on the provided Context, extract key financial metrics from each year's reports phrases from the documents.
Place citations as inline markers (e.g., %[1]%, %[2]%, etc.) directly within the relevant parts of the response 
text. Do not include a separate citation section after the response.
## Response Schema:
%% (Extracted Financial Metrics)
%% (Extracted Financial Metrics)
%% (Extracted Financial Metrics)
...
```

根據使用者的任務擷取金鑰資訊後，您可以使用擷取的財務指標來回答相關問題，如下所示：

**Example 使用擷取的指標進行後續分析**  

```
## Task
Analyze my LLC's financial reports across multiple years to identify significant performance trends, segment growth patterns and strategic shifts.

{{extracted financial metrics}}

## Model Instructions:
- Organize data chronologically to identify meaningful trends
- DO compare segment performance across the five-year period
- DO identify significant strategic shifts or investments mentioned in management discussions
- DO NOT make speculative predictions beyond what is supported by the data
- ALWAYS note any changes in accounting practices or reporting methodologies that might affect year-over-year comparisons

## Response style and format requirements:
- Respond in markdown
- Structure the analysis with clear headings and subheadings
- Present key financial metrics in tabular format showing all five years side-by-side
- Include percentage changes year-over-year for all major metrics
- Create a section dedicated to visualizing the most significant trends (with descriptions of what would be shown in charts)
- Limit the executive summary to 250 words maximum
- Format segment analysis as separate sections with consistent metrics across all segments
- MUST include a Key Insights bullet-pointed list at the end of each major section
```

### 使用 Nova Web Grounding
<a name="prompting-web-grounding"></a>

Amazon Nova 2 模型提供可使用的內部 Web 基礎工具，而不是直接提示引文將模型置於支援文字中。啟用時，Amazon Nova 2 模型會直接查詢 Web 和 Amazon 的知識圖表，並以引文做為最終回應的基礎。

若要進一步了解如何利用 Amazon Nova Web Grounding，您可以參考 [Amazon Nova Web Grounding 使用者指南](https://docs.aws.amazon.com/nova/latest/nova2-userguide/web-grounding.html)。

## 產生結構化輸出
<a name="prompting-structured-output"></a>

為了確保一致的結構化輸出格式，您可以使用結構化輸出，包括 XML、JSON、Markdown 等格式，或使用工具使用功能。
+ 此方法可讓下游系統更有效地了解和剖析模型產生的輸出。
+ 透過提供明確指示給模型，模型會以遵循預先定義之結構描述的方式產生回應。

例如，如果下游剖析器預期 JSON 物件中金鑰的特定命名慣例，您應該在提示結尾指定回應結構描述。此外，如果您偏好回應為 JSON 格式，而且沒有任何前序文字，請相應地指示模型。也就是說，明確狀態 **請僅產生 JSON 輸出。請勿提供任何前綴。** 以確保輸出乾淨。

**提示**  
當資料格式要求是在結構描述本身中定義，而不是透過使用範例 （例如，以 YYYY/MM/DD 格式指定日期） 時，我們會觀察到最符合資料格式的要求。
對於最多 10 個金鑰的簡單 JSON 輸出，您可以在下面找到結構描述。對於更複雜的結構描述，我們建議您透過工具定義結構描述。工具使用利用稱為限制解碼的技術，這將提高模型對這些複雜結構的遵循。

### 常見格式結構描述
<a name="common-formatting-schemas"></a>

以下是常見格式結構描述的範例。

------
#### [ JSON ]

```
JSON_format = """Write your response following the JSON format below:

```json
{ 
"key1": "value1",
"key2": "value2",
key3: [{
"key3_1": "value_3_1 written in YYYY/MM/DD format",
"key3_2": "value_3_2 day of the week written in full form",
...}```
"""
```

------
#### [ XML ]

```
XML_format = """Write your response following the XML format below:

<output>
    <task>"task1"</task>
    <subtask>
    <task1_result> ( task 1 result )</task1_result>
    <task2_result> ( task 2 result )</task2_result>
    <task3_result> ( task 3 result )</task3_result>
    </subtask>
    <task>"task2"</task>
    <subtask>
    <task1_result> ( task 1 result )</task1_result>
    <task2_result> ( task 2 result )</task2_result>
    <task3_result> ( task 3 result )</task3_result>
    </subtask>
</output>

"""
```

------
#### [ Markdown ]

```
markdown_schema = """Write your response following the markdown format below:


## Introduction
( 2-3 line intro)

## Design Guidance 
(Bulleted list of design guidance)

## Step by Step Instructions on Execution
( Bulleted list of instructions with each with bold title.

## Conclusion
( conclusion )


"""
```

------

### 預填充助理內容
<a name="prompting-prefill"></a>

如果您以非原因模式產生結構化輸出，您可以透過預先填入助理內容來微調模型的回應。

預填充可在非基礎模式下改善輸出格式的一致性。它可讓您指示模型的動作、略過前言，以及強制執行特定輸出格式，例如 JSON 和 XML。例如，如果您使用 `{`或 預先填入助理內容````json`，該輸入會引導模型產生 JSON 物件，無需其他資訊。

**提示**  
如果您要明確地尋找擷取 JSON，則常見的模式是預先填入 ，````json`並在 上新增停止序列`````。這可確保模型輸出可透過程式設計方式剖析的 JSON 物件。

**Example 預填充助理內容**  
以下程式碼示範如何使用 API 進行預先填充：  

```
import boto3
import json

# Create a Bedrock Runtime client.
client = boto3.client(
    "bedrock-runtime",
    region_name="us-east-1"
)

request_body = {
    "system": [
        {"text": "You write JSON objects based on the given instructions"}
    ],
    "messages": [
        {
            "role": "user",
            "content": [{"text": "Provide details about the best selling full-frame cameras in past three years. Answer in JSON format with keys like name, brand, price and a summary."}]
        },
        {
            "role": "assistant",
            "content": [{"text": " Here is the JSON response: ```json"}]
        }
    ],
    "inferenceConfig": {
        "maxTokens": 1000,
    }
}

# Invoke the model and extract the response body.
response = client.invoke_model(
    modelId="amazon.nova-2-lite-v1:0",
    body=json.dumps(request_body)
)

model_response = json.loads(response["body"].read())
```

### 指定用於複雜結構描述的工具
<a name="prompting-tool-complex-schemas"></a>

另一種方法是使用工具來強制模型回應的特定結構描述，方法是在工具使用結構描述區段中包含 *pydantic JSON* 結構描述。您可以為提供的結構描述指定工具選擇，Amazon Nova 的回應將根據選取的工具進行結構化。若要進一步了解如何利用工具，請參閱[工具使用](https://docs.aws.amazon.com/nova/latest/userguide/tool-use.html)。

### 範例
<a name="structured-output-examples"></a>

#### 範例 1：新增輸出結構描述
<a name="add-output-schema-example"></a>

在輸出結構描述區段新增適當的結構描述，可讓模型偏好符合該結構描述。不過，模型輸出不是確定性的，並且可能與輸出結構描述不同。

------
#### [ Unspecific Prompt ]

使用者：

```
Provide details about the best selling full-frame cameras in past three years.
Answer in JSON format with keys like name, brand, price and a summary.
```

助理：

```
```json
 [
 {
 "name": "Sony Alpha A7R IV",
 "brand": "Sony",
 "price": "Approximately $3,500",
 "summary": "The Sony Alpha A7R IV is renowned for its exceptional image quality, thanks to a 61-megapixel full-frame sensor. It also features 4K video recording and a robust build, making it a favorite among professional photographers and videographers."
 },
 {
 "name": "Canon EOS R5",
 "brand": "Canon",
 "price": "Approximately $3,900",
 "summary": "The Canon EOS R5 combines high-resolution imaging with advanced video capabilities. It houses a 45-megapixel sensor, 8K video recording, and impressive autofocus performance, appealing to both photography and filmmaking professionals."
 },
 {
 "name": "Nikon Z7 II",
 "brand": "Nikon",
 "price": "Approximately $2,800",
 "summary": "The Nikon Z7 II offers a 45.7-megapixel full-frame sensor and is praised for its high resolution and excellent dynamic range. It also supports 4K video recording and features a versatile Z-mount lens system, making it a strong contender in the full-frame market."
 },
 {
 "name": "Fujifilm GFX 100S",
 "brand": "Fujifilm",
 "price": "Approximately $7,000",
 "summary": "While not a traditional full-frame camera, the Fujifilm GFX 100S stands out with its 102-megapixel medium format sensor. It is lauded for its stunning detail and color reproduction, though it comes at a higher price point and is aimed at specialized users."
 }
 ]
 ```
```

------
#### [ Specific Prompt ]

使用者：

```
Provide details about the best selling full-frame cameras in past three years.
You MUST answer in JSON format only. Write your response following the the format below:
[{
“name”: “name goes here”,
“brand”: “brand goes here”,
“price”: “price goes here“,
"summary": "summary goes here"
}]
```

助理：

```
[
 {
 "name": "Nikon D850",
 "brand": "Nikon",
 "price": "$3,296.95",
 "summary": "The Nikon D850 is a professional full-frame DSLR camera known for its exceptional image quality, 45.7-megapixel resolution, 7 fps continuous shooting, and 4K video capabilities."
 },
 {
 "name": "Canon EOS 5D Mark IV",
 "brand": "Canon",
 "price": "$3,499.00",
 "summary": "The Canon EOS 5D Mark IV is a popular full-frame DSLR appreciated for its 30.4-megapixel sensor, 4K video recording, robust build quality, and reliable autofocus system."
 },
 {
 "name": "Sony A7R III",
 "brand": "Sony",
 "price": "$3,198.00",
 "summary": "The Sony A7R III is a high-resolution full-frame mirrorless camera renowned for its 42.4-megapixel sensor, excellent low-light performance, and versatile lens compatibility."
 },
 {
 "name": "Fujifilm GFX 100S",
 "brand": "Fujifilm",
 "price": "$5,999.99",
 "summary": "The Fujifilm GFX 100S is a medium format mirrorless camera that stands out for its 102-megapixel sensor, high dynamic range, and exceptional color reproduction."
 },
 {
 "name": "Sony A7 III",
 "brand": "Sony",
 "price": "$1,998.00",
 "summary": "The Sony A7 III is a full-frame mirrorless camera popular among enthusiasts and professionals for its 24.2-megapixel sensor, fast autofocus, and 4K video capabilities."
 }
 ]
```

------

#### 範例 2：預先填入模型回應
<a name="prefill-model-response-example"></a>

另一種方法是透過在助理的訊息中包含所需的初始文字，來預先填入模型的回應。在此情況下，Amazon Nova 模型的回應將從助理訊息結束的位置繼續。

**秘訣：**預先填入只有在未啟用推理時才有效。

使用者：

```
Provide details about the best selling full-frame cameras in past three years.
Your response should be in JSON format, with the following keys: name, brand, year, price, summary.
```

助理 （預先填入）：

```
```json
```

助理：

```
{
 "cameras": [
 {
 "name": "Sony Alpha A7 III",
 "brand": "Sony",
 "year": 2018,
 "price": "$1999",
 "summary": "The Sony Alpha A7 III is a highly acclaimed full-frame mirrorless camera known for its excellent image quality, advanced autofocus system, and 4K video capabilities."
 },
 {
 "name": "Canon EOS R5",
 "brand": "Canon",
 "year": 2020,
 "price": "$3899",
 "summary": "The Canon EOS R5 is a top-tier full-frame mirrorless camera that offers stunning 45MP images, 8K video recording, and exceptional performance in various lighting conditions."
 },
 {
 "name": "Nikon Z7 II",
 "brand": "Nikon",
 "year": 2020,
 "price": "$2999",
 "summary": "The Nikon Z7 II is a flagship full-frame mirrorless camera with a 45.7MP sensor, superb image quality, and advanced video recording features."
 },
 {
 "name": "Fujifilm GFX 100S",
 "brand": "Fujifilm",
 "year": 2020,
 "price": "$7999",
 "summary": "The Fujifilm GFX 100S is a medium format mirrorless camera known for its impressive 102MP sensor, beautiful film simulations, and versatile lens options."
 },
 {
 "name": "Sony Alpha A7R IV",
 "brand": "Sony",
 "year": 2019,
 "price": "$3499",
 "summary": "The Sony Alpha A7R IV features a 61MP sensor, excellent low-light performance, and advanced video capabilities, making it a favorite among professional photographers."
 }
 ]
 }
 ```
```

#### 範例 3：指定要使用的工具
<a name="specify-tool-use-example"></a>

除了使用結構化輸出的預填充技術之外，您還可以將 Nova 的工具功能與 toolChoice 結合。在此範例中，模型會產生遵循提供的 JSON 結構描述的工具呼叫，並呼叫指定為定義完整 JSON 格式的特定工具。如需其他指引，請參閱進階系統。

使用者：

```
From the below provided Query, extract the relevent entities

Query:
John works in BUILDING-0987 and have been incharge of product id 23564#. His performance have been excellent in past year and is up for a raise.

Use the extract_ner tool.
```

ToolConfig：

```
{
        "tools": [
            {
            "toolSpec": {
                "name": "extract_ner",
                "description": "Extract all the named entities. based on provided input",
                "inputSchema": {
                    "json": {
                        "type": "object",
                        "properties": {
                            "entities": {
                            "type": "array",
                            "items": {
                                "type": "object",
                                "properties": {
                                "name": {
                                    "type": "string",
                                    "description": "The extracted entity name. This should be a name of a person, place, animal or thing"
                                },
                                "location": {
                                    "type": "string",
                                    "description": "The extracted location name. This is a site name or a building name like SITE-001 or BUILDING-003"
                                },
                                "product": {
                                    "type": "string",
                                    "description": "The extrcted product code, this is generally a 6 digit alphanumeric code such as 45623#, 234567"
                                }
                                },
                                "required": [
                                "name",
                                "location",
                                "product"
                                ]
                            }
                            }
                        },
                        "required": [
                            "entities"
                        ]
                    }
                    
                }
            }
        }],
        "toolChoice": {
            "tool": {
                "name": "extract_ner"
            }
        }
    }
```

## 多語言使用案例
<a name="prompting-multilingual"></a>

Amazon Nova 2 模型已針對超過 200 種語言進行訓練，並針對 15 種語言進行最佳化。

**Topics**
+ [

### 提示正確翻譯
](#accurate-translations)
+ [

### 強制執行一致的撰寫慣例
](#consistent-writing-conventions)

### 提示正確翻譯
<a name="accurate-translations"></a>

若要利用此功能進行短格式翻譯 （幾個句子），您可以指示模型將文字翻譯為指定的目標語言。

**Example 翻譯提示**  

```
Translate the following text into {target language}. Please output only the translated text with no prefix or introduction: {text}
```

```
Translate the following sentence from {source_language} to {target language}: {text}
```

```
{text} How do you say this sentence in {target_language}
```

### 強制執行一致的撰寫慣例
<a name="consistent-writing-conventions"></a>

在以字元為基礎的語言中，Amazon Nova 2 模型可能會利用來源語言的字元集。您可以使用下列提示來強制執行一致的輸出。

**Example 強制撰寫慣例**  

```
When translating, ensure to use the correct orthography / script / writing convention of the target language, not the source language's characters
```

## 工具呼叫
<a name="tool-calling-advanced-techniques"></a>

### 代理系統
<a name="agentic-systems"></a>

**Topics**
+ [

#### 設定正確的推論參數
](#set-inference-parameters)
+ [

#### 考慮延遲要求
](#consider-latency-requirements)
+ [

#### 使用工具呼叫指示的刻意措辭
](#intentional-wording-tool-calling)
+ [

#### 利用「思考」命令
](#leverage-thinking-commands)
+ [

#### 工具呼叫排序
](#tool-call-ordering)
+ [

#### 建立品質工具結構描述
](#designing-tool-schema)
+ [

#### 建立子代理程式
](#create-sub-agents)
+ [

#### 使用工具進行多模態輸入
](#use-tools-multimodal-inputs)
+ [

#### 後續步驟
](#next-steps-best-practices)

#### 設定正確的推論參數
<a name="set-inference-parameters"></a>

工具呼叫需要模型中非常特定的結構化輸出，並使用下列推論參數來改善：
+ **非推理模式：**溫度：0.7 & Top P：0.9
+ **原因模式：**溫度：1 & Top P：0.9

#### 考慮延遲要求
<a name="consider-latency-requirements"></a>

**提示**  
Amazon Nova 2 模型能夠使用推理開啟和關閉的工具呼叫。不過，推理模式會對延遲產生重大影響。

對於延遲敏感應用程式，您應該針對推斷模式進行最佳化，並盡可能簡化必要的工具呼叫。將多步驟工作流程分割為離散步驟，以減少模型對調節不必要的參數的依賴。

#### 使用工具呼叫指示的刻意措辭
<a name="intentional-wording-tool-calling"></a>

**工具名稱：**在系統提示中參考工具在工具呼叫系統中很常見，以指示模型何時呼叫工具。當您在提示中參考工具時，我們建議您使用工具名稱，而不是 xml 或 pythonic 參考或範例。

##### 良好工具參考的範例
<a name="Example-of-a-good-tool-reference"></a>

```
Use the 'run_shell_command' tool for running shell commands
```

##### 錯誤工具參考的範例
<a name="Example-of-a-bad-tool-reference"></a>

```
Call run_shell_command() to run shell commands
```

#### 利用「思考」命令
<a name="leverage-thinking-commands"></a>

對於思考有利於工具呼叫的所有使用案例，我們建議您利用推理模式，而不是提示模型「在標籤中思考」或使用「思考」工具。

 Amazon Nova 2 模型經過廣泛的推理模式訓練，在推理模式用於思維鏈時會產生最佳結果。

#### 工具呼叫排序
<a name="tool-call-ordering"></a>

在可能需要同時使用內建工具和原生工具呼叫的使用案例中，模型會偏向先呼叫內建工具。

請勿指示模型在提示中採取不同的動作。反之，請設計您的工作流程以將此納入考量。

例如，如果您不希望模型使用內建工具，請勿將這些工具包含在工作流程中，讓模型不會偏離它們。

#### 建立品質工具結構描述
<a name="designing-tool-schema"></a>

工具結構描述是您可以提示設計有效工具呼叫系統的關鍵位置之一。不過，請務必考慮在工具結構描述中擷取的內容、如何以語意描述每個結構描述元素，以及系統提示如何在系統指示中參考工具和結構描述元素。

Amazon Nova 2 模型已針對工具結構描述中的簡潔描述進行最佳化。保持簡短。

**工具結構描述與系統提示準則：**

**包含在工具結構描述中：**
+ 核心功能：工具的功能 （建議 20-50 個字）
+ 參數規格：清除每個參數的描述 （每個參數大約 10 個字）
+ 預期的格式：資料類型 （例如列舉、整數、浮點數）、必要欄位和有效值範圍

**在系統提示中包含：**
+ 使用協同運作邏輯 （使用特定工具的時間和原因） 和業務規則 （條件式邏輯、排序需求和相依性） 專用`#Tool Usage`區段。
+ **錯誤處理策略：**新增 `#Error Handling and Troubleshooting`區段，其中包含如何回應失敗或非預期輸出的指示
+ **輸出格式：**新增如何呈現給使用者的詳細資訊

##### 範例
<a name="sample-example"></a>

```
You are a software engineering issue root cause analysis agent. You are tasked with reviewing a customer issue and examining the repository to identify a plan to resolve the issue.
      # Core Mandates
- **DO NOT** update the original issue that was posted by the user. You only add *additional* comments to the reported issue if necessary

# Primary Workflows
1. **Understand:** Analyze the user's request and explore the codebase thoroughly using **get_file_contents** to grasp file structures and conventions.
2. **Plan:** Create a coherent, evidence-based plan for resolving the task and share it with the user following the format below

# Tool Usage 
- **Read the Issue:** Always start by using the **read_issue** tool to get the details about the requested issue
- **File Paths:** Always end the file path with "/" if you are searching a directory using the **get_file_contents** tools
- **Parallelism:** Execute multiple independent tool calls in parallel when feasible

# Error Handling and Troubleshooting
- **File Exploration:** If you get an error that a file doesn't exist, try searching at the directory level first to validate the file path

# Output Formatting
Return your plan in markdown in the following format

## Issue
<Your root cause analysis of the issue>

## Resolution Plan
<your step by step plan of how to solve the issue>
```

#### 建立子代理程式
<a name="create-sub-agents"></a>

當您遇到下列情況時，請考慮建立專用子代理程式，而不是具有許多工具的單一代理程式：
+ **工具計數超過 20：**大型工具集變得難以管理和增加選擇錯誤
+ **不同的功能網域：**工具自然叢集分為不同的類別 （例如資料擷取與處理與報告）
+ **複雜結構描述：**當參數深度超過 3-4 個層級時，或工具具有複雜的相互依存性
+ **對話長度：**工作流程定期超過 15-20 個回合可能受益於特殊的子代理程式
+ **效能降低：**如果您發現工具選擇的準確性降低或延遲增加

**提示**  
MCP 伺服器隨附您無法控制的工具和結構描述。僅包含工作流程完成必要任務所需的工具。

#### 使用工具進行多模態輸入
<a name="use-tools-multimodal-inputs"></a>

對於多模式任務，我們尚未觀察到利用結構化任務工具 （例如擷取或產生時間戳記） 來提高準確性。

反之，我們建議您檢閱提示多模式輸入區段中的相關區段，了解如何使用提供的範本成功提示模型。

#### 後續步驟
<a name="next-steps-best-practices"></a>
+ 如需多模式提示，請參閱 [提示多模態輸入](prompting-multimodal.md)。