代理运行与操作归属
当人工智能代理在 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对代理工作做出反应的自动化事件。
活动源或已完成工作中没有面向整个论坛的座席活动过滤器。