OpenAI y Endpoints Compatibles

OpenAIEngine proporciona soporte para modelos que implementan el protocolo estándar /chat/completions de OpenAI. Más allá de los modelos oficiales de OpenAI (como GPT-4o y o3-mini), este motor universal se conecta directamente con xAI Grok, DeepSeek, Groq, servidores locales de inferencia (vLLM, LM Studio) y pasarelas de API corporativas.

Preajustes Integrados de ProveedoresCopy Anchor Link

Para reducir la configuración manual de endpoints, chatflow-agent incluye preajustes verificados para los principales proveedores compatibles con OpenAI:

Configuración de Modelos Oficiales de OpenAICopy Anchor Link

Para utilizar modelos de OpenAI, proporciona tu clave de API mediante la variable de entorno OPENAI_API_KEY o directamente en el constructor del agente o motor:

import os
from chatflow_agent import Agent, Runner
from chatflow_agent.core.engines.openai_compatible import OpenAIEngine

# Opción 1: Resolución implícita mediante el prefijo del nombre del modelo
analyst = Agent(
    name="Analyst",
    model="gpt-4o",
    instructions="Analyze structured operational data.",
)

# Opción 2: Asignación explícita del proveedor
writer = Agent(
    name="Writer",
    provider="openai",
    model="gpt-4o-mini",
    instructions="Draft concise summaries.",
)

# Opción 3: Instanciación explícita del motor con parámetros personalizados
custom_engine = OpenAIEngine(
    api_key=os.environ.get("OPENAI_API_KEY"),
    provider="openai",
    timeout=45.0,
)
senior_agent = Agent(
    name="SeniorAgent",
    model="gpt-4o",
    engine=custom_engine,
    instructions="Review critical business decisions.",
)

Proveedores de Terceros: Groq, DeepSeek y xAI GrokCopy Anchor Link

Conectarse a proveedores de inferencia de ultra alta velocidad o modelos de razonamiento especializados solo requiere especificar el atributo provider o el prefijo de modelo estándar:

import os
from chatflow_agent import Agent
from chatflow_agent.core.engines.openai_compatible import OpenAIEngine

# Requiere la variable de entorno GROQ_API_KEY
groq_engine = OpenAIEngine(
    provider="groq",
    api_key=os.environ.get("GROQ_API_KEY"),
)

speed_agent = Agent(
    name="SpeedAgent",
    model="llama-3.3-70b-versatile",
    engine=groq_engine,
    instructions="Provide real-time triage responses.",
)

Endpoints Personalizados y Pasarelas PrivadasCopy Anchor Link

Al conectarse a instancias privadas (vLLM, LM Studio, Azure OpenAI proxy o LiteLLM), proporciona un base_url personalizado:

from chatflow_agent import Agent
from chatflow_agent.core.engines.openai_compatible import OpenAIEngine

# Pasarela corporativa de inferencia personalizada
gateway_engine = OpenAIEngine(
    base_url="https://ai-gateway.internal.corp/v1",
    api_key="internal-gateway-token",
    timeout=60.0,
)

internal_agent = Agent(
    name="InternalAssistant",
    model="custom-llama-3",
    engine=gateway_engine,
    instructions="Answer queries using internal compliance guidelines.",
)

Regla de Seguridad: Prevención de Fugas de CredencialesCopy Anchor Link

# [INCORRECTO] Genera ValueError para proteger tu OPENAI_API_KEY de fugas accidentales:
# engine = OpenAIEngine(base_url="https://untrusted-proxy.example.com/v1")

# [CORRECTO] Suministra credenciales explícitamente para hosts personalizados:
engine = OpenAIEngine(
    base_url="https://proxy.example.com/v1",
    api_key="proxy-secret-token",
)

# [CORRECTO] Servidor interno no autenticado:
open_engine = OpenAIEngine(
    base_url="http://192.168.1.100:8000/v1",
    api_key="",
)

Restricciones y Normalización de IDs de Llamadas a HerramientasCopy Anchor Link

OpenAI impone una longitud máxima estricta de 40 caracteres en el tool_call_id de las respuestas de llamadas a funciones. En entornos multi-agente donde los agentes transfieren sesiones entre diferentes proveedores (por ejemplo, herramientas de Anthropic Claude que generan IDs superiores a 40 caracteres), chatflow-agent garantiza la compatibilidad del protocolo:

1. Truncamiento y Hashing: Si un mensaje histórico existente contiene un ID de llamada a herramienta superior a 40 caracteres, OpenAIEngine lo sustituye de forma segura por un identificador determinista derivado mediante SHA-256 (call_ + 24 caracteres hexadecimales).
2. Normalización de Tipos de Esquema: El motor normaliza automáticamente los tipos de parámetros JSON Schema (_lowercase_schema_types) preservando al mismo tiempo esquemas de propiedades personalizadas, garantizando la compatibilidad entre distintas versiones de modelos de OpenAI.

Resolución de ProblemasCopy Anchor Link