設定來源監控
使用現有的 Synoptic 摘要及其支援的目標設定來設定監控。建立發布串流並不會設定爬蟲程式。涵蓋範圍、目標格式、更新速度、延遲與帳號限制因摘要而異。
選取監控器與目標
使用 search 尋找候選摘要,然後使用 get_stream 檢查它們。用於帳號貼文、搜尋查詢、追蹤/取消追蹤或個人檔案變更的社交摘要,並不涵蓋其他類別。Telegram 頻道與 GitHub 儲存庫活動需要各自對應的提供者摘要。對於新聞、申報文件、政府發布及其他事件摘要,請使用 read-streams 技能中的來源系列。
對於可設定的摘要,請閱讀 customTargetsData.targetType、targetTypeInstruction、targetValidationRegex 以及目標數量限制。使用摘要所需的目標語法與大小寫。帳號代碼、數值帳號 ID、頻道 URL、儲存庫路徑、關鍵字、主題標籤、股票代號與完整搜尋表達式不可互換。沒有身分查詢工具;請勿從顯示名稱推斷數值 ID。在寫入之前,請向使用者或驗證過的來源取得遺失的識別碼。正則表達式比對僅驗證語法,不驗證身分或來源可用性。
如果現有摘要涵蓋使用者需求但無需自訂目標,在使用者的設定請求授權下,直接追蹤該摘要即可。如果沒有合適的可設定摘要,請說明缺少什麼。如果使用者要求傳送自訂串流請求,請使用 request-stream-or-feature 技能;提交的請求並非活躍的監控器。
儲存選取項目
使用 streams_following 檢查現有的追蹤。如果使用者要求監控一個他們尚未追蹤的合格串流,請在讀取其目標選取前先呼叫 follow_stream。然後使用 get_stream_custom_targets 讀取目前目標。追蹤者擁有自己的選取項目;擁有者擁有所有追蹤者目標的聯集,此聯集不得複製為個人選取項目。請回報權限或目標數量錯誤;不要改用其他監控器。
變更目標需要直接訂閱該串流並擁有目標配額。僅有追蹤、套件存取或組織存取是不夠的。使用 subscriptions.read 權限,get_stream_subscription 會顯示直接訂閱與其目標配額。如果缺少權限,請說明如何在 Synoptic 中設定;這些工具無法購買該權限。
使用 patch_stream_custom_targets 搭配 add 或 remove 進行小幅變更。set_stream_custom_targets 會取代整個選取項目;空列表則清除所有目標。保留不相關的目標。移除目標後,該目標的貼文將不再送達使用者;已開啟的 Synoptic 應用程式摘要會在重新連線後套用變更。已移除的目標會從使用者僅限特定目標的蒐集來源中刪除;若該來源因此沒有任何目標,則會被刪除。get_stream_custom_targets 需要 streams.read 權限;set_stream_custom_targets 需要 following.write 與 workspace.write 權限;patch_stream_custom_targets 也需要 following.read 權限。
使用 manage-workspace 技能將摘要組合到儀表板,並套用包含/排除關鍵字、正則表達式或 AI 篩選器。蒐集篩選器會變更出現在蒐集中的貼文,而非爬蟲程式的目標。
報告已建立的設定
從工具結果中確認已儲存的目標,並在相關時使用 get_stream_posts 檢查最近的更新。回報已達成的階段:找到摘要、取得存取權、儲存目標、設定蒐集,或觀察到相符的貼文。空的歷史頁面不代表失敗,舊的相符貼文也不代表新目標正在蒐集。沒有任何工具能報告爬蟲程式的健康狀態。
若要傳送到其他應用程式,請使用 connect-feed-to-app 技能。在此對話中閱讀貼文並不會啟動背景監控或保持外部消費者連線。