Miyagi社区指南：贡献代码与参与智能应用开发讨论

Miyagi社区指南贡献代码与参与智能应用开发讨论【免费下载链接】miyagiSample to envision intelligent apps with Microsofts Copilot stack for AI-infused product experiences.项目地址: https://gitcode.com/gh_mirrors/mi/miyagiMiyagi是基于Microsoft Copilot stack构建的智能应用开源项目旨在通过Semantic Kernel、Prompt Flow等技术实现AI驱动的产品体验。本文将详细介绍如何参与Miyagi社区贡献从代码提交到开发讨论帮助新手快速融入社区并贡献价值。为什么参与Miyagi社区Miyagi项目展示了企业级智能应用的完整开发流程涵盖从 prompt 工程到向量存储、从 agent 编排到插件开发的全栈技术。参与贡献不仅能提升AI开发技能还能接触到前沿技术实践Semantic Kernel 内存编排、Azure OpenAI 模型微调、多模态交互等企业级架构设计云原生微服务、事件驱动架构、向量数据库集成真实业务场景财务助手、代码现代化、智能推荐等落地案例图Miyagi的多agent架构展示了如何通过Copilot stack实现复杂业务场景贡献前的准备工作开发环境搭建克隆仓库git clone https://gitcode.com/gh_mirrors/mi/miyagi环境要求.NET 7 和 Python 3.10Azure CLI (安装指南)Docker 和 Kubernetes 工具链可选用于服务部署配置文件复制示例配置并修改为本地环境cp services/recommendation-service/dotnet/config/appsettings.json.azure-example services/recommendation-service/dotnet/config/appsettings.json了解项目结构Miyagi采用模块化设计核心目录功能如下services/微服务实现推荐服务、用户服务等agents/AI代理逻辑AutoGen、Assistants API等sandbox/实验性代码和用例示例deploy/部署配置Terraform、Kubernetes manifests图Miyagi使用的Copilot Stack技术栈集成了Semantic Kernel、Prompt Flow等核心组件贡献代码的完整流程1. 选择贡献方向Miyagi欢迎多种形式的贡献代码功能实现新特性或修复bug查看 issues文档完善补充教程或API说明编辑 docs/ 目录下文件测试用例为现有功能添加单元测试参考 services/recommendation-service/dotnet/示例扩展新增Jupyter Notebook示例添加到 sandbox/experiments/2. 提交代码的标准流程创建分支git checkout -b feature/your-feature-name代码规范C#代码遵循 Microsoft编码规范Python代码使用black格式化配置文件pyproject.toml提交前运行本地测试# 运行C#测试 dotnet test services/recommendation-service/dotnet/ # 运行Python测试 pytest services/expense-service/python/提交PRPR标题格式[组件名] 简明描述例如[SK] 添加股票推荐语义函数关联相关issue使用Fixes #123语法确保CI检查通过包括代码风格和单元测试3. 代码审查要点维护者会关注以下方面功能完整性是否实现了预期功能性能影响向量查询、模型调用等是否优化安全性API密钥、用户数据是否安全处理可测试性是否便于单元测试和集成测试参与开发讨论讨论渠道GitHub Discussions项目设计和技术选型讨论社区会议每周三19:00UTC8的线上同步会议会议链接在Discussions置顶即时沟通加入Miyagi Discord社区需在Discussions申请邀请有效提问的技巧遇到问题时请提供环境信息操作系统、依赖版本、配置文件片段复现步骤详细操作流程和命令错误日志完整的异常堆栈或控制台输出尝试方案已尝试的解决方法及结果例如问题在运行dotnet run启动推荐服务时出现CosmosDB连接错误。环境Windows 11.NET 7.0CosmosDB Emulator v2.14日志Microsoft.Azure.Cosmos.CosmosException: Response status code does not indicate success: NotFound (404);已尝试重新启动Emulator检查连接字符串格式进阶贡献构建自定义插件Miyagi支持通过插件扩展功能以下是开发插件的基本步骤创建插件目录mkdir -p services/chatgpt-plugin/python/plugins/your-plugin-name实现功能参考现有插件结构如 services/chatgpt-plugin/python/connectors/bing.py注册插件在 services/chatgpt-plugin/python/server/ai-plugin.json 中添加插件元数据图插件通过Semantic Kernel与系统交互的内存流程社区贡献者激励贡献者名单活跃贡献者将列入 README.md 的致谢部分技术指导核心开发者提供1对1代码审查和技术指导早期访问优先体验新功能和实验性API会议发言优秀贡献者有机会在社区会议分享经验常见问题解答Q如何处理大型功能贡献A建议先在GitHub Issues提出设计方案经社区讨论后再实施避免重复劳动。Q是否接受文档类PRA非常欢迎文档贡献是项目重要组成部分特别是教程和API说明。Q代码提交后多久会被审查A维护者通常会在1-3个工作日内回应复杂PR可能需要更多时间。Miyagi社区重视每一位贡献者的参与无论你是AI开发新手还是资深工程师都能在这里找到适合的贡献方式。立即克隆仓库开始你的智能应用开发之旅吧【免费下载链接】miyagiSample to envision intelligent apps with Microsofts Copilot stack for AI-infused product experiences.项目地址: https://gitcode.com/gh_mirrors/mi/miyagi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考