agentscope-ai / agentscope-ai/agentscope-runtime-java

[Bug / Tech Debt] Refactor OpenAI responses API protocol: Replace Manual Implementation with SDK-Based Approach

Ouverte
#69 0 commentaires 0 réactions 1 personne assignée Réclamée par @xuehuitian45 Voir sur GitHub
bug
Langage dominant
Java
Étoiles
184
Forks
38
Métriques de merge des PR
Aucune PR mergée en 30 j

Description

### Description

The current OpenAI Responses API protocol is **largely hand-written based on public documentation**. While this offers initial flexibility, it introduces several critical risks:

- **Inconsistencies with actual API behavior** (e.g., field names, status codes, error formats)
- **Missing edge cases** (rate limits, retry logic, pagination, streaming headers)
- **Hard to maintain** when upstream APIs evolve
- **No type safety or compile-time validation**
- **Duplication of effort** when official SDKs already exist

This has already led to subtle bugs in production—such as malformed JSON payloads, incorrect error handling, or unexpected deserialization failures—especially when integrating with new models or third-party services

Guide de contribution

Ouvrir le guide de contribution

Évaluation

Cette issue n'a pas encore été évaluée.

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.