如何使用 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 代理, 的 技术参考，以及 工具库存.