{"id":26891177,"url":"https://github.com/delldi/openai-agents-workflow-designer","last_synced_at":"2026-04-07T22:32:24.290Z","repository":{"id":285426129,"uuid":"958104423","full_name":"DellDi/openai-agents-workflow-designer","owner":"DellDi","description":"一个可视化工具，帮助用户设计、配置和生成基于OpenAI Assistants API的多代理工作流系统","archived":false,"fork":false,"pushed_at":"2025-03-31T16:50:38.000Z","size":77,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-31T17:48:08.034Z","etag":null,"topics":["monaco-editor","react","react-flow","typescript","vite","zustand"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DellDi.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-31T16:45:23.000Z","updated_at":"2025-03-31T16:50:41.000Z","dependencies_parsed_at":"2025-03-31T17:48:30.318Z","dependency_job_id":"9efe66a7-73dd-4ea6-857a-340f2b455ab4","html_url":"https://github.com/DellDi/openai-agents-workflow-designer","commit_stats":null,"previous_names":["delldi/openai-agents-workflow-designer"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DellDi%2Fopenai-agents-workflow-designer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DellDi%2Fopenai-agents-workflow-designer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DellDi%2Fopenai-agents-workflow-designer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DellDi%2Fopenai-agents-workflow-designer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DellDi","download_url":"https://codeload.github.com/DellDi/openai-agents-workflow-designer/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246553027,"owners_count":20795835,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["monaco-editor","react","react-flow","typescript","vite","zustand"],"created_at":"2025-03-31T22:33:11.634Z","updated_at":"2026-04-07T22:32:24.242Z","avatar_url":"https://github.com/DellDi.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OpenAI Agents 工作流设计器\n\n一个可视化工具，帮助用户设计、配置和生成基于OpenAI Assistants API的多代理工作流系统。\n\n\n![版本](https://img.shields.io/badge/版本-1.0.0-blue.svg)\n![TypeScript](https://img.shields.io/badge/TypeScript-5.2-blue.svg)\n![React](https://img.shields.io/badge/React-18.2-61dafb.svg)\n![Vite](https://img.shields.io/badge/Vite-4.5-747bff.svg)\n\n## ✨ 功能特点\n\n- 🧩 **拖拽式界面**: 基于React Flow构建的直观拖拽式界面\n- 🤖 **多节点类型**: 支持Agent、Runner、Function Tool和Guardrail四种节点类型\n- 🔗 **智能连接验证**: 内置节点连接规则验证，确保工作流逻辑合理\n- 📝 **动态配置面板**: 根据节点类型提供不同的配置选项\n- 📊 **可视化编辑**: 节点展开/折叠功能，提高工作区利用率\n- 💻 **代码生成**: 自动生成可执行的OpenAI Assistants API代码\n- 🚀 **快速开始模板**: 提供预设模板快速创建常见工作流\n\n## 🚀 开始使用\n\n### 安装依赖\n\n```bash\npnpm install\n```\n\n### 启动开发服务器\n\n```bash\npnpm dev\n```\n\n### 构建生产版本\n\n```bash\npnpm build\n```\n\n## 💡 使用指南\n\n1. 从左侧侧边栏拖动节点到画布上\n2. 配置节点属性（名称、说明、参数等）\n3. 连接节点，创建工作流\n4. 点击\"生成代码\"按钮，获取可执行的API代码\n\n## 🔧 技术栈\n\n- React + TypeScript\n- React Flow (流程图可视化)\n- Ant Design (UI组件)\n- Zustand (状态管理)\n- Monaco Editor (代码编辑器)\n- Tailwind CSS (样式)\n\n## 📝 更新日志\n\n请参阅[CHANGELOG.md](./CHANGELOG.md)了解详细的版本更新历史。\n\n## 📄 许可证\n\nMIT\n\n## 📋 技术栈\n\n- **前端框架**: React 19+\n- **状态管理**: Zustand\n- **工作流编辑器**: React Flow\n- **代码编辑器**: Monaco Editor\n- **UI样式**: TailwindCSS\n- **构建工具**: Vite + TypeScript\n\n## 🛠️ 项目结构\n\n```\nsrc/\n├── components/          # 组件目录\n│   ├── Canvas/          # 画布相关组件\n│   ├── Nodes/           # 节点组件\n│   ├── Edges/           # 连接线组件\n│   ├── Sidebar/         # 侧边栏组件\n│   └── ConfigPanel/     # 配置面板组件\n├── store/               # 状态管理\n├── types/               # TypeScript类型定义\n├── utils/               # 工具函数\n│   └── codeGenerator.ts # 代码生成器\n└── App.tsx              # 主应用组件\n```\n\n## 📦 节点类型\n\n1. **Agent节点** - OpenAI Agents的核心组件\n   - 配置name、instructions等属性\n   - 可连接到其他Agent建立handoff关系\n   - 可连接Function Tool获取工具能力\n\n2. **Runner节点** - 执行Agent的运行器\n   - 配置输入内容和执行模式(同步/异步)\n   - 连接到Agent节点进行执行\n\n3. **Function Tool节点** - 自定义工具函数\n   - 定义参数和返回类型\n   - 编写函数实现逻辑\n   - 连接到Agent作为工具使用\n\n4. **Guardrail节点** - 定义Agent的守护规则\n   - 配置输出模型和守护函数\n   - 连接到Agent实现输入验证\n\n## 🚀 开始使用\n\n1. 安装依赖\n```bash\npnpm install\n```\n\n2. 启动开发服务器\n```bash\npnpm dev\n```\n\n3. 构建生产版本\n```bash\npnpm build\n```\n\n## 📝 使用方法\n\n1. 从左侧组件面板拖放节点到画布\n2. 点击节点进行配置，设置相关属性\n3. 通过连接点建立节点之间的关系\n4. 点击右上角的\"生成代码\"按钮查看生成的Python代码\n5. 复制代码到你的项目中使用\n\n## 📊 工作流程图\n\n```mermaid\ngraph TD\n    A[拖放组件到画布] --\u003e B[配置节点属性]\n    B --\u003e C[连接节点建立关系]\n    C --\u003e D[点击生成代码]\n    D --\u003e E[复制代码到项目]\n```\n\n## 📄 示例代码\n\n设计工具生成的代码示例：\n\n```python\nfrom agents import Agent, Runner\nimport asyncio\nfrom agents import function_tool\n\n@function_tool\ndef get_weather(city: str) -\u003e str:\n    return f\"The weather in {city} is sunny.\"\n\nagent = Agent(\n    name=\"Helper\",\n    instructions=\"You are a helpful assistant.\",\n    tools=[get_weather]\n)\n\nasync def main():\n    result = await Runner.run(agent, \"What's the weather in Tokyo?\")\n    print(result.final_output)\n\nif __name__ == \"__main__\":\n    asyncio.run(main())\n```\n\n## 📅 更新日志\n\n### [1.0.0] - 2025-03-31\n* 初始版本发布\n* 支持基本的Agent、Runner、Function Tool和Guardrail节点\n* 实现拖放式界面和代码生成功能\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdelldi%2Fopenai-agents-workflow-designer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdelldi%2Fopenai-agents-workflow-designer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdelldi%2Fopenai-agents-workflow-designer/lists"}