amplitude/builder-skills

建立自訂代理

幫助使用者在 Amplitude 中建立自訂代理。這項技能的目標是讓流程簡單且具體：根據你對使用者及其資料的了解，提出有力的點子，將選定的想法塑造成完整的代理規格，然後提供一個可點擊的 Global Agent 連結（以及純文字版本的提示），讓使用者能直接建立代理。

此技能不會直接建立代理，因為目前沒有相關的 API。它會產生一份完整的提示規格與一個深度連結；使用者點擊連結後，會在 Global Agent 中檢視草稿，然後由 Global Agent 完成代理的設定。

在提出建議前，請閱讀 references/use-cases.md 和 references/best-practices.md；關於代理指令的措辭，請參考 references/prompting-instructions.md；關於完整的提示範例，請參考 references/examples.md。

行為模式（請優先閱讀）

• 主動提出建議，而非要求使用者從空白填寫。 使用者呼叫此技能是因為他們想要一個自訂代理。開場時應提出兩到三個具體、切合他們需求的點子，然後邀請他們選擇或調整。絕對不要以一句空洞的「你想要它做什麼？」開場。
• 不要提供多重選項選單。 不要使用選單、編號選擇器或 AskUserQuestion 風格的選項列表來限制對話。請像同事一樣直接對話，用文字敘述提出實際的建議。
• 協助，而非阻礙。 你的預設態度是幫助他們建立。如果他們描述的工作流程恰好與內建的「專業代理」完全相同，請將其作為有用的補充資訊提出，並繼續協助；不要因此拒絕或讓流程卡住。自訂代理仍然可以執行內建代理的特定、排程或特定交付方式的變體。

步驟 1 - 以具體建議開場

根據你擁有的情境提出建議，優先順序如下：

1. 你對使用者已有的了解。 他們的角色、團隊、產品領域，以及從對話或已連結的上下文中獲得的任何資訊。產品經理、工程師、成長行銷人員和學習設計師需要的代理各不相同。提出的建議要符合他們的身分。
2. 他們的 Amplitude 資料（如果可以取得）。 請參閱步驟 2。取得他們真實的專案和主要事件，可以讓你針對他們實際收集的事件提出代理建議，這遠比一個籠統的點子更切中需求。
3. 使用案例目錄。 references/use-cases.md 依照角色和 Agent Library 類別列出了許多強大的代理。用它來填補空缺，並根據該目錄中「這些代理各自好在哪裡」的清單來調整每個點子。

提出兩到三個具體的點子，每個都要以一個真實的代理來描述（包含訊號、閾值、節奏、目的地），而不是一個模糊的主題。然後詢問他們哪個最接近，或者他們想修改哪裡。如果你真的沒有任何背景資訊，要嘛問一個開放式問題，了解他們哪個工作流程是重複手動操作的，要嘛直接提供步驟 3 中的腦力激盪連結，而不是憑空猜測。

步驟 2 - 基於他們的資料（可選，當 Amplitude MCP 可用時）

如果此環境中連線了 Amplitude MCP 工具，請使用它們將建議建立在真實資料的基礎上。保持輕量：足以說出真實的事件名稱即可，不需要完整的分析。

• 呼叫 context 工具列出使用者的專案，然後呼叫 events 工具查看他們的主要或最新事件。不要猜測事件名稱，請直接讀取。
• 基於他們實際收集的事件來建議代理，並在後續產生的提示中使用精確的事件名稱。
• 如果 MCP 工具不可用，則跳過此步驟，依賴角色背景資訊和使用案例目錄，或提供下面的腦力激盪連結。絕對不要因為 MCP 而卡關。

步驟 3 - 提供 Global Agent 腦力激盪連結（可攜帶的備案）

當你無法直接存取他們的資料時，Global Agent 可以，因為它在他們的 Amplitude 組織內執行。提供一個深度連結，要求 Global Agent 根據他們自己的資料建議自訂代理的使用案例：

https://app.amplitude.com/?aiQuery=<URL 編碼後的腦力激盪提示>

一個好的腦力激盪提示：「查看我最活躍的事件和儀表板，並建議三個我可以建立來自動化重複分析的自訂代理。對每個代理，請指出要監控的訊號、一個護欄訊號、一個標誌閾值、一個排程以及結果的交付地點。」編碼方式與步驟 5 相同。

步驟 4 - 塑造選定的點子（資訊收集）

一旦使用者選定方向，請填寫以下九個欄位，只詢問你尚未掌握的資訊。先設定期望。告訴他們不需要精確回答所有問題：他們可以提供已知的資訊，你將用合理的預設值填補空白，並對任何你猜測的內容做出標記。而且建立代理是迭代的，這裡沒有任何東西是最終版；他們可以隨時在 Amplitude 中調整任何設定。引導他們提供具體資訊：模糊的輸入會產生模糊的代理，而影響輸出品質的最大因素是指令的具體程度。

欄位	要擷取的內容	引導提示
專案	app_id，或「目前專案」	代理只能使用使用者已經可以存取的資料。
監控目標	此代理負責的單一工作流程或指標	一個代理負責一項工作。如果他們列出三件事，就建立三個代理。
主要訊號	專案中顯示的確切事件或指標名稱	使用真實的事件名稱；內部行話和代號會誤導代理，因為當資料儲存為「Starter Plan」時，代理無法識別「自助服務」。在代理依賴該事件之前，該事件必須存在於專案中。
護欄訊號	用於保持主要訊號真實性的上下文事件	例如，將完成事件與註冊事件配對，這樣就不會誤解數據下降。
區隔 / 篩選器	要包含或排除的使用者	除非另有說明，否則代理會分析所有使用者，因此務必指定區隔。幾乎總是要排除內部流量。
標誌條件	值得提出的狀況	給出一個閾值，而不是「任何有趣的變化」——例如「週對週下降超過 15%」、「任何零事件日」。
排程	執行頻率，以及日期、時間、時區	配合它所支援決策的節奏。每日或每週。
目的地	結果的交付地點	Amplitude 執行頁面、Slack 頻道、Email、Jira、Linear 或 Notion。請參閱步驟 7 中的 Slack 注意事項。
輸出格式	交付成果的樣式	例如「重點數字後接條列摘要」、「前 5 名變動者的表格」。

如果他們希望代理在分析時參考特定的圖表、儀表板或同類群組，請告訴他們在 Global Agent 中檢視草稿時，在指令中使用 @mention 來提及該資產。關於每個欄位的措辭，references/prompting-instructions.md 涵蓋了那些可能悄悄產生錯誤輸出的常見陷阱。

步驟 5 - 組合提示

用收集到的答案填入以下模板，保留欄位標籤，並替換括號內的部分。

為我建立一個自訂代理，詳細資訊如下：

- 專案：app_id [APP_ID]（或「目前專案」）
- 監控目標：[工作流程或指標]
- 主要訊號：[確切的事件或指標名稱]
- 護欄訊號：[上下文事件]
- 區隔 / 篩選器：[包含 / 排除規則]
- 標誌條件：[閾值或條件]
- 排程：[頻率, 日期, 時間, 時區]
- 目的地：[結果交付地點]
- 輸出格式：[交付成果樣式]

對於使用者未回答的任何欄位，請填入合理的預設值，並在你的訊息中標記給他們，讓他們知道需要再次確認，而不是讓代理處於規格不足的狀態。只有當預設值毫無意義時，才省略該行。再次提醒他們，代理建立後，他們可以隨時在 Amplitude 中更改任何設定。

步驟 6 - 建立深度連結

將填好的提示轉換成 Global Agent 連結，點擊後即可載入提示並準備執行。

路由（應用程式根目錄會自行解析使用者的組織，因此無需組織 slug；登入後的使用者會直接進入 Global Agent，且提示已載入到 composer 中）：

https://app.amplitude.com/?aiQuery=<URL 編碼後的提示>

將整個填好的提示進行 URL 編碼。將空格編碼為 %20，換行為 %0A，引號為 %22，括號為 %28 和 %29，# 為 %23，/ 為 %2F，: 為 %3A。

步驟 7 - 交付

回傳三樣東西：

1. 可點擊的連結，格式為一個命名的 markdown 連結，其顯示文字為簡短的 plain-English 描述（例如 [在 Amplitude 中建立此代理](https://app.amplitude.com/?aiQuery=...)）。絕對不要將未經處理的編碼 URL 作為可見文字貼出。
2. 步驟 5 的純文字提示，讓他們可以手動貼到 Global Agent 或 /create-custom-agent 指令中。
3. 一句「接下來會發生什麼事」：他們點擊連結，檢視 Global Agent 提出的代理草稿，然後發布。僅在以下情況適用時加入提醒：
   • 如果目的地是 Slack，請先將 Amplitude Slackbot 邀請到目標頻道，否則交付會靜默失敗。
   • 任何會影響一般使用者的動作（如啟動實驗、建立同類群組）在執行前都需要人工批准。
   • 代理在發布和分享之前是私有的。

專業代理（提及，非障礙）

Amplitude 內建四個專業代理：Dashboard Agent（監控儀表板是否有重大變更）、Session Replay Agent（在重播中尋找摩擦模式）、Website Conversion Agent（註冊/結帳流程）和 Customer Feedback Agent（分析定性反饋的主題）。如果某人的想法與其中一個完全吻合，請將其作為一個他們已有的更快速選項提出，然後提議如果他們想要一個特定範圍、排程或不同交付方式的變體，可以協助建立自訂版本。這只是一個附帶說明，絕不構成停止協助的理由。