AI assist admin half: field actions with streaming, and usage (A-38)

未关闭
#3,426 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
5/5
预计耗时
一周以上
新手友好度
35/100
Issue 类型
功能
描述清晰度
基本清楚
活跃度
活跃
技术栈
csharp
领域
ai, api, full-stack, testing

调研方向

Start with docs/planning/admin-technical-spec.md, sections 5.1, 5.5 and 10.7, then read the A-51 admin stub and the AI plugin endpoints /ai/actions/{action}, /ai/fields and /ai/usage. The issue describes work across the admin form, streaming action panel, usage page, settings and tests, with dependencies on A-51 and A-34. Done means the acceptance criteria pass, including the sample field action, OpenAPI checks and an end-to-end accepted suggestion.

由索引模型根据 Issue 内容生成。

描述

area:admin type:feature

Problem

Rows 9.14 and 9.15 ask that an editor runs AI actions on the fields a site opted in, and sees the usage. The AI assist plugin has /ai/actions/{action}, /ai/fields and /ai/usage, and its admin half is the stub of A-51. The form has no place for a field action either: FieldActionBase and [FieldAction] are in the contract and the manifest since A-18, and nothing draws, gates or loads one.

Proposal

The form's side, in FluentCMS.Admin (5.1). A field whose type a field action of an enabled half names gets a menu of those actions, for a caller who holds the action's permission. The half loads when the menu is first opened. An action answers a FieldActionResult that leaves the draft or replaces the field's value as an unsaved change; it never saves or publishes.

The half FluentCMS.Plugins.AiAssist.Admin (5.5):

  • The actions (rewrite, shorten, expand, fix grammar, title, summary, SEO, translate) on the fields that GET /ai/fields names for the site, for a caller who holds ai.use. The suggestion streams into a panel (text/event-stream) and goes into the draft only when the user accepts it.
  • A refusal before the provider is a problem as any other; one after the stream began is its error event. Both are shown in the panel, and the draft is left as it was.
  • The daily budget of the site (FCMS1693, a 429) is shown with the problem's own text, and is not sent again as the client sends another 429 again.
  • Alt text: the server takes altText for an opted-in text field with options.mediaId, so the action is offered on such a field with the images of the entry's media fields to choose from. Alt text of the asset itself waits for #3418.
  • /ai/usage, for ai.usage.read: the usage read in pages, with filters by principal, action and time, and the totals of the filter. A principal shows by its id until #3418.
  • The settings of ai are the generated page of A-34, with the key as a secret.
  • The half's records are checked against the OpenAPI document.

Acceptance

  • On an opted-in field an editor runs an action, sees the suggestion arrive in parts, accepts it and finds it in the draft as an unsaved change; declined, the draft is unchanged
  • A field that is not opted in, a site with AI assist off and a caller without ai.use show no action, and the half is not fetched
  • A refusal before the stream, an error within it and the daily budget each show their reason and leave the draft as it was
  • Alt text is suggested for an image of the entry on an opted-in text field
  • The usage page lists and filters the usage of the site
  • The sample half's field action shows in the form through the same seam
  • Component tests cover the menu, the panel and the stream against a fake; the API tests check the records against the OpenAPI document and run an action against a stand-in of the provider; an end-to-end case accepts a suggestion

Design: docs/planning/admin-technical-spec.md, sections 5.1, 5.5 and 10.7 (A-38). Rows 9.14, 9.15. Needs A-51, and A-34 for the settings page; #3101, #3103 and #3104 are merged; #3418 for alt text of an asset and for names in the usage. Size: M.

主要语言
C#
星标
567
派生
107
平均合并
1 小时 19 分钟
30 天内合并 PR
353

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

fluentcms/FluentCMS 的其他 Issue

查看 fluentcms/FluentCMS 的全部 Issue

相似的 Issue

更多 C# Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。