- 先從自動開始。 讓 Web IQ 選擇相關類型的結果。 當你特別需要網頁、新聞報導、圖片或影片,或想自己管理搜尋時,選擇專門的 API。
- 使用 Auto,讓整個任務保持完整。 請包含相關問題,以及在回答另一部分之前必須先找出的任何事實。
- 自己管理搜尋時,請為每個查詢設定明確的目標。 請包含會改變答案的姓名和細節,而非完整的對話內容或回答格式指示。
本指南適用於使用 Microsoft Web IQ 的 AI 代理及其他應用程式。 它以「你的代理」來稱呼傳送查詢並使用結果的元件。
自動搜尋與專門搜尋 API 皆接受自然語言問題或關鍵字。 選擇能清楚描述你需要找到內容的措辭。 自動回傳證據並附有支持性引用,不一定是完整答案;你的代理人會利用這些證據撰寫回應。
可以先從 Auto 開始,或選擇專門的搜尋 API
當你想用 Web IQ 選擇相關結果類型(如網頁、新聞或天氣)時,請以 自動 作為起點。 你不需要為每個問題部分選擇不同的 API。
當你需要特定結果類型或希望代理人控制每次搜尋並決定下一步要查什麼時,請選擇專門的 API。
| 所需項目 | 起點 | 範例 query |
|---|---|---|
| 讓 Web IQ 為完整問題選擇相關的結果類型。 | 自動 | What is the weather in Seattle this Saturday, and what is the latest news about Pike Place Market? |
| 檢索網頁,或控制一系列網頁查詢中的每個步驟。 | 網路搜尋 | Microsoft FY2026 Q1 revenue |
| 取得有關事件或發展的新聞報導。 | 新聞搜尋 | latest Adobe Photoshop feature announcements |
| 尋找主體的影像。 | 圖片搜尋 | Microsoft Surface Pro 12 platinum |
| 尋找影片,例如錄影或示範。 | 影片搜尋 | official Microsoft Build 2026 keynote video |
這些只是起點,而非專屬用途:Auto 也能為簡單的網路問題或新聞請求取得證據。
Note
Auto 和 Auto Advanced 功能自 2026 年 11 月 17 日起一般可於所有 Web IQ AppID 上使用。 請參考 Auto 參考資料。
選擇自動模式
選擇自動後,根據你的任務選擇模式:
| Mode | 何時從這裡開始 |
|---|---|
自動 (mode: lite預設) |
速度是首要考量。 把它當作針對某個主題提出直接問題和相關事實的預設起點。 |
自動進階 (mode: advanced) |
全面性是優先考量。 評估它是否需要從多份文件中取得證據,或是需要先找到一個事實再查另一個事實的研究。 |
省略 mode 後預設為 lite;自動模式不會自動在兩種模式間選擇。 這兩種模式都無法保證完全覆蓋。 請參考 自動參數。
圍繞整個任務建立 Auto 查詢
描述你需要找到的內容,包括問題各部分的關聯。 移除問候語、完整聊天紀錄,以及關於最終答案格式的說明。
一起詢問不同類型的資訊
對於結合天氣、餐廳和新聞的任務,請將這些需求集中在一個 Auto 查詢中:
{
"query": "What is the weather in Seattle this Saturday, which highly rated restaurants are near Pike Place Market, and what is the latest news about Pike Place Market?",
"mode": "lite"
}
Auto 可以為該任務選擇不同類型的結果,無需您的代理人分別發出氣象、餐廳和新聞請求。 回傳的類型可能有所不同。 請檢查證據是否涵蓋每個部分,包括所指的星期六和新聞報導的日期。
保留相依問題
有些問題要求在取得相關文件前,先識別實體。 在自動查詢中保留兩個步驟,包括所要求的文件類型:
{
"query": "Which U.S. president signed the act establishing NASA, and what did he warn about science and technology in his farewell address? Find the official government sources for both.",
"mode": "advanced"
}
此請求連結了兩個證據需求:從 NASA對其創立的敘述中識別總統身份,然後從 國家檔案館的逐字稿中取回他的告別演說及其中關於科學與科技的警告。
透過網路搜尋,您的代理人可以找到並驗證總統,然後搜尋該總統的告別演說。 單一網路搜尋可能涵蓋兩者;請確認證據中包含該地址的科學與技術警告,而不只是NASA的成立。
將相關事實與比較彙整在一起
關於某人的幾個事實,請提出一個連貫的問題:
{
"query": "What are Bill Gates's age, education, and business background?",
"mode": "lite"
}
比較時,請保留主語、指標和期間:
Compare Microsoft's annual revenue from 2012 through 2020.
不要把這寫成 Microsoft revenue:這樣做會失去比較和時間範圍。
針對專門搜尋 API 撰寫明確查詢
當你選擇專門的 API 時,請描述你想要擷取的資訊或媒體。 移除「回傳 JSON」、「保持簡潔」及「包含引用」等指令;這些都應該放在產生答案的提示中。
| API | 範例 query |
要保留什麼 |
|---|---|---|
| 網路搜尋 | What was Microsoft's revenue in FY2026 Q1? |
主題、指標及報告期間。 |
| 新聞搜尋 | latest Adobe Photoshop feature announcements |
主題與事件或發展。 請檢查文章日期與相關性。 |
| 影像搜尋 | Microsoft Surface Pro 12 platinum |
產品、型號及相關外觀。 |
| 影片搜尋 | official Microsoft Build 2026 keynote video |
無論您需要官方錄影、示範、教學、訪談或預告片。 |
當你的代理程式管理這些步驟時,分開搜尋
使用者請求:
What were Microsoft's Q1 earnings, and what new Surface products were announced?
有了 Auto,你可以把這個請求保持為一個整體。 如果你選擇讓代理程式管理獨立的網路搜尋,請為每個查詢設定一個明確的目標。 例如,如果財政年度和公告期間已經已知:
Microsoft FY2026 Q1 earnings
Microsoft Surface product announcements 2026
這些查詢不依賴彼此的結果,因此您的代理人可以獨立執行它們。 分割讓代理人能控制每次搜尋;這並不代表單一網路搜尋永遠無法找到兩個主題的證據。 不要選擇一個沒有由要求或已知情境設定的財政年度或公告期間。
同樣地,你的代理人可能會比較 Microsoft latest quarterly revenue 和 Apple Inc. latest quarterly revenue 的結果。 在比較數字前,請先確認報告的期間:「最新」並不代表兩家公司報告的期間相同。
將這些查詢技巧應用於任何搜尋 API
從已知上下文解析簡稱
如果使用者問「Satya 是幾歲?」且對話中確定他們指的是 Satya Nadella,請使用Satya Nadella ageHow old is Satya Nadella?
沒有這個背景,不要擴充模糊的名字。 當不同解釋會產生不同結果時,請詢問說明。
查詢時請控制在文件規定的 1,000 字元限制內。 不要用完整的對話或系統提示來填滿預算。 請參見 查詢行為與結果品質。
請包含會改變答案的姓名和細節
當它們會改變答案時,請保留名字、版本、地點和時間點。 以下範例假設這些細節已從使用者或受信任的上下文中已知。
| 需要 | 效果較差 | 更具體 |
|---|---|---|
| Person | Satya |
Satya Nadella education |
| 公司 | Apple |
Apple Inc. earnings |
| Location | Portland election results |
Portland, Maine election results November 2026 |
| Product | Surface problems |
Microsoft Surface Pro 12 reported battery issues |
| Version | .NET changes |
What's new in .NET 10 compared with .NET 9? |
不要猜測使用者指的是哪個人、波特蘭、產品版本或時間範圍。 重寫應該讓已知的語境明確呈現,而不是憑空編造語境。
區分新鮮度與歷史時間限制
| 意圖 | 範例 query |
|---|---|
| 最新發展 | latest Microsoft AI acquisitions |
| 近期某主題的報導 | recent Adobe Photoshop feature announcements |
| 一個具有歷史意義的月份 | Microsoft AI acquisitions March 2026 |
| 特定事件與時期 | Microsoft Build announcements May 2026 |
只使用任務所需的日期精確度。 如果請求詢問某個月份,就不要編造確切的日期。 如果明確問的是某一天,就保留這個限制。
查詢中的日期表示檢索目標;它們不是嚴格的出版日期篩選。 網路搜尋不提供日期範圍請求篩選器。 如需最新新聞報導,請使用新聞搜尋。 請參閱網頁搜尋日期篩選。
故意使用網站限制
網頁搜尋和自動功能支援 site: 和 -site:。 只有在請求中有來源限制或你的來源政策時才使用:
Microsoft Surface Pro 12 support site:support.microsoft.com
Adobe Photoshop feature updates -site:example.com
不要因為某個網站看起來有答案就加上限制。 它可能排除有用的證據並降低相關性。 當來源限制重要時,驗證回傳的原始網址;不要把查詢文字當作授權控制。 請參閱 網頁搜尋查詢參數。
使用已記錄的參數來補足查詢
請將主題和資訊需求保留在 query。 請使用其他參數來設定受支援的檢索控制,而非在查詢中加入「十個結果」或「寬幅圖片」等短語。
| Parameters | 適用對象 | 指引與參考 |
|---|---|---|
responseFilter |
自動 | 省略它以允許所有支援的結果類型。
["web", "news"] 僅允許網路和新聞,但兩者都不保證會出現。 用它來限制結果類型,而不是為每個問題選擇獨立的端點。 請參閱 自動回應過濾器常見問題。 |
language,region |
自動與專用搜尋 API | 使用支援的兩字母代碼。 查詢本身的語言依然重要;這些參數並不能取代明確表達的查詢。 參見 語言、地區與地點。 |
location |
自動搜尋、網路搜尋、新聞搜尋 | 在相關時以 lat:<latitude>;long:<longitude> 格式提供地理背景。 當地點可識別主題時,查詢中仍要寫出地名。 請參考 自動參數。 |
contentFormat、maxLength、maxResults |
網路搜尋與新聞搜尋 | 為了 grounding,從 contentFormat: "passage"、maxLength: 3000 和 maxResults: 10 開始。
maxLength 是每個結果的字元,而非標記。 請參閱 段落與內容格式。 |
aspectRatio,imageSize |
影像搜尋 | 使用像 "wide" 和 "large" 這樣的數值來過濾影像,同時不會遮擋主體。query 請參閱 圖片搜尋參數。 |
duration |
視訊搜尋 | 使用 "short"、"medium" 或 "long" 表示持續時間要求。 請參閱 影片搜尋參數。 |
例如,以下網頁搜尋請求主體描述精確證據並請求與查詢相關的段落:
{
"query": "Microsoft FY2026 Q1 cloud revenue and year-over-year growth",
"contentFormat": "passage",
"maxLength": 3000,
"maxResults": 10
}
同樣的原理也適用於影像篩選:
{
"query": "Microsoft Surface Pro 12 platinum",
"aspectRatio": "wide",
"imageSize": "large"
}
這些設定是端點專屬的。 不要將網頁搜尋的 contentFormat、maxLength 或 maxResults 設為自動,也不要將圖片搜尋篩選器傳送到 Web 搜尋。