K-Forge / K-Forge/Beetle

Cliente OpenAI-compatible

Open
#186 0 comments 0 reactions 1 assignee Claimed by @MauItu View on GitHub
fase-4
Dominant language
Shell
Stars
1
Forks
0
PR merge metrics
No merged PRs in 30d

Description

## Qué es esta tarea

Implementar el cliente HTTP que envía la evidencia sanitizada al proveedor de LLM usando el formato OpenAI-compatible. Es la pieza que conecta la recolección con el diagnóstico — un POST con la evidencia, un response con el informe.

## Qué se debe hacer

- Crear `doctorjk/llm.py`
- Implementar POST a `/v1/chat/completions` con:
- Headers de autenticación (`Authorization: Bearer ...`)
- Body con `model`, `messages` (system + user)
- Timeout de 30 segundos
- Leer base URL, modelo y API key desde variables de entorno
- Parsear la respuesta y extraer el contenido del mensaje
- Usar `requests` o `httpx` como única dependencia externa

## Por qué importa

El diseño OpenAI-compatible es deliberado (sección 5.5 del documento de proyecto): permite cambiar de proveedor con solo cambiar 3 variables de entorno. Cloudflare, DeepSeek y la mayoría de proveedores hablan este formato. Un cliente bien diseñado aquí hace que el agente sea agnóstico del modelo.

## Criterio de avance

El cliente envía evidencia al endpoint de Cloudflare Workers AI y recibe un diagnóstico válido de gpt-oss-120b. Cambiar las 3 variables de entorno a DeepSeek produce el mismo resultado sin cambiar código.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.