Back to MCP directory
publicPublicdnsLocal runtime

2344

Opik是一个开源的LLM评估框架,支持追踪、评估和监控LLM应用,帮助开发者构建更高效、更经济的LLM系统。

article

README

🚀 使用 Python 的 Opik SDK 进行大语言模型(LLM)应用开发

Opik 是一个用于跟踪和评估大语言模型(LLM)应用的工具,支持多种流行框架,能提供详细的指标分析,助力开发者高效进行大语言模型应用开发。

🚀 快速开始

Opik 支持多种主流大语言模型框架,若使用这些框架,可直接集成 Opik;若未使用,也能通过 track 装饰器记录函数调用。同时,Opik 提供了丰富的指标和评估工具,帮助开发者评估模型效果,还支持将模型无缝集成到现有 CI/CD 管道中。

✨ 主要特性

🔧 支持的框架与集成

Opik 目前支持以下主流的大语言模型框架: | 框架名称 | 代码示例 | 文档链接 | |----------------|--------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Hugging Face | python import transformers
from transformers import pipeline
model = pipeline('text-generation') | Hugging Face 文档 | | OpenAI | python import openai
client = openai.OpenAI() | OpenAI API 文档 | | Amazon Bedrock | python from amazonbedrock import BedrockClient | Amazon Bedrock 文档 | | Anthropic | python from anthropic import Anthropic | Anthropic API 文档 | | Google AI | python from google.generativeai import GenerativeAI | Google AI 文档 | | Microsoft Azure| python from azure.core.credentials import AzureKeyCredential
from azure.ai.chatbots import ChatCompletion | Microsoft Azure 文档 | | Stability AI | python import stability_ai | Stability AI 文档 | | Watsonx | python from ibm_watson_machine_learning importWatsonML | Watsonx 文档 |

⚠️ 重要提示

如果您使用的是上述框架以外的工具,请随时提交问题或通过 Pull Request 添加集成支持。

🕶️ 跟踪函数调用

如果您未使用任何上述框架,Opik 提供了灵活的track装饰器来记录函数调用:

import opik

opik.configure(use_local=True)  # 本地运行

@opik.track
def my_llm_function(user_question: str) -> str:
    # 大语言模型代码

    return "Hello"

💡 使用建议

track 装饰器可与任何集成结合使用,也可用于跟踪嵌套函数调用。

🧑⚖️ 大语言模型作为裁判的指标

Opik 提供了一系列指标,帮助您评估大语言模型应用的效果。更多内容请参考指标文档。 使用这些指标非常简单,只需导入相关度量并调用score方法:

from opik.evaluation.metrics import Hallucination

metric = Hallucination()
score = metric.score(
    input="What is the capital of France?",
    output="Paris",
    context="France's capital has been Paris since 1590."
)
print(score)  # 输出评估结果

📊 评估与分析

Opik 提供了详细的性能报告和可视化工具,帮助您全面了解大语言模型的表现。

from opik import evaluate

results = evaluate(
    model="gpt-4",
    inputs=inputs,
    outputs=outputs,
    metrics=["precision", "recall", "f1"]
)
print(results)  # 输出评估结果

🛠️ 集成与部署

Opik 支持将大语言模型无缝集成到现有 CI/CD 管道中:

from opik.deploy import deploy

model = ...  # 加载您的大语言模型
deploy(model, "my-model-endpoint", platform="aws")  # 部署到 AWS 云服务

🤝 贡献与支持

我们欢迎社区的贡献,您可以通过以下方式参与:

📚 详细文档

感谢您选择 Opik,让我们一起推动大语言模型技术的发展!

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client