如何使用 Kanera 與 AI 的示例

一旦AI代理透過連線到Kanera MCP，它可以全面瞭解您的實際工作並採取行動。這就是根據貼上文字進行猜測的助手與根據實時工作區資料（卡片、受讓人、截止日期、標籤、自定義欄位、註釋、評論和活動）進行推理的助手之間的區別。

下面的示例是真實的工作流程,每個示例都顯示了要提出什麼問題、為什麼座席可以做這件事以及你會得到什麼回報。 大多數示例只讀取 Kanera。 （更改Kanera） 並且需要寫入許可權: 一個 OAuth 連線,其中您是板上的編輯者,或者一個寫入作用域 API 金鑰。

軌道阻塞器和傳遞

嘗試使用已連線的代理執行以下提示:

• “讓最終產品資訊遮蔽登陸頁面副本。 將副本與可選的法律審查相關聯,而不使其成為先決條件 。 ”
• “在整個營銷工作區顯示被阻止的卡片,並解釋我可以看到的阻止器和所有者 。 ”
• “看發射板,當一張牌解鎖時,讀取它的當前詳情,告訴我下一位誰可以拿起它 。 ”

要解釋整個鏈,代理使用 cards.dependency_graph 一個卡片、板或工作區範圍。 它也可以使用 cards.set_relations, work.query_cards 與 blockedOnly, 和 card.blocked / card.unblocked 標記為被阻止的執行與這些卡片關係分開。 參見 卡片關係與阻塞.

審查時間表並提出重新安排

“檢視啟動板的時間表。關鍵鏈預計何時完成，什麼沒有鬆弛，哪些卡在其阻礙因素完成之前開始？顯示日期和工作日影響。不要更改任何內容。”

代理解決板與 boards.list_accessible，然後呼叫 work.schedule 具有一個範圍:

{ "boardId": "<board UUID>" }

使用 { "workspaceId": "<workspace UUID>" } 工作區的時間表跟隨可訪問的連線鏈到其他板。 該時間表是由一個工作區的時間表和一個工作區的時間表組成的。 時間線指南 解釋了同一計算的人類視角。

閱讀 summary.projectedFinish, summary.latestDue, 和 summary.slipDays 預報及其與最後承諾日期的延遲。 每張卡, plannedStart / plannedEnd 描述儲存的計劃, earliestStart / earliestFinish 考慮到先決條件， slackDays 測量滑動空間, critical 標記連線的工作,沒有間隙,並且 conflicts 日期 指的是週一至週五的工作日;已完成的卡片被排除在外。 連線無法開啟的卡片也被排除在外,因此將預測描述為可訪問計劃。

例如,如果先決條件在星期五結束,其依賴項計劃在該星期五開始,則最早的乾淨移交是星期一:比該日晚一個工作日。 cards.dependency_graph 解釋誰阻止誰;使用 work.schedule 對於日程表的實際日期和間隙。

“提議 MKT-42 的日期從下週一開始到週五結束。解釋哪些家屬需要搬家。在應用之前展示該提案。”

沒有任何假設輸入引數 work.schedule。閱讀當前的時間表，從其持續時間和連結中得出原因，並將建議的影響標記為估計值。不要僅僅為了模擬答案而更改儲存的日期。當使用者批准更改時，請使用以下命令重新讀取卡片 cards.get，然後使用 cards.update:

{
  "cardId": "MKT-42",
  "changes": {
    "startDateLocalDate": "2026-11-02",
    "dueDateLocalDate": "2026-11-06"
  }
}

這些日期說明週一至週五;使用使用者的區域從解析相對短語 session.get 並重復所選日期。 開始日期短語也受支援。 閱讀 work.schedule 儲存後再次報告實際結果。 繼任日期不會自動移動。 應用此示例會改變 Kanera,並需要寫入許可權。

觀看時間表健康

“觀看發射板。告訴我第一次排程衝突何時出現、何時消除，或者關鍵路徑日期更改何時推遲預計完成時間。在報告之前閱讀時間表，顯示受影響的卡片連結，並保持日期不變。”

相容主機單獨訂閱 schedule.conflict_detected, schedule.conflict_resolved, 和 schedule.critical_path_slipped，範圍為看板及其工作區。從一個開始 work.schedule 讀取以便包括現有問題;事件在基線之後而不是重播後宣佈變更。 在每次發生時讀取時間表,在適當時跳過連線自己的寫入,並刪除重複的重複事件。 eventId 見第10段。 訂閱事件 對於有效載荷、重新整理和交付限制。

對於早上的審查,請問"我的排程衝突,關鍵工作,和卡錯過了他們計劃的開始 " 。 work.my_day 返回這些在 schedule.conflicts, schedule.critical, 和 schedule.lateToStart 對於跨專案審查,請參閱 work.portfolio_summary 返回支援的每板滾動 conflictCount, criticalCount, projectedFinish, latestDue, 和 slipDays;鑽入受影響的板 work.schedule.

如果禁用了時間線或依賴項,代理將報告 TIMELINE_DISABLED 或 DEPENDENCIES_DISABLED 並要求相關管理員在需要時啟用該功能。 它應繼續可用的工作,而不是重試被拒絕的操作。

把今天的工作排序

“顯示我的下一個佇列，然後將付款釋放卡移至頂部，並將文件審查放在緊隨其後的位置。” （更改Kanera）

代理首先讀取當前排序條目,解析請求的卡片,並使用條目錨點執行確切的移動。 它在不更改到期日期、工作流列表或優先順序自定義欄位的情況下更改工作順序。 請求它在應用更廣泛的重新混合之前顯示擬議順序。

規劃工作,然後在程式碼到達時跟蹤

這就是 MCP 真正解鎖的工作流程:編碼代理在 Kanera 中進行規劃,然後在完成實際工作時更新相同的卡片。 由於代理的編輯器和 Kanera 都可以透過 MCP 聯絡,因此跟蹤卡片本身保持準確 — — 沒有人需要切換選項卡來勾選核取方塊。

步驟1—計劃進入卡。 指向代理在工作,並要求它記錄計劃,團隊可以看到它:

“閱讀此儲存庫和‘升級依賴項’卡。將實施計劃寫入卡描述中，並新增一個清單，其中每個專案需要更新一個專案。” （更改Kanera）

代理檢查程式碼庫,起草計劃,根據計劃更新卡片描述,併為每個專案構建一個檢查清單專案。 現在,卡片是工作的真實來源,而不是一次性的聊天。

步驟 2 — 做工作,讓代理關閉自己的清單。 在同一會話(或稍後的會話)中,讓代理在專案中實施更改:

“完成該卡上的清單。更新每個專案中的依賴項，並在每個專案構建並透過時，將其清單專案標記為完整。” （更改Kanera）

當代理完成每個專案時，它會檢查跟蹤卡上的匹配專案。任何觀看該板的人都可以實時看到真正的進展——清單在程式碼實際釋出時填寫，而不是在有人記得更新它時填寫。每次檢查都會被記錄為代表您行事的代理人，並帶有 透過 <代理人> 徽章,因此卡片可以兼具代理人所做的工作和時間的審計跟蹤功能。

這種"將計劃輸入卡片,然後將進度報告返回卡片"迴圈適用於任何多步工作 — 依賴關係升級、遷移、重構或將功能分解為任務。

讓板顯示代理正在工作

一項漫長的工作在完成之前是看不見的，這就是兩個人最終做同樣的工作的原因。代理人可以在卡上宣佈自己：

“在你開始之前 PLAT-42，開啟在其上執行的代理並隨時更新。如果您需要我做出決定，請將其標記為“已阻止”。” （更改Kanera）

代理人打電話 runs.start 卡片的瓷磚上會立即顯示一個實時晶片,標明代理和工作的名稱。 從那時起, runs.update 既是進度報告,也是心跳:

1. runs.start — { cardId: "PLAT-42", title: "Implementing OAuth refresh", }。晶片出現在圖塊上，實時執行顯示在卡的描述下方。
2. 工作,並繼續報告。 runs.update 與 { runId, summary: "Refresh rotation done; wiring the retry path." }。每個電話都是一次心跳，所以在一項漫長的工作中至少每十分鐘打一次電話——即使是空的工作。
3. runs.update 與 status: "blocked" 當它需要你時,晶片會變成琥珀色,並且總結會告訴它正在等待什麼,所以問題就會出現在卡片上,而不是埋在聊天記錄中。
4. runs.update 與 status: "succeeded" （或 failed, 或 cancelled) 將其關閉。晶片會被清除，執行會保留在卡的歷史記錄中，並且結果會記錄在活動源中。

詢問 runs.list 首先,當多個代理共享一個看板時:它顯示了已經在飛行的東西,所以他們兩個不會開始同一張卡片。 如果一個代理在執行中崩潰,Kanera 會在15分鐘後標記執行停止,而不是讓卡片看起來永遠忙碌。

當事情發生變化時,不經詢問即可做出反應

上面的提示符在您鍵入時會執行。 支援 MCP 活動訂閱，例如 ChatGPT，還可以在建立、更改、移動或評論卡片或您的下一個佇列發生更改時持續觀察並採取行動。 Kanera 將變更交付給客戶端；客戶端執行您所描述的任務。 Kanera 中未進行任何配置，結束任務將結束訂閱。

當您離開時，回答卡片上的問題。

“觀看發射板。當新評論提出問題時，請閱讀卡片及其主題，並回復答案（如果卡片或連結筆記中有答案）。如果不是，請回復我會跟進並告訴我。” （更改Kanera）

每個新評論都作為一個事件到達,其中包含評論文字和卡片。 comments.list 因為每個事件都會告訴我們是誰做了更改,以及是否是代理本身做的,所以這樣的任務可以檢查是否有任何事件發生。 actor.self 並跳過它自己的回答,而不是回答自己。

保持利益相關者渠道的最新狀態。

“每當一張卡片進入移動版的“完成”列表時，請告訴我，並附上已發貨內容的一行摘要。”

移動事件包含目標列表,因此座席可以過濾完成並僅讀取到達該目標的卡片。 將此與聊天目標配對,或讓客戶端釋出摘要,讓利益相關方閱讀。

當新工作到達時進行分類。

“檢視支援板上的攝入列表。對於每張新卡，根據描述和過去的類似卡建議優先標籤和所有者，並將建議作為評論留下。不要換卡。” （更改 Kanera：僅評論）

一個 card.created 當卡片存在時,事件會立即觸發。 cards.get，搜尋類似的卡片，並評論其建議以供某人接受。這個決定仍然是人性的；研究是在任何人開啟卡片之前完成的。

守護一張關鍵卡。

“觀看 PLAT-42。如果有任何變化，包括評論，請給我發一條簡短的說明，說明更改的內容以及更改者。”

當釋出、合同或事件卡不得悄悄變更時,訂閱一張卡片。 事件命名行為者,因此註釋說明它是團隊成員、自動化或其他代理。

知道什麼時候你的優先事項發生了變化。

“每當我的下一個佇列因為其他人重新排序而發生變化時，請告訴我哪些內容發生了變化，哪些內容現在位於頂部。”

一個 priorities.changed 當佇列獲得、丟失或重新排序條目時,包括佇列中的卡片完成或重新分配時,會觸發此事件。 它不攜帶卡片,因此代理人會使用 priorities.list，將其與上次看到的順序進行比較，並跳過其中的更改 actor.self 是真或 actor.userId 只有您自己的佇列才能被監視。

早上做簡報

“每個工作日早上，告訴我什麼是逾期的，什麼是本週到期的，以及什麼是我的下一個佇列的頂部。”

一個 my_day.ready 您的客服人員會在您的時區的工作日 08:00 收到您的問題,而您的每日摘要電子郵件則是開啟的。 work.my_day 呼叫,它返回過期、本週到期、過期檢查列表和空閒分配卡片加上您的 Up next 佇列的頭。

兩種習慣使這些任務可靠: 讀取卡片之前,它寫，因為事件是摘要，並且 使用等效金鑰 交付是最好的努力在幾分鐘內完成;如果客戶端無法連線的時間更長,任務應該透過讀取當前狀態來恢復,而不是等待重播。

早上分揀在一個提示

“顯示工作區中分配給我的所有內容，並按緊急程度分組。標記所有逾期的內容、沒有截止日期的內容以及一週內未移動的內容。”

快速開始, work.my_day 對於自定義分組,有界工作查詢一次性提取整個工作區佇列。 它可以按到期日期、到期狀態、不活動狀態和最後一次移動進行過濾,然後顯示出今天需要的兩三件事情。 在應用中,Home 和 My Cards 提供了面向人類的版本的此工作流。

即時站立更新

“準備我的站立會議：昨天關閉的內容、今天正在處理的內容以及被阻止的內容。”

座席會讀取最近的活動和您分配的卡片,然後起草一份緊湊的更新。 將其貼上到 Slack 中或讀出來。 prepare_standup_update 如果客戶端出現提示,則 prompt 會做到這一點。

看板對經理的審查

“總結路線看板。找出阻礙因素、過時的卡、沒有所有者的卡，以及可能會在衝刺中失敗的因素。”

具有看板讀取許可權的代理可以結合看板後設資料、繫結卡片頁面、陳舊工作過濾器和選定的卡片歷史記錄，以像潛在客戶一樣審檢視板 - 不僅僅是列出卡片，還可以推理風險。在計劃會議之前非常好。

將會議轉化為卡片

“這是我在客戶電話中的筆記。每個行動專案的草稿卡，其中包含標題、Markdown 描述和建議列表。先向我展示草稿 - 暫時不要建立任何內容。”

代理人會提出結構化的卡片。 您審查、編輯,然後說:

“在攝入列表中建立這些並給它們貼上標籤 customer-request." （更改Kanera）

這種"草擬、審查、應用"模式是讓代理建立工作的最安全方式:您始終可以在任何內容到達 Kanera 之前檢視計劃。

您批准後,座席將在一次通話中建立整個計劃,並設定每張卡片的標籤、指派人員和到期日期,並首先檢查每張卡片,以便在錯誤的標籤名稱或團隊成員出現之前停止批處理。 您的座席建立的卡片會由您自動監視,因此對它們的回覆會傳遞到您的通知中,並標記為"已完成 " 。 透過 <代理人>.

當座席在工作時接收回復

“在 DEV-938 上釋出遷移計劃，請@Priya 簽字，並在開始測試時繼續檢查她的回覆。” （更改Kanera）

代理在其評論中提到 Priya,並透過收件箱、電子郵件和推送通知她。 您的計算機上執行的代理沒有 Kanera 可以回電的地址,因此它每隔幾分鐘就會檢查您的通知。 notifications.list，只看到自上次檢視以來的新內容，並且沒有自己寫入的內容。當 Priya 回覆時，它會讀取評論並繼續。

無需選擇板即可捕獲提醒

“提醒我下週更新場地保險。” （更改Kanera）

當您沒有命名看板時,座席將該專案作為開放任務新增到 收件箱 您的私人資訊 便箋 後來,你會問"我的收件箱裡有什麼? " 來回讀,或者"勾選保險卡"來檢查。 當物品屬於團隊時,給它命名一個看板,代理人會在那裡建立一張卡片。

日期是按照您說出的方式來工作的。 "讓 MKT-42 明天下午 1 點到期"將明天設定為您自己的時區的下午到期時間,代理會告訴您它使用的日期。

在正確的時間返回卡片

“週五下午 3 點提醒我有關 MKT-42 的資訊。” （更改Kanera）

當您給已存在的卡片命名時,代理會設定一個私有 提醒 它會告訴你它在你自己的時區解決的確切時間,並且 Kanera 會在它到期時透過你選擇的渠道通知你一次。 您的卡提醒。提醒最多可提前八週。問“我有什麼提醒？”列出它們，或“清除我在 MKT-42 上的提醒”以刪除其中一個。 “Watch MKT-42”會跟隨卡的活動。

附上編碼會話的證據

“將失敗登入頁面的螢幕截圖和測試日誌附加到 DEV-938，然後總結日誌顯示失敗的內容。” （更改Kanera）

在您的計算機上工作的代理會獲取每個檔案的一次性上傳連結，並使用 curl，因此螢幕截圖和長日誌永遠不會透過聊天。然後它可以從卡上讀回日誌 cards.get_attachment，並檢視其他人附加的螢幕截圖，以回答有關他們的問題。

瞭解上下文的跨板搜尋

“找到所有提到支付遷移的卡片、註釋或評論，並告訴我哪些仍然處於開放狀態。”

MCP 搜尋涵蓋整個工作區的卡片、筆記、註釋和附件檔名。 代理不僅返回匹配項,還將其分組,告訴您已完成與已開啟的內容,並指向相關執行緒。

清潔和衛生

“在此工作區中列出分配的卡片，沒有截止日期，也沒有標籤，並根據描述建議每個卡片的優先順序標籤和實際截止日期。” （建議是隻讀的；應用它們會更改 Kanera）

代理會提出後設資料,以便您的看板保持可報告性。 批准批處理,它可以一次性設定標籤、到期日期和自定義欄位值。

從外部討論中保持卡片的最新狀態

“向‘SSO 部署’卡新增一條評論，總結此電子郵件執行緒，並將其移至“進行中”。” （更改Kanera）

代理人寫一個簡明的摘要評論並更新卡片的列表,這樣板反映了現實,沒有人手動重新輸入狀態。 透過 <代理人> 卡片的活動中有徽章,因此它仍然可審計。

如果您知道卡片金鑰,請直接使用它 : " 新增此摘要到 PLAT-42 當前金鑰、確切的歷史金鑰和標準化的 Kanera 卡連結都可以用作 MCP 卡參考。 標準化連結可消除同一金鑰在多個組織中可見的罕見情況。

將忙碌列表分割成部分

“在路線看板的待辦事項列表中，新增標題為“下一個版本”和“稍後”的藍色分隔符。將“下一個版本”放在 PLAT-42 之前，將“稍後”放在現有研究分隔符之後，然後將 PLAT-57 移至“下一個版本”下方。” （更改Kanera）

代理讀取看板的當前卡片和分隔器,解析所需的錨點,並在確切位置建立或移動每個一級分隔器。 卡片和分隔器共享一個排序通道,因此代理也可以將卡片相對於分隔器定位。 即使工作流列表與其他看板共享,分隔器也保持看板特定。

跨團隊的工作負載平衡

“在整個工作區中，顯示每個人未分配的工作。誰超載了，誰有空間，以及哪些卡片可以合理移動？”

邊界化團隊工作查詢會返回所選範圍內可見的分配、未分配、逾期和過時工作。 座席可以對整個團隊的負載進行推理,並提出重新平衡,然後在您的批准下重新分配特定卡片。 （重新分配更改 Kanera）

代理的跨板滾動

“給我一份該組織的交付摘要。按工作區和看板顯示活躍的、逾期的、即將到期的、未分配的和最近完成的工作，然後指出需要注意的領域。”

work.portfolio_summary 直接返回有界組織、工作區和看板卷積。 代理先讀取聚合,然後僅檢查需要支援詳細資訊的看板或卡片。 MCP,, 公眾 API, kanera portfolio, 和 kanera.work.portfolio() 2008年12月31日終了的兩年期收入和支出及準備金和基金結餘變動表 SDK. 它不需要一個組合網頁。

從您已經寫好的筆記草稿

“將我的‘第三季度入職改造’註釋變成一張具有清晰標題和 Markdown 描述的卡片，其中將步驟列出為清單。”

該 draft_card_from_notes 提示將Kanera筆記中的鬆散思維轉化為結構化、可操作的工作。

如何充分利用它的提示

• 保持無人值守憑據的範圍狹窄。 使用一個 閱讀 當自動化不應進行更改時，用於分類、摘要和搜尋的 API 金鑰或服務連線。個人 OAuth 具有讀/寫功能，因此請在 MCP 客戶端中配置工具許可權和確認。
• 先詢問計劃。 對於任何變化 Kanera, 請求草案或擬議的計劃, 審查它, 然後說"應用它 。 "
• 範圍要具體。 為看板、列表、工作區或人員命名,以便代理針對正確的資料。
• 讓它跨板工作。 最大的收穫來自單一板檢視無法回答的問題 — 工作量、跨專案搜尋和跨專案交付狀態。

有關設定、API 金鑰、作用域以及代理可以使用的資源和操作的完整列表,請參閱 將 Kanera 連線到您的 AI 代理, 的 技術參考，以及 工具庫存.