forked from phoenix-oss/llama-stack-mirror
96 lines
2.9 KiB
Python
96 lines
2.9 KiB
Python
# Copyright (c) Meta Platforms, Inc. and affiliates.
|
|
# All rights reserved.
|
|
#
|
|
# This source code is licensed under the terms described in the LICENSE file in
|
|
# the root directory of this source tree.
|
|
from typing import Any, Dict, List, Literal, Optional, Protocol, runtime_checkable
|
|
|
|
from pydantic import BaseModel, Field
|
|
|
|
from llama_stack.apis.resource import Resource, ResourceType
|
|
from llama_stack.schema_utils import json_schema_type, webmethod
|
|
|
|
|
|
class CommonBenchmarkFields(BaseModel):
|
|
"""
|
|
:param dataset_id: The ID of the dataset to used to run the benchmark.
|
|
:param grader_ids: The grader ids to use for this benchmark.
|
|
:param metadata: Metadata for this benchmark for additional descriptions.
|
|
"""
|
|
|
|
dataset_id: str
|
|
grader_ids: List[str]
|
|
metadata: Dict[str, Any] = Field(
|
|
default_factory=dict,
|
|
description="Metadata for this benchmark",
|
|
)
|
|
|
|
|
|
@json_schema_type
|
|
class Benchmark(CommonBenchmarkFields, Resource):
|
|
type: Literal[ResourceType.benchmark.value] = ResourceType.benchmark.value
|
|
|
|
@property
|
|
def benchmark_id(self) -> str:
|
|
return self.identifier
|
|
|
|
@property
|
|
def provider_benchmark_id(self) -> str:
|
|
return self.provider_resource_id
|
|
|
|
|
|
class BenchmarkInput(CommonBenchmarkFields, BaseModel):
|
|
benchmark_id: str
|
|
provider_id: Optional[str] = None
|
|
provider_benchmark_id: Optional[str] = None
|
|
|
|
|
|
class ListBenchmarksResponse(BaseModel):
|
|
data: List[Benchmark]
|
|
|
|
|
|
@runtime_checkable
|
|
class Benchmarks(Protocol):
|
|
@webmethod(route="/benchmarks", method="POST")
|
|
async def register_benchmark(
|
|
self,
|
|
dataset_id: str,
|
|
grader_ids: List[str],
|
|
benchmark_id: Optional[str] = None,
|
|
metadata: Optional[Dict[str, Any]] = None,
|
|
) -> Benchmark:
|
|
"""
|
|
Register a new benchmark. A benchmark consists of a dataset id and a list of grader ids.
|
|
|
|
:param dataset_id: The ID of the dataset to be used to run the benchmark.
|
|
:param grader_ids: List of grader ids to use for this benchmark.
|
|
:param benchmark_id: (Optional) The ID of the benchmark to register. If not provided, an ID will be generated.
|
|
:param metadata: (Optional) Metadata for this benchmark for additional descriptions.
|
|
"""
|
|
...
|
|
|
|
@webmethod(route="/benchmarks", method="GET")
|
|
async def list_benchmarks(self) -> ListBenchmarksResponse:
|
|
"""
|
|
List all benchmarks.
|
|
"""
|
|
...
|
|
|
|
@webmethod(route="/benchmarks/{benchmark_id}", method="GET")
|
|
async def get_benchmark(
|
|
self,
|
|
benchmark_id: str,
|
|
) -> Benchmark:
|
|
"""
|
|
Get a benchmark by ID.
|
|
|
|
:param benchmark_id: The ID of the benchmark to get.
|
|
"""
|
|
...
|
|
|
|
@webmethod(route="/benchmarks/{benchmark_id}", method="DELETE")
|
|
async def unregister_benchmark(self, benchmark_id: str) -> None:
|
|
"""
|
|
Unregister a benchmark by ID.
|
|
"""
|
|
...
|