a2ui-project / a2ui-project/a2ui

Allow agent and client codebases to have a shared Catalog API source of truth e.g. catalog.json

未關閉
#1,810 0 則留言 0 個 reaction 已指派 0 人 在 GitHub 檢視
component: standard catalog specification P2 status: first-line-handled type: feature/enhancement
主要語言
TypeScript
星號
16.4k
分支
1.3k
平均合併
3 天 15 小時
30 天內合併 PR
134

描述

From @zeroasterisk in https://github.com/a2ui-project/a2ui/issues/825:

> 3. No shared catalog schema
> Client and agent must independently define component names/properties. No way to auto-generate agent prompts from client catalog.
>
> Suggestion: A catalog.json schema file consumed by both sides.

Filing this issue specifically about this part.

Some ideas:
- Have developer programmatically define the catalog API in client code, then "export" it somehow to JSON document that gets pasted into the server codebase, perhaps through some NPM tooling

- Have a way to codegen the catalog implementation stubs from a JSON file, which is used by both server and client codebases.

貢獻指南

開啟貢獻指南

研究方向

在 client 和 agent 兩個程式碼庫中尋找現有的目錄定義,以了解目前的重複情況。調查 catalog API 目前是如何定義和使用的。確定一種產生或共用單一 schema (catalog.json) 的方法,讓雙方都能使用該 schema,也可以考慮使用程式碼產生工具。目標是擁有一個共用的單一事實來源,消除各自獨立的定義。

由索引模型根據 Issue 內容生成。

評估

技術堆疊
json, typescript
領域
api, tooling
Issue 類型
功能
難度
4/5
預估耗時
3-5 天
活躍度
冷清
描述清晰度
基本清楚
新手友好度
45/100

把新 issue 寄到你的電子郵件信箱

精選適合新手參與的 GitHub issue 摘要。