Servidor simplificado para interactuar con OpenAI (Chat & Whisper) vía SSE.
Two tools with basic schemas and descriptions, but significant gaps in parameter documentation, error handling, and output schema clarity. Tool names are action-oriented (generate_text, transcribe_audio) but descriptions lack LLM-optimized structure. Parameters have types and basic descriptions, but missing constraints (enums, ranges, format specs). No documented output schemas. Error handling is minimal, no recovery guidance or actionable error messages. The server accepts base64 audio and model names but lacks validation rules, format constraints, and dependency documentation. Descriptions are in Spanish, which may confuse English-speaking LLMs.
Ejecutando capacidad: generate_text con modelo especificado. Genera texto usando OpenAI Chat API.
Procesando capacidad: transcribe_audio. Transcribe audio en formato OGG a texto usando OpenAI Whisper API. Convierte OGG a WAV si es necesario.
No documented output schemas. LLMs cannot plan downstream calls or extract structured data without knowing what fields to expect.
Parameter descriptions lack format constraints and validation rules. 'model' accepts any string; should enumerate valid OpenAI/Whisper models. 'audio_content_base64' lacks size limits or format validation.
Error handling provides no recovery guidance. Code catches exceptions but yields generic error messages ('Error interno: Cliente OpenAI no inicializado'). LLMs cannot self-correct without actionable error details.
Tool descriptions are in Spanish, creating a language mismatch with English-speaking LLMs. Descriptions should be in the same language as the LLM's training data.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 38 | <=2025-11-25 | v2 |
Missing parameter dependencies and prerequisites. 'transcribe_audio' requires ffmpeg installed on the server; no documentation of this dependency or graceful fallback if missing.