Protocolos y Contratos¶

Esta página documenta los protocolos (interfaces) que definen los contratos del sistema en el "Estado del Arte 2026".

Workflows (Protocolo)¶

Los flujos de trabajo siguen un protocolo estándar para asegurar que la API pueda interactuar con ellos de forma genérica.

from typing import Protocol, runtime_checkable

@runtime_checkable
class Workflow(Protocol):
    async def execute(self, *args, **kwargs):
        """Punto de entrada principal para la ejecución del flujo."""
        ...

Adaptadores de Características¶

Cada característica (Feature) define su propia interfaz mediante protocolos de Python para permitir el intercambio de implementaciones (ej: cambiar Gemini por Ollama).

LLMProvider¶

class LLMProvider(Protocol):
    async def process(self, text: str, system_prompt: str) -> str:
        """Procesa texto usando un modelo de lenguaje."""

AudioSource¶

class AudioSource(Protocol):
    def read(self, frames: int) -> np.ndarray:
        """Lee frames de audio del buffer."""