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

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

Aperta
#69 0 commenti 0 reazioni 1 assegnatario Rivendicata da @xuehuitian45 Vedi su GitHub
bug
Lingua principale
Java
Stelle
184
Fork
38
Metriche di merge delle PR
Nessuna PR unita negli ultimi 30g

Descrizione

### 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

Guida per i contributori

Apri la guida per i contributori

Valutazione

Questa issue non è ancora stata valutata.

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.