本頁面將概略說明使用 Agent Assist 智慧撰寫功能的最佳做法。如要進一步瞭解如何直接呼叫 API 來實作這項功能，請參閱智慧撰寫 使用指南；如要瞭解如何使用 Agent Assist 控制台實作這項功能，請參閱控制台教學課程。
術語
智慧撰寫功能會使用下列詞彙。
建議的基礎文字
本節定義 Agent Assist 使用的術語。
建議的基本文字是智慧撰寫功能用來生成完整文字建議的部分輸入文字。這是 current_text_input.text 中的文字，位於 SuggestSmartComposeAnswersRequest。
範例：如果服務專員輸入「你好」，系統可能會建議「你好嗎？」。在本例中，「Ho」是基本文字，「你好嗎」則是建議。
建議的延展型文字
建議的擴展文字是將建議與其基本文字合併而來。如果基本文字包含與建議前置字元相符的後置字元，系統會合併相符部分。智慧撰寫功能會比對後置字元和前置字元，且不區分大小寫。為避免誤判，建議您只在建議項目有非空白的前置字元，且該前置字元與基本文字中的後置字元相符時，才顯示建議。
示例：如果基本文字是「你好」，建議文字是「你好嗎」，則建議文字延伸文字會是「你好嗎」。
可用建議
如果符合下列條件，建議就是可用建議：
- 建議的基礎文字是已輸入文字的前置字元。
- 輸入的文字是建議的擴充文字前置字元，但兩者不相等。
示例：如果已輸入的文字是「how a」，則以「Ho」為基礎文字的「how are you」建議是可用建議，但如果已輸入的文字是「h」或「how are you」，則「how are you」就不是可用建議。
要求建議
建議您讓伺服器在每個新字元上傳送 suggestSmartComposeAnswers 要求，除非該字元已包含在可用的建議中。這樣一來，系統就更有可能產生智慧撰寫建議。請注意，這可能會產生高 qps：如果發現要求因配額限制而遭到節流，請與 Google 聯絡，討論解決方案。建構要求時，請考慮將 max_results 設為 3，以增加擷取的建議數量。
選取建議
選取建議是重要功能，必須先實作這項功能，才能在代理程式 UI 中實作智慧撰寫功能。輸入速度可能很快，但智慧撰寫建議會有些許延遲。因此，建議抵達服務專員 UI 時可能已失效。為盡量減少這個問題，建議您只將可用建議的子集算繪至 UI。如果出現下列情況，請選取建議的輸入文字：
- 這是系統根據輸入文字提供的建議。
- 在所有可用的建議中，其基本文字的字元數最多。
- 如果有多個建議的基礎文字長度相同，請選擇建議等級最高的選項。
工作流程範例：
- 代理商輸入「Ho」。
- 系統會傳送含有目前訊息「Ho」的要求。
- 服務專員繼續輸入「如何」。
- 建議「希望你」、「你好嗎」、「今天過得如何？」(根據原始項目「Ho」) 傳送至代理程式 UI。
- 在本例中，由於服務專員已輸入其他字詞，「Hope you」不再是有效建議。系統應建議「你好嗎」。
快取
建議您將快取實作為鍵/值對應，其中前置字元為鍵，API 傳回的建議為值。應檢查地圖中是否有與代理程式輸入內容相符的鍵。如果地圖不含相符的鍵，請一次從代理程式輸入內容的結尾移除一個字元，並在每次疊代時檢查地圖。這項程序應持續進行，直到找到相符的建議、代理程式輸入內容中沒有可移除的字元，或是達到疊代限制 (50 次疊代是合理的次數)。找到相符的鍵後，建議應會疊代。如要判斷建議是否有效，請合併鍵 (前置字串的子字串) 和建議，然後根據代理程式輸入內容進行檢查。合併的建議和代理程式輸入內容應完全重疊，從第一個字元開始。如果不是，請檢查下一個建議。
使用快取的範例：
- 「Agent」輸入「H」。
- 系統會檢查鍵/值對應，找出前置字元為「H」的建議。沒有任何字元，且輸入內容結尾沒有任何字元可移除，因此系統會要求提供「H」的建議。
- 「Agent」繼續輸入「Ho」。
- 系統會檢查鍵/值對應，找出前置字元為「Ho」的建議。如果沒有，系統會檢查鍵/值對應關係，找出字首為「H」的建議。沒有任何相符的字元，且輸入內容結尾沒有任何字元可移除，因此系統會要求提供「Ho」的建議。
- 從步驟 2 中傳送的要求收到沒有建議的回應，且該回應會新增至鍵「H」的快取。
- 系統會收到步驟 4 中傳送要求的回應，其中包含建議「希望你」、「你好嗎」、「今天過得如何？」；這些建議會新增至「Ho」鍵的快取。
- 系統會檢查鍵/值對應表，找出前置字元為「Ho」的建議，並提供建議。建議會形成迴圈，並與鍵和建議合併，然後根據「代理程式」輸入內容進行檢查。「Agent」輸入「Ho」時，會與第一個建議「Hope you」重疊，因此系統會向代理顯示「pe you」建議。
- 「Agent」繼續輸入「How」。
- 系統會檢查鍵/值對應表，找出前置字元為「How」的建議。沒有建議，系統會檢查鍵/值對應關係，找出前置字元為「Ho」的建議，並提供建議。系統會循環提供建議，並合併鍵和建議，然後根據「代理」輸入內容進行檢查。「Agent」輸入「How」時，會與第一個建議「how are you」重疊，因此系統會向服務專員顯示「are you」建議。
對話記錄
智慧撰寫功能需要對話記錄才能正常運作。如果您透過 analyzeContent API 使用智慧回覆或其他 Agent Assist 功能，應該已符合資格。否則，您必須在每則訊息完成後呼叫 analyzeContent API，才能使用 suggestSmartComposeAnswers 取得智慧撰寫建議。詳情請參閱智慧撰寫操作指南。