代理執行與操作歸屬
當人工智慧代理在 Kanera 中更改工作時,記錄會顯示這一資訊。 其評論、卡片更改和活動行會標記為代理的姓名和代理人,這樣就不會有人將代理輸出與團隊成員輸入的內容混淆。 運行：卡片上的實時標記，告訴團隊的其他成員工作已經完成。
如何歸因代理工作
Kanera 根據背後的憑據記錄誰執行了某個操作。
| 連線 | 如何顯示其工作 |
|---|---|
| OAuth，包括裝置程式碼 | 作為連線代理的人， 透過 <代理人> 代理名稱是 AI 客戶端註冊時使用的名稱,例如 Claude。 |
| 個人 API 金鑰 | 作為鑰匙的所有者，沒有代理標籤。您使用自己的金鑰執行的指令碼會按您的方式讀取。 |
| 無人值守代理 或 workspace/board API 金鑰 | 根據連線或金鑰名稱,而不是作為一個人。 |
區別在於互動式 OAuth 授權,而不是傳輸。 Kanera CLI 支援兩者: 瀏覽器登入 kanera auth login --agent "Claude Code" 標籤工作 透過代理商，而 API-key 登入則將其記錄為金鑰的所有者或金鑰。參見 在終端中使用程式設計代理 瞭解這對終端工作流程的影響。
透過徽章
在卡片的活動資訊源中,代理人寫的評論保留了人物的姓名和頭像,並新增了 透過 <代理人> 懸停徽章可檢視評論者及其所代表的使用者,例如: 作者 Claude 代表Amelia Hart。更換卡時，代理人必須攜帶相同的徽章，並帶有 由.代表.簽署 工具提示。
代理工作仍受關聯人角色的約束。 Kanera 每次寫入都會檢查其當前對目標板的訪問許可權，因此代理無法執行其人員無法執行的任何操作。
代理執行
一次執行是一個代理在一張卡上的工作會話。這是代理在開始多步驟工作之前宣佈“我正在處理此事”的方式，以及報告進度和結果的方式。
開始跑步
代理開始執行 runs.start MCP 工具, 給卡片一個簡短的工作標題, 並且可以選擇一個更長的進度說明和一個連結, 讓人們可以跟進, 如一個 pull 請求或會話日誌. 從 shell, 同樣的工具是 kanera run start <card> "<title>", 與 kanera run update 以及 kanera run done 整合可以使用以下方法: POST /api/v1/cards/{cardId}/agent-runs 2008年12月31日終了的兩年期收入和支出及準備金和基金結餘變動表 公共 API.
啟動或更新執行需要卡板上的編輯器訪問許可權和可寫憑據。 只讀金鑰或觀察者不能開啟執行。
在開始之前，代理應致電 runs.list 用於檢查另一個代理是否已經在處理卡片,恢復其自身的實時執行以執行相同任務,或者在執行重疊工作之前報告另一個代理的實時執行衝突。 includeEnded.
卡片牌上的晶片
當執行正在進行時,卡片瓷磚在標題前面顯示一個小小的閃爍晶片。 懸停在它上面,或使用螢幕閱讀器閱讀它,以檢視代理和工作:
- 工作： <代理> 正在工作：<標題>
- 等待一個人: <代理>正在等你：<標題>，晶片變成琥珀色。
如果卡片上有多個執行,標籤將命名第一個執行並新增 （+N更多）。該晶片會為每個檢視棋盤的人實時更新，並在執行結束時消失。
執行狀態
| 現狀 | 設定時間 | 意味著什麼 |
|---|---|---|
running | 代理人 | 工作,每次跑步都從這裡開始。 |
blocked | 代理人 | 等待一個人,如一個問題或一個批准。 晶片變成琥珀色,卡詳細顯示 等待著你. |
succeeded | 代理人 | 完成，結束執行。 |
failed | 代理人 | 無法完成工作。 終止執行。 |
cancelled | 代理人 | 故意停止，結束執行 |
stalled | Kanera | 代理停止報告。 |
running 以及 blocked 他們之間的關係,是一種不斷的交流,是一種不斷的交流。 runs.update，將有關當前正在執行的操作的摘要保留在一行中。 succeeded, failed, 和 cancelled end the run permanently: 終止的執行不能被更改,並且進一步的更新將被拒絕。
設定一個執行到 blocked 該卡不會自動傳送通知給任何人。 如果代理需要特定的人,它還應該在卡上留下一個註釋,說明它正在等待什麼。
停頓執行
每 runs.update Kanera每分鐘檢查一次是否有無聲執行,並標記一個實時執行,這樣就可以確定是否有無聲執行。 stalled 沒有一個人能夠在這裡停下來, runs.update 該工具告訴代理至少每隔十分鐘報告一次。
停止執行不再顯示晶片或出現在卡的 代理執行 卡片的活動源記錄它作為Kanera標記代理的執行為停滯。 停滯的執行並不關閉:代理可以返回並以終端狀態完成它,或將其設定為停止執行。 running 恢復。
代理工作流程模板
如果您將看板的大部分工作交給代理,請從下面開始工作區: 代理工作流程 模板的列表跟隨執行的壽命,因此板本身顯示代理正在做什麼:
| 列表 | 它所擁有的 |
|---|---|
| Backlog | 工作準備好交給代理。 |
| 代理工作 | 代理人有一個 running 卡上執行。 |
| 等我 | 代理設定其執行 blocked 執行摘要說明了它需要什麼,並且需要你做出決定。 |
| 審查 | 工作準備好了,可以供你稽核。 檢查結果,通常是 pull request。 拉取請求 外地。 |
| 完成 | 你接受了工作。 Kanera標記卡片完成。 |
代理人在移動卡片之前記錄原始列表,然後在移交前重讀卡片和看板。 他們考慮原始列表、當前可用的列表及其含義、完成的工作和剩餘的工作,並選擇反映卡片在該看板工作流程中的實際狀態的列表。 返回原始列表可能是適當的,但不是自動的。 列表名稱和順序並不規定目的地。
成功的執行可能只覆蓋卡的一部分。僅當商定的工作流程允許並且滿足其標準時，代理才能完成卡片；該模板預設為人類接受。在最終答覆之前，他們會發布包含更改、驗證、連結、剩餘工作和路由原因的結果評論，適當結束執行，並驗證儲存的更新。只讀和探索性請求不會導致跟蹤寫入，並且顯式使用者限制優先。
模板還新增了 特色, 錯誤, 雜務, 和 研究 組織管理員的代理可以為您建立工作區,併為您提供管理員的工作流程。 workspaces.create 以及 templateId: "agent-workflow".
執行在卡詳細資訊和活動
開啟一個卡片,有一個現場執行和一個 代理執行 每個執行都顯示其標題、代理、狀態(如果存在)和執行狀態。工作 或 等待著你），上次報告的時間以及最新的進度說明。
當一個執行結束時,它會從該部分中消失,結果將成為卡片活動源中的一行,例如: 完成: <title> — <閉幕摘要>, 或 失敗 或 取消 結束摘要是代理在結束執行時留下的筆記,因此請代理將其作為發生了什麼事的有用記錄。
執行的開始是記錄的,但卡片進給不會重複它;實時部分是飛行中工作的顯示位置。
關於代理工作的通知
Kanera 通常不會向您傳送有關您自己的操作的通知。 您的代理透過 OAuth 完成的工作是例外:您會收到通知,就像您會收到有關您所觀察或分配的卡片上的團隊成員工作的通知一樣,因為委託工作與觀察工作發生並不相同。
一旦代理為您採取行動,通知抽屜會顯示一個 代理 旁邊的標籤 未讀 以及 全部。它列出了您的客服人員所做的事情、未讀通知以及過去 7 天內已讀的通知，其標籤包含未讀計數，例如 代理 (1)。每個通知都帶有 透過 <代理人> 當您按使用者對通知進行分組時,座席的工作會形成自己的組,並標記為 <人> 透過 <代理> 而不是融入你的世界。
開始和結束執行將記錄在卡片的 Activity 中,但不會傳送通知。 通知涵蓋代理人實際完成的操作,例如評論、移動和完成。
代理工作已完成
該 已完成工作 代理人生成的行在人旁邊顯示一個閃爍標記,其工具提示如下: 由 <person> 透過 <agent> 處理。當天摘要的頭像堆疊帶有相同的標記。
代理行不計為該人自己的工作。過濾成員完成的工作僅顯示該人自己的操作，因此一週的交付永遠不會悄悄地將代理的輸出計為某人的工作時間。
查詢代理活動
- 通知： 該 代理 選項卡是您的代理所做的一切事項的稽核佇列。
- 一張牌： 卡片的活動提要顯示 透過 <代理人> 代理可以透過以下方式閱讀完整的執行歷史記錄:
runs.list以及includeEnded. - 整合： 網路掛鉤 交付
agentRun:started以及agentRun:updated對代理工作做出反應的自動化事件。
活動源或已完成工作中沒有面向整個論壇的座席活動過濾器。