SuperAPI AI 工具集

dataverse-python-production-code

编程与开发

查看项目

更新于 10-15 21:52

技能介绍

用途:该技能面向使用 PowerPlatform-Dataverse-Client SDK 的 Python 开发场景,用于生成可直接投入生产的代码,强调错误处理、性能优化与规范实践。

主要能力:按 DataverseError 异常层级实现错误处理;使用单例客户端模式管理连接;针对 429/超时错误加入指数退避重试;应用 OData 优化(服务端 filter、仅 select 所需列、orderby/top 分页、expand 关联记录);加入日志用于审计与调试;提供类型注解与文档字符串;遵循微软官方示例中的最佳实践。

使用方式:用户提出代码生成请求时,输出应包含:导入区(标准库、第三方、本地)、配置区(常量/枚举)、带错误处理的主实现、说明参数与返回值的 docstring、全量类型注解、调用示例、异常场景处理与日志语句。客户端管理推荐使用 new 实现单例,init 中仅首次创建 DataverseClient。重试逻辑在捕获 HttpError 后按 2**attempt 计算退避并 time.sleep,最后一次失败时记录并抛出。日志使用 logging 模块而非 print,格式包含时间、名称、级别与消息。

代码结构建议:导入、常量与枚举、日志配置、辅助函数、主服务类、错误处理类、使用示例。

质量标准:代码需符合 Python 3.10+ 语法;API 调用需 try-except;函数需类型注解与 docstring;需实现瞬时故障重试;消息用 logger;需包含配置管理(密钥、URL);遵循 PEP 8;示例以注释形式给出。

限制:仅围绕该 SDK 与 Dataverse 代码生成场景提供规范,官方资料未提供具体安装命令、版本兼容矩阵、收费与平台细节,暂未提供。