エージェントの実行と帰属
AI エージェントがKaneraで仕事を変えると、記録にそのように記録されます。そのコメント、カードの変更、およびアクティビティの行には、エージェントの名前とその代理人がラベル付けされるため、エージェントの出力をチームメイトが入力したものと間違える人はいません。エージェントがカードを処理している間、カードを開くことができます。 実行: カード タイル上のライブ マーカー。作業がすでに完了していることをチームの残りのメンバーに知らせます。
エージェントの仕事の帰属方法
Kanera は、その背後にある資格情報に基づいてアクションを実行したユーザーを記録します。
| 接続 | その働きがどのように現れるか |
|---|---|
| OAuth、デバイスコードを含む | エージェントに接続した人として、 <agent>経由 バッジ。エージェント名は、AI クライアントが登録した名前 (Claude など) です。 |
| 個人用APIキー | キーの所有者として、エージェント ラベルなし。独自のキーを使用して実行するスクリプトは、あなたとして読み取られます。 |
| 無人エージェント または ワークスペース／ボードのAPIキー | 個人としてではなく、接続名またはキー名で。 |
違いは、トランスポートではなく、インタラクティブな OAuth 許可です。の Kanera CLI 両方をサポート: ブラウザーでのサインイン kanera auth login --agent "Claude Code" ラベルは機能します エージェント経由一方、API キー サインインでは、API キーがキーの所有者またはキーとして記録されます。参照 ターミナルからコーディング エージェントを操作する それが端末のワークフローにどのような影響を与えるかについて。
経由バッジ
カードのアクティビティ フィードでは、エージェントが書いたコメントによって、その人の名前とアバターが保持され、 <agent>経由 その横にバッジ。バッジにカーソルを合わせると、誰が誰に向けてコメントを書いたかが表示されます。 アメリア・ハートに代わってクロードが執筆。カードを変更すると、エージェントは同じバッジを携帯するようになり、 …に代わって…が実行 ツールチップ。
エージェントの作業は、引き続き接続者の役割の影響を受けます。 Kanera は書き込みごとにターゲット ボードへの現在のアクセスをチェックするため、エージェントはその人ができないことを行うことはできません。
エージェントの実行
実行とは、1 つのカード上での 1 つのエージェントの作業セッションです。これは、エージェントが複数のステップの作業を開始する前に「これに取り組んでいます」と宣言する方法と、進捗状況と結果を報告する方法です。
ランニングを開始する
エージェントは次のコマンドを使用して実行を開始します。 runs.start MCP ツール。カード、作業の短いタイトル、およびオプションでプル リクエストやセッション ログなど、ユーザーがたどることができる長い進行状況メモとリンクを提供します。シェルからは同じツールを使用できます。 kanera run start <card> "<title>"、と kanera run update そして kanera run done 結果を報告して終了します。連携では次を使えます： POST /api/v1/cards/{cardId}/agent-runs で パブリックAPI.
実行を開始または更新するには、カードのボードに対する編集者アクセス権と書き込み可能な資格情報が必要です。読み取り専用キーまたはオブザーバーは実行を開くことができません。
開始する前に、エージェントは電話する必要があります runs.list 別のエージェントがカードに対応していないか確認し、同じタスクの自分の実行を再開するか、重複作業を始める前に他のエージェントとの実行競合を報告します。通常は実行中のものを返し、次を指定するとカードの全実行履歴を返します： includeEnded.
カードタイル上のチップ
ランがライブ中、カード タイルにはタイトルの前に小さな輝きのチップが表示されます。カーソルを置くか、スクリーン リーダーで読んで、エージェントと作業を確認します。
- 作業中: <エージェント> は動作しています: <タイトル>
- 人を待っています: <エージェント> があなたを待っています: <タイトル>、チップがオレンジ色に変わります。
カード上に複数の実行が存在する場合、ラベルは最初の実行に名前を付けて追加します。 (+N 個以上)。チップはボードを閲覧している全員に対してリアルタイムで更新され、実行が終了すると消えます。
実行状態
| ステータス | 設定者 | それが何を意味するか |
|---|---|---|
running | エージェント | 働いています。すべてのランニングはここから始まります。 |
blocked | エージェント | 質問や承認など、人を待つこと。チップがオレンジ色に変わり、カードの詳細が表示されます お待ちしています. |
succeeded | エージェント | 完了しました。実行を終了します。 |
failed | エージェント | 作業を完了できませんでした。実行を終了します。 |
cancelled | エージェント | 故意に止めた。実行を終了します。 |
stalled | Kanera | エージェントは報告を停止しました。 |
running そして blocked ライブでチップを見せます。エージェントはそれらの間を移動し、進捗状況を報告します。 runs.update、現在何を行っているかについての概要を 1 行にまとめます。 succeeded, failed、そして cancelled 実行を永久に終了します。終了した実行は変更できず、それ以降の更新は拒否されます。
実行の設定 blocked チップを変更します。それ自体は誰にも通知を送信しません。エージェントが特定の人を必要とする場合は、何を待っているかを示すコメントをカードに残す必要もあります。
停止した実行
毎 runs.update 呼び出しは、何も変化しないものも含めてハートビートとしてカウントされます。 Kanera はサイレント ランを毎分チェックし、ライブ ランをマークします stalled 心拍が無い状態が 15 分間続いた場合。の runs.update ツールは、少なくとも10分ごとに報告するようエージェントに指示します。
停止した実行ではチップが表示されなくなるか、カードの画面に表示されなくなります。 エージェントの実行 したがって、クラッシュしたエージェントがカードをビジー状態のままにすることはできません。カードのアクティビティ フィードには、Kanera がエージェントの実行が停止しているとマークしていることが記録されます。ただし、停止した実行は終了しません。エージェントは戻ってきて終了ステータスで終了することも、終了ステータスを次のように設定することもできます。 running 再開します。
エージェントワークフローテンプレート
ボードの作業のほとんどをエージェントに任せる場合は、ワークスペースを エージェントのワークフロー テンプレートです。リストが実行のライフサイクルに沿っているため、ボードを見るだけでエージェントの状況がわかります：
| リスト | 保持しているもの |
|---|---|
| バックログ | エージェントに渡す準備ができた作業。 |
| エージェントの作業 | エージェントには、 running カード上で実行します。 |
| ウェイティング・オン・ミー | エージェントはその実行を次のように設定しました blocked そしてあなたの決定が必要です。実行の概要には、必要なものが記載されています。 |
| レビュー | 作品をレビューしていただく準備ができました。結果を確認します。多くの場合、 プルリクエスト フィールド。 |
| 完了 | あなたはその仕事を引き受けました。Kaneraはカード完了をマークします。 |
ランが単独でカードを移動したり完成させたりすることはありません。エージェントはカードを移動する前に元のリストを記録し、引き継ぎの前にカードと搭乗を再読み取りします。元のリスト、現在利用可能なリストとその意味、完了した作業と残りの作業を考慮し、そのボードのワークフローにおけるカードの実際の状態を反映するリストを選択します。元のリストに戻ることが適切な場合もありますが、自動的には戻りません。リストの名前と順序は宛先を規定するものではありません。選択が不明瞭な場合は、リストを変更せずに残し、他の追跡更新を保存して尋ねます。
実行が成功すると、カードの一部のみがカバーされる場合があります。エージェントは、合意されたワークフローで許可され、その基準が満たされた場合にのみカードに記入します。このテンプレートはデフォルトで人間に受け入れられるように設定されています。最終的な返信の前に、変更、検証、リンク、残りの作業、ルーティングの理由を含む結果コメントを投稿し、実行を適切に終了し、保存された更新を確認します。読み取り専用リクエストと探索的リクエストでは追跡書き込みは行われず、明示的なユーザー制限が優先されます。
テンプレートにも追加されます 特徴, バグ, 雑用、そして 研究 ラベルと、フローを説明するスターター カード 1 枚。組織管理者のエージェントは、次の方法でワークスペースを作成できます。 workspaces.create そして templateId: "agent-workflow".
カードの詳細とアクティビティで実行されます
ライブランと エージェントの実行 セクションは説明のすぐ下に表示されます。実行ごとに、タイトル、エージェント、ステータス (働く または お待ちしています)、最後に報告した日、および最新の進捗状況メモ。
このセクションにはライブ実行のみが表示されます。実行が終了すると、実行は実行から消え、結果はカードのアクティビティ フィードの行になります。 終了: <タイトル> — <最後の要約>、または 失敗しました または キャンセルされました 他のエンディングについては。最終概要は、エージェントが実行を終了したときに残したメモであるため、エージェントに、何が起こったのかを有用な記録にするよう依頼してください。
実行の開始は記録されますが、カード フィードはそれを繰り返しません。ライブセクションでは、飛行中の作業が表示されます。
エージェント業務に関するお知らせ
Kanera は通常、自分の行動に関する通知を無視します。エージェントが OAuth 経由で行った作業は例外です。作業を委任することは、その作業が行われるのを監視することと同じではないため、監視または割り当てられているカードに対するチームメイトの作業について通知されるのと同じです。
エージェントがあなたのために行動すると、通知ドロワーは エージェント 横のタブ 未読 そして すべて。ここには、エージェントの行動、未読通知と過去 7 日間に読まれた通知がリストされ、そのラベルには未読数が表示されます。 エージェント(1)。各通知には次の内容が含まれます <agent>経由 バッジ。通知をユーザーごとにグループ化すると、エージェントの作業は、ラベル付きの独自のグループを形成します。 <担当者> 経由 <エージェント> あなたのものに融合するのではなく。
実行の開始と終了はカードのアクティビティに記録されますが、通知は送信されません。通知には、コメント、移動、完了など、エージェントが実際に行った内容が含まれます。
「Work Done」でのエージェントの作業
の 完了した作業 ビューでは、エージェントの成果と人自身の作業を区別します。エージェントが作成した行には人の名前の横にきらめきマークが付き、ツールチップには次のように表示されます： <担当者> が <エージェント> 経由で作業しました。その日のサマリーのアバタースタックには同じマークが付いています。
エージェントの行はその人自身の作業としてカウントされません。メンバーが行った作業をフィルタリングすると、そのメンバー自身のアクションのみが表示されるため、1 週間の配信がエージェントの成果物を誰かの時間として黙ってカウントすることはありません。
エージェントアクティビティの検索
- 通知: 対象の エージェント タブは、エージェントが行ったすべての作業のレビューキューです。
- カード 1 枚: カードのアクティビティフィードに表示されます： <agent>経由 バッジと終了したラン。エージェントは次のコマンドを使用して完全な実行履歴を読み取ることができます。
runs.listそしてincludeEnded. - 統合: Webhook 届ける
agentRun:startedそしてagentRun:updatedエージェントの作業に反応する自動化のイベント。
アクティビティ フィードまたは作業完了には、エージェント アクティビティに対するボード全体のフィルタがありません。