larksuite / larksuite/cli

[Base] Agent 无法创建自动化中心的轻量流程(定时提醒 / cron 发群)

Open
#2,411 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

bug domain/base domain/im
Dominant language
Go
Stars
17.3k
Forks
1.4k
Avg merge
2d 4h
Merged PRs (30d)
105

Description

Summary

Agent 需要给其他 Agent 配 定时提醒 / cron 发群。飞书多维表格里这件事对应的是右上角「自动化」→ 自动化中心 的轻量「自定义流程」(当…就…),不是侧边栏那种重 工作流

lark-cli base +workflow-* 只覆盖后者。公开 OpenAPI 对前者只能 list / Enable / Disable,不能创建 trigger + action。所以 Agent 没法用 CLI 把 cron/reminder 落到飞书里。

Discussions 已关闭,所以开 Issue。仓库里搜过 自动化流程 / 自动化中心 / TimerTrigger / cron / reminder,没有同一缺口的 Issue 或 PR。邻近 Issue 是 #1708(工作流消息版本)和 #1548(+workflow 的 FindRecord 回读),都假定走重工作流。

两个产品

同一张 Base 上同时存在:

自动化中心(轻) 工作流(重)
UI 右上角「自动化」→ 自动化中心 侧边栏工作流 block
形态 「当以下情况发生时 → 就执行以下操作」 画布:AI Agent / MCP / 多步分支
ID 数字,如 7671894421202325109 wkf 前缀
列出 GET /open-apis/bitable/v1/apps/:app_token/workflows POST /open-apis/base/v3/bases/:base_token/workflows/list(即 +workflow-list
创建 没有公开 create +workflow-createPOST /open-apis/base/v3/bases/:base_token/workflows

+workflow-list 的 tip 也写了只返回 wkf ID。实测同一 Base:+workflow-list 只有 1 条重工作流;v1 workflows 能列出 9 条轻量流程,其中 2 条已启用。

真实场景

要的是这种轻量流程,不是重工作流:

  1. TimerTrigger,每天 10:30 / 17:00
  2. LarkMessageAction,发到指定群
  3. 正文里点名其他 Agent(例如 Alice、Zayn),让它们按约定执行

推荐模板里现成的就是:

  • 定时触发 → 发送飞书消息
  • 到达记录中的时间时 → 发送飞书消息(Reminder)
  • 添加/修改记录时 → 发送飞书消息

这类流程在 UI 里两步就能配完。+workflow-create 会做出另一类资源(wkf…,默认关闭,还要拼完整 steps JSON),Agent 用它当 cron 过重,也进不了自动化中心列表。

当前能力边界

公开文档:

没有「创建自动化流程」接口。CLI 也没有对应 shortcut。

lark-cli api GET /open-apis/bitable/v1/apps/:token/workflows 能列出轻量流程,但创建仍只能手点 UI。

期望

  1. OpenAPI 能创建轻量自动化流程,至少覆盖:
    • TimerTrigger(每天 / 每周 / 工作日 + 时刻)
    • ReminderTrigger(日期字段到期提醒)
    • LarkMessageAction(发到指定群或人,正文可含 @/人名)
  2. CLI 有 typed shortcut,例如 +automation-create / +automation-list,和现有 +workflow-* 分开,避免 Agent 把两套资源当成同一个。
  3. 文档写清:自动化中心流程 ≠ 工作流;wkf ID 和数字 workflow_id 不能混用。
  4. 新建后能 +automation-enable,并返回可回读的 trigger/action。

最小可跑通的 Agent 任务:

每天 10:30,往群 oc_xxx 发一条:「Alice, Zayn 请执行今日 cron」

Agent 应能一条 CLI/API 完成创建并启用,不必再打开自动化中心。

建议

如果短期不能把自动化中心的 create 开放出来:

  • 文档和 +workflow-* help 明确写:这是 工作流,不是自动化中心的轻量流程;
  • 说明 Agent 要做 cron/reminder 时该走哪条路(或明确「目前只能 UI」)。

否则 Agent 会继续用 +workflow-create 误建重工作流,或卡在「只能 list、不能 create」。

Environment

  • lark-cli 1.0.86(当时最新 1.0.88)
  • 身份:--as user
  • 对照过 shortcuts/base/workflow_list.go / workflow_create.go:走的是 Base v3 wkf 工作流,不是 bitable v1 自动化流程

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading shortcuts/base/workflow_list.go and workflow_create.go, then compare their Base v3 endpoints with the documented bitable v1 automation endpoints in the issue. Confirm whether a supported create operation exists; done means the scope clearly distinguishes automation-center flows from wkf workflows and provides the requested typed CLI path, or documents the current UI-only limitation.

Written by the indexing model from the issue text.

Assessment

Tech stack
go
Domain
api, cli
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.