Readme ES

Nota: Este archivo fue traducido automáticamente. ¡Las mejoras de traducción son bienvenidas!

    </picture></a>
    

    Opik
</div>

<a href="#-llm-as-a-judge-metrics">🧑‍⚖️ LLM como juez</a> • <a href="#-evaluating-your-llm-application">🔍 Evaluando su solicitud</a> • <a href="#-star-us-on-github">⭐ Destacarnos</a> • <a href="#-contributing">🤝 Contribuyendo</a>

<a id="-what-is-opik"></a>

🚀 ¿Qué es Opik?

Opik (creado por Comet) es una plataforma de código abierto diseñada para optimizar todo el ciclo de vida de las aplicaciones LLM. Permite a los desarrolladores evaluar, probar, monitorear y optimizar sus modelos y sistemas agentes. Las ofertas clave incluyen:

• Observabilidad integral: seguimiento profundo de las llamadas de LLM, registro de conversaciones y actividad de los agentes.
• Evaluación avanzada: evaluación rápida y sólida, LLM como juez y gestión de experimentos.
• Listo para producción: paneles de control escalables y reglas de evaluación en línea para producción.
• Opik Agent Optimizer: SDK dedicado y conjunto de optimizadores para mejorar las indicaciones y los agentes.
• Opik Guardrails: funciones que le ayudarán a implementar prácticas de IA seguras y responsables.

Las capacidades clave incluyen:

• Desarrollo y seguimiento:

  • Realice un seguimiento de todas las llamadas y seguimientos de LLM con un contexto detallado durante el desarrollo y la producción (Quickstart).
  • Amplias integraciones con terceros para una fácil observabilidad: integre perfectamente con una lista cada vez mayor de marcos, admitiendo muchos de los más grandes y populares de forma nativa (incluidas incorporaciones recientes como Google ADK, Autogen y Flowise AI). (Integraciones)
  • Anote trazas y tramos con puntuaciones de retroalimentación a través del Python SDK o el UI.
  • Experimente con indicaciones y modelos en Prompt Playground.

• Evaluación y pruebas:

  • Automatice la evaluación de su solicitud de LLM con Conjuntos de datos y Experimentos.
  • Aproveche las poderosas métricas de LLM como juez para tareas complejas como detección de alucinaciones, moderación y evaluación RAG (Respuesta Relevancia, Contexto Precisión).
  • Integre evaluaciones en su canal de CI/CD con nuestra integración de PyTest.

• Monitoreo y optimización de la producción:

  • Registrar grandes volúmenes de trazas de producción: Opik está diseñado para escalar (más de 40 millones de trazas/día).
  • Supervise las puntuaciones de los comentarios, los recuentos de seguimiento y el uso de tokens a lo largo del tiempo en el Panel de Opik.

• Utilice Reglas de evaluación en línea con métricas de LLM-as-a-Judge para identificar problemas de producción.

  • Aproveche Opik Agent Optimizer y Opik Guardrails para mejorar y proteger continuamente sus aplicaciones LLM en producción.

[!CONSEJO] Si está buscando funciones que Opik no tiene hoy, presente una nueva solicitud de función 🚀

<a id="%EF%B8%8F-opik-server-installation"></a>

🛠️ Instalación del servidor Opik

Haga funcionar su servidor Opik en minutos. Elige la opción que mejor se adapta a tus necesidades:

Opción 1: Comet.com Cloud (más fácil y recomendada)

Acceda a Opik al instante sin ninguna configuración. Ideal para inicios rápidos y mantenimiento sin complicaciones.

👉 Cree su cuenta Comet gratuita

Opción 2: Opik autohospedado para control total

Implemente Opik en su propio entorno. Elija entre Docker para configuraciones locales o Kubernetes para escalabilidad.

Autohospedaje con Docker Compose (para pruebas y desarrollo local)

Esta es la forma más sencilla de ejecutar una instancia local de Opik. Tenga en cuenta el nuevo script de instalación ./opik.sh:

En entorno Linux o Mac:

# Clonar el repositorio de Opik
git clone https://github.com/comet-ml/opik.git

# Navegar al repositorio
cd opik

# Inicie la plataforma Opik
./opik.sh

En el entorno Windows:

# Clonar el repositorio de Opik
git clone https://github.com/comet-ml/opik.git

# Navegar al repositorio
cd opik

# Inicie la plataforma Opik
powershell -ExecutionPolicy ByPass -c ".\\opik.ps1"

Perfiles de servicio para desarrollo

Los scripts de instalación de Opik ahora admiten perfiles de servicio para diferentes escenarios de desarrollo:

# Iniciar la suite Opik completa (comportamiento predeterminado)
./opik.sh

# Iniciar solo servicios de infraestructura (bases de datos, cachés, etc.)
./opik.sh --infra

# Iniciar infraestructura + servicios backend
./opik.sh --backend

# Habilitar barandillas con cualquier perfil
./opik.sh --guardrails # Guardrails con la suite Opik completa
./opik.sh --backend --guardrails # Guardrails con infraestructura + backend

Utilice las opciones --help o --info para solucionar problemas. Dockerfiles ahora garantiza que los contenedores se ejecuten como usuarios no root para mejorar la seguridad. Una vez que todo esté en funcionamiento, podrá visitar localhost:5173 en su navegador. Para obtener instrucciones detalladas, consulte la Guía de implementación local.

Autohospedaje con Kubernetes y Helm (para implementaciones escalables)

Para implementaciones autohospedadas de producción o de mayor escala, Opik se puede instalar en un clúster de Kubernetes utilizando nuestro diagrama Helm. Haga clic en la insignia para obtener la Guía de instalación de Kubernetes usando Helm.

[!IMPORTANTE] Cambios de la versión 1.7.0: consulte el registro de cambios para obtener actualizaciones importantes y cambios importantes.

<a id="-opik-client-sdk"></a>

💻 SDK del cliente Opik

Opik proporciona un conjunto de bibliotecas cliente y una API REST para interactuar con el servidor Opik. Esto incluye SDK para Python, TypeScript y Ruby (a través de OpenTelemetry), lo que permite una integración perfecta en sus flujos de trabajo. Para obtener referencias detalladas de API y SDK, consulte la Documentación de referencia del cliente de Opik.

Inicio rápido del SDK de Python

Para comenzar con el SDK de Python:

Instale el paquete:

# instalar usando pip
pip install opik

# o instalar con uv
uv pip install opik

Configure el SDK de Python ejecutando el comando opik configure, que le solicitará la dirección de su servidor Opik (para instancias autohospedadas) o su clave API y espacio de trabajo (para Comet.com):

opik configure

[!CONSEJO] También puede llamar a opik.configure(use_local=True) desde su código Python para configurar el SDK para que se ejecute en una instalación local autohospedada, o proporcionar la clave API y los detalles del espacio de trabajo directamente para Comet.com. Consulte la documentación del SDK de Python para obtener más opciones de configuración.

Ahora está listo para comenzar a registrar seguimientos utilizando el SDK de Python.

<a id="-logging-traces-with-integrations"></a>

📝 Registro de seguimientos con integraciones

La forma más sencilla de registrar seguimientos es utilizar una de nuestras integraciones directas. Opik admite una amplia gama de marcos, incluidas incorporaciones recientes como Google ADK, Autogen, AG2 y Flowise AI:

[!CONSEJO] Si el marco que está utilizando no figura en la lista anterior, no dude en abrir un problema o enviar un PR con la integración.

Si no está utilizando ninguno de los marcos anteriores, también puede utilizar el decorador de la función track para registrar seguimientos:

import opik

opik.configure(use_local=True) # Ejecutar localmente

@opik.track
def my_llm_function(user_question: str) -> str:
    # Tu código LLM aquí

    devolver "Hola"

[!CONSEJO] El decorador de pistas se puede utilizar junto con cualquiera de nuestras integraciones y también se puede utilizar para realizar un seguimiento de llamadas a funciones anidadas.

<a id="-llm-as-a-judge-metrics"></a>

🧑‍⚖️ Métricas de LLM como juez

El SDK de Python Opik incluye una serie de LLM como métricas de evaluación para ayudarle a evaluar su solicitud de LLM. Obtenga más información al respecto en la documentación de métricas.

Para usarlos, simplemente importe la métrica relevante y use la función score:

from opik.evaluation.metrics import Hallucination

metric = Hallucination()
score = metric.score(
    input="¿Cuál es la capital de Francia?",
    output="París",
    context=["Francia es un país de Europa."]
)
imprimir (partitura)

Opik también incluye una serie de métricas heurísticas prediseñadas, así como la capacidad de crear las suyas propias. Obtenga más información al respecto en la documentación de métricas.

<a id="-evaluating-your-llm-application"></a>

🔍 Evaluación de sus solicitudes de LLM

Opik le permite evaluar su solicitud de LLM durante el desarrollo a través de Conjuntos de datos y Experimentos. El panel de Opik ofrece gráficos mejorados para experimentos y un mejor manejo de trazas grandes. También puede ejecutar evaluaciones como parte de su canal de CI/CD utilizando nuestra integración de PyTest.

<a id="-star-us-on-github"></a>

⭐ Destacarnos en GitHub

Si encuentra útil Opik, ¡considere darnos una estrella! Su apoyo nos ayuda a hacer crecer nuestra comunidad y continuar mejorando el producto.

<a id="-contributing"></a>

🤝 Contribuyendo

Hay muchas maneras de contribuir a Opik:

• Envíe informes de errores y solicitudes de funciones
• Revisar la documentación y enviar Solicitudes de extracción para mejorarla
• Hablar o escribir sobre Opik y hacernoslo saber
• Votar a favor solicitudes de funciones populares para mostrar su apoyo

Para obtener más información sobre cómo contribuir a Opik, consulte nuestras directrices de contribución.