使用 Microsoft Foundry 管理您的自訂問答（CQA）專案，包括專案設定、原始碼及專案生命週期操作。
如果你還沒建立 CQA 專案，建議先從 建立、測試並部署 CQA 知識庫開始。
必要條件
- 如果您沒有 Azure 訂用帳戶，請在開始前建立免費帳戶。
- 一個 Foundry 資源或語言資源。
- 一個包含 CQA 微調任務的 Foundry 專案。 關於設定說明，請參見 建立、測試與部署 CQA 知識庫。
建立專案
要在 Foundry 中建立專案，請依照 「建立、測試並部署 CQA 知識庫」操作。
管理專案
在 Foundry 中，你可以：
- 創造專案。
- 刪除專案。
- 部署或重新部署專案。
- 用於原始碼管理與測試的開放專案。
關於備份與還原操作，請參見 匯出、匯入及重新整理專案。
管理來源
在 Foundry 中開啟你的 CQA 微調任務。
在 開始使用 中，選取 管理來源。
新增並維護你的資料來源：
目標 動作 新增來源 選擇 「新增來源 」，並選擇 網址、 檔案或 閒聊。 刪除原始碼 選擇一個或多個來源，然後刪除它們。 分類檔案結構 上傳檔案時，請根據來源格式選擇 自動偵測 或 非結構化內容 。
關於特定 URL 的更新，請參見「 在專案中使用智慧 URL 刷新」。
管理大型專案
在 CQA 撰寫介面中，你可以：
- 依照問題、答案和元資料搜尋。
- 逐步檢視大型資料集。
- 部署前使用 測試知識庫 驗證行為。
刪除專案
刪除專案是永久的，而且無法復原。
在刪除專案之前，請先使用 匯出、匯入及重新整理專案，將專案匯出作為備份。
如果你和合作夥伴分享一個專案後刪除，他們會立刻失去存取權。
匯出、匯入並重新整理專案
基於數個原因，您可能想要建立自定義問題解答專案或相關問題和答案組的複本：
- 實作備份和還原程序
- 可與 CI/CD 管線整合
- 將您的資料移至不同區域
以程式設計方式匯出專案
要自動化匯出流程，請使用 authoring API 的匯出功能。
以程式設計方式匯出專案
要自動化匯入流程，請使用 作者 API 的匯入功能。
以程式方式重新整理 URL
要自動化 URL 刷新流程，請使用 authoring API 的「更新來源」功能。
撰寫 API 文件中的更新來源範例會顯示新增 URL 型來源的語法。 更新的範例查詢如下所示：
| 變數名稱 | Value |
|---|---|
ENDPOINT |
從 Azure 入口網站檢視您的資源時，可在 金鑰與端點 區段中找到此值。 範例端點為：https://southcentralus.cognitiveservices.azure.com/，而您只需要新增 southcentral 中區域特定的部分。 端點路徑已經存在。 |
API-KEY |
從 Azure 入口網站檢視您的資源時，請在 金鑰與端點 區段中尋找此值。 你可以用Key1或Key2。 永遠擁有兩個有效金鑰有助於進行安全的金鑰輪替，而不需要停機。 鍵值是樣本請求的一部分。 |
PROJECT-NAME |
你想更新來源的專案名稱。 |
curl -X PATCH -H "Ocp-Apim-Subscription-Key: {API-KEY}" -H "Content-Type: application/json" -d '[
{
"op": "replace",
"value": {
"displayName": "source5",
"sourceKind": "url",
"sourceUri": "https://support.microsoft.com/en-US/surface/models/surface-book-3-specs-and-features",
"refresh": "true"
}
}
]' -i 'https://{ENDPOINT}.cognitiveservices.azure.com/language/query-knowledgebases/projects/{PROJECT-NAME}/sources?api-version=2021-10-01'
搭配專案使用智慧 URL 重新整理
客製化問題回答幫助你透過從來源網址取得最新資訊，保持來源內容的更新。 只需一次選擇，你就能更新對應的專案以反映這些變更。 該服務會從網址中擷取內容，並在專案中建立、合併或刪除問答對。
此功能支援原始網址內容頻繁變動的情況，例如產品常見問題頁面的更新。 該服務會刷新原始碼並更新專案至最新內容，同時保留你之前手動編輯的內容。
Note
此功能僅適用於網址來源。 你必須逐個刷新，而不是大量更新。
這很重要
此功能僅在 2021-10-01 Azure 語言 API 版本中提供。
運作原理
如果你的專案 URL 來源有變動，你可以觸發智慧 URL 刷新，讓專案保持最新。 該服務會掃描網址以尋找更新內容並產生 QnA 對。 它會將新的 QnA 配對加入你的專案，也會刪除從原始碼消失的配對（有例外）。 在某些情況下，它也會合併舊有與新的 QnA 配對。
這很重要
因為智慧 URL 刷新可以刪除專案中的舊內容，建議在進行任何刷新操作前 先備份 專案。
你可以透過 REST API 程式化地觸發刷新。 關於參數與範例請求，請參閱 更新來源 參考文件。
智慧重新整理行為
當你使用此功能刷新內容時，QnA 對的專案可能會以以下方式更新：
刪除舊配對
如果來源網址的內容改變，且前一版本的 QnA 對已不存在，該程序會從更新後的專案中移除該對。 此過程確保你更新後的專案僅包含與當前來源內容相符的 QnA 對。 例如，若在先前版本的專案中存在像 Q1A1 這樣的 QnA 配對，但是在刷新並更新後，新的資料來源已不再提供 A1 答案，則該組合被視為不再有效。 因此，Q1A1 完全從專案中移除。
不過，如果你在創作入口網站手動編輯舊的 QnA 配對，流程不會刪除它們。
增加新配對
如果 URL 有新內容，且舊知識庫中出現新的 QnA 對，程序會新增該 QnA 對。 此新增功能確保您的知識庫始終包含來自原始資料的最新資訊。 例如，若服務發現可產生新答案 A2，則將 QnA 對 Q2A2 插入知識庫。
合併配對
如果新 QnA 對的答案與舊 QnA 對的答案相符，則該過程會合併這兩對。 新配對的問題會新增為舊 QnA 配對的替代問題。 例如，假設 Q3A3 存在於舊來源中。 當您重新整理來源時，就會導入新的 QnA 配對 Q3'A3。 在該情況下，這兩個 QnA 配對會合併：Q3' 會新增至 Q3 做為替代問題。
如果舊的 QnA 對有元資料值，程序會在新合併的對中保留並持久化該資料。
如果舊的 QnA 配對具有與其相關聯的後續提示，則可能發生下列情況：
- 如果附加到舊 QnA 配對的提示來自正在重新整理的來源，系統會刪除該提示，並將新配對的提示（如果有）附加到新合併的 QnA 配對。
- 如果附加至舊配對的提示來自不同的來源，則流程會保留提示不變。 新問題的提示（如果有的話）會追加到新合併的 QnA 對中。
合併範例
請參閱下列合併作業範例，其中包含不同的問題和提示：
| 來源反覆項目 | Question | Answer | 提示 |
|---|---|---|---|
| 舊 | 「什麼是新的 HR 原則？」 | 「您可能必須在下列選項中選擇：」 | P1、P2 |
| 新 | 「什麼是新的薪資原則？」 | 「您可能必須在下列選項中選擇：」 | P3、P4 |
提示 P1 和 P2 來自原始來源，與新 QnA 配對的提示 P3 和 P4 不同。 兩者都有相同的解答 (You might have to choose among the following options:)，但會導致不同的提示。 在此情況下，產生的 QnA 配對如下所示：
| Question | Answer | 提示 |
|---|---|---|
| 「新的人資政策是什麼？」 （另一個問題：「新的薪資政策是什麼？」） |
「您可能必須在下列選項中選擇：」 | P3、P4 |
重複解答案例
當原始來源有兩個或以上 QnA 對且答案相同（如 Q1A1 和 Q2A1），合併行為可能會更複雜。
如果每組 QnA 都有自己的提示（例如 Q1A1 與 P1，Q2A1 與 P2），更新後的來源可能會產生一對新的 QnA 配對，答案相同但提示是新提示，例如 Q1'A1 與 P3。 此時新增問題作為原題的替代。 此流程有助於讓 QnA 配對與最新來源內容保持同步。 不過，更新後的內容會替換所有原本的提示。 所以最終的組合組合如下：
| Question | Answer | 提示 |
|---|---|---|
| Q1 (替代問題：Q1') |
A1 | P3 |
| Q2 (替代問題：Q1') |
A1 | P3 |