vellum-ai 0.8.16__tar.gz → 0.8.18__tar.gz

{vellum_ai-0.8.16 → vellum_ai-0.8.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: vellum-ai
-Version: 0.8.16
+Version: 0.8.18
 Summary: 
 License: MIT
 Requires-Python: >=3.8,<4.0

{vellum_ai-0.8.16 → vellum_ai-0.8.18}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "vellum-ai"
-version = "0.8.16"
+version = "0.8.18"
 description = ""
 readme = "README.md"
 authors = []

{vellum_ai-0.8.16 → vellum_ai-0.8.18}/src/vellum/__init__.py

@@ -14,6 +14,7 @@ from .types import (
     ArrayChatMessageContentItem,
     ArrayChatMessageContentItemRequest,
     ArrayChatMessageContentRequest,
+    ArrayInputRequest,
     ArrayVariableValue,
     ArrayVariableValueItem,
     ArrayVellumValue,
@@ -48,10 +49,15 @@ from .types import (
     CodeExecutionNodeResultOutput,
     CodeExecutionNodeSearchResultsResult,
     CodeExecutionNodeStringResult,
+    CodeExecutionPackageRequest,
+    CodeExecutionRuntime,
+    CodeExecutorInputRequest,
+    CodeExecutorResponse,
     CompilePromptDeploymentExpandMetaRequest,
     CompilePromptMeta,
     ComponentsSchemasPdfSearchResultMetaSource,
     ComponentsSchemasPdfSearchResultMetaSourceRequest,
+    ConditionCombinator,
     ConditionalNodeResult,
     ConditionalNodeResultData,
     CreateTestSuiteTestCaseRequest,
@@ -73,6 +79,7 @@ from .types import (
     EnvironmentEnum,
     EphemeralPromptCacheConfigRequest,
     EphemeralPromptCacheConfigTypeEnum,
+    ErrorInputRequest,
     ErrorVariableValue,
     ErrorVellumValue,
     ErrorVellumValueRequest,
@@ -104,6 +111,7 @@ from .types import (
     FunctionCallChatMessageContentRequest,
     FunctionCallChatMessageContentValue,
     FunctionCallChatMessageContentValueRequest,
+    FunctionCallInputRequest,
     FunctionCallRequest,
     FunctionCallVariableValue,
     FunctionCallVellumValue,
@@ -119,6 +127,12 @@ from .types import (
     GenerateStreamResponse,
     GenerateStreamResult,
     GenerateStreamResultData,
+    GoogleVertexAiVectorizerConfig,
+    GoogleVertexAiVectorizerConfigRequest,
+    GoogleVertexAiVectorizerTextEmbedding004,
+    GoogleVertexAiVectorizerTextEmbedding004Request,
+    GoogleVertexAiVectorizerTextMultilingualEmbedding002,
+    GoogleVertexAiVectorizerTextMultilingualEmbedding002Request,
     HkunlpInstructorXlVectorizer,
     HkunlpInstructorXlVectorizerRequest,
     ImageChatMessageContent,
@@ -151,6 +165,9 @@ from .types import (
     MetadataFilterConfigRequest,
     MetadataFilterRuleCombinator,
     MetadataFilterRuleRequest,
+    MetadataFiltersRequest,
+    MetricDefinitionExecution,
+    MetricDefinitionInputRequest,
     MetricNodeResult,
     MlModelUsage,
     NamedScenarioInputChatHistoryVariableValueRequest,
@@ -195,6 +212,7 @@ from .types import (
     NodeOutputCompiledValue,
     NormalizedLogProbs,
     NormalizedTokenLogProbs,
+    NumberInputRequest,
     NumberVariableValue,
     NumberVellumValue,
     NumberVellumValueRequest,
@@ -264,6 +282,7 @@ from .types import (
     SearchResultMeta,
     SearchResultMetaRequest,
     SearchResultRequest,
+    SearchResultsInputRequest,
     SearchResultsVariableValue,
     SearchResultsVellumValue,
     SearchResultsVellumValueRequest,
@@ -382,6 +401,11 @@ from .types import (
     VellumErrorRequest,
     VellumImage,
     VellumImageRequest,
+    VellumValue,
+    VellumValueLogicalConditionGroupRequest,
+    VellumValueLogicalConditionRequest,
+    VellumValueLogicalExpressionRequest,
+    VellumValueRequest,
     VellumVariable,
     VellumVariableRequest,
     VellumVariableType,
@@ -437,6 +461,7 @@ from .resources import (
     document_indexes,
     documents,
     folder_entities,
+    metric_definitions,
     sandboxes,
     test_suite_runs,
     test_suites,
@@ -461,6 +486,7 @@ __all__ = [
     "ArrayChatMessageContentItem",
     "ArrayChatMessageContentItemRequest",
     "ArrayChatMessageContentRequest",
+    "ArrayInputRequest",
     "ArrayVariableValue",
     "ArrayVariableValueItem",
     "ArrayVellumValue",
@@ -497,10 +523,15 @@ __all__ = [
     "CodeExecutionNodeResultOutput",
     "CodeExecutionNodeSearchResultsResult",
     "CodeExecutionNodeStringResult",
+    "CodeExecutionPackageRequest",
+    "CodeExecutionRuntime",
+    "CodeExecutorInputRequest",
+    "CodeExecutorResponse",
     "CompilePromptDeploymentExpandMetaRequest",
     "CompilePromptMeta",
     "ComponentsSchemasPdfSearchResultMetaSource",
     "ComponentsSchemasPdfSearchResultMetaSourceRequest",
+    "ConditionCombinator",
     "ConditionalNodeResult",
     "ConditionalNodeResultData",
     "CreateTestSuiteTestCaseRequest",
@@ -524,6 +555,7 @@ __all__ = [
     "EnvironmentEnum",
     "EphemeralPromptCacheConfigRequest",
     "EphemeralPromptCacheConfigTypeEnum",
+    "ErrorInputRequest",
     "ErrorVariableValue",
     "ErrorVellumValue",
     "ErrorVellumValueRequest",
@@ -556,6 +588,7 @@ __all__ = [
     "FunctionCallChatMessageContentRequest",
     "FunctionCallChatMessageContentValue",
     "FunctionCallChatMessageContentValueRequest",
+    "FunctionCallInputRequest",
     "FunctionCallRequest",
     "FunctionCallVariableValue",
     "FunctionCallVellumValue",
@@ -571,6 +604,12 @@ __all__ = [
     "GenerateStreamResponse",
     "GenerateStreamResult",
     "GenerateStreamResultData",
+    "GoogleVertexAiVectorizerConfig",
+    "GoogleVertexAiVectorizerConfigRequest",
+    "GoogleVertexAiVectorizerTextEmbedding004",
+    "GoogleVertexAiVectorizerTextEmbedding004Request",
+    "GoogleVertexAiVectorizerTextMultilingualEmbedding002",
+    "GoogleVertexAiVectorizerTextMultilingualEmbedding002Request",
     "HkunlpInstructorXlVectorizer",
     "HkunlpInstructorXlVectorizerRequest",
     "ImageChatMessageContent",
@@ -604,6 +643,9 @@ __all__ = [
     "MetadataFilterConfigRequest",
     "MetadataFilterRuleCombinator",
     "MetadataFilterRuleRequest",
+    "MetadataFiltersRequest",
+    "MetricDefinitionExecution",
+    "MetricDefinitionInputRequest",
     "MetricNodeResult",
     "MlModelUsage",
     "NamedScenarioInputChatHistoryVariableValueRequest",
@@ -649,6 +691,7 @@ __all__ = [
     "NormalizedLogProbs",
     "NormalizedTokenLogProbs",
     "NotFoundError",
+    "NumberInputRequest",
     "NumberVariableValue",
     "NumberVellumValue",
     "NumberVellumValueRequest",
@@ -718,6 +761,7 @@ __all__ = [
     "SearchResultMeta",
     "SearchResultMetaRequest",
     "SearchResultRequest",
+    "SearchResultsInputRequest",
     "SearchResultsVariableValue",
     "SearchResultsVellumValue",
     "SearchResultsVellumValueRequest",
@@ -838,6 +882,11 @@ __all__ = [
     "VellumErrorRequest",
     "VellumImage",
     "VellumImageRequest",
+    "VellumValue",
+    "VellumValueLogicalConditionGroupRequest",
+    "VellumValueLogicalConditionRequest",
+    "VellumValueLogicalExpressionRequest",
+    "VellumValueRequest",
     "VellumVariable",
     "VellumVariableRequest",
     "VellumVariableType",
@@ -889,6 +938,7 @@ __all__ = [
     "document_indexes",
     "documents",
     "folder_entities",
+    "metric_definitions",
     "sandboxes",
     "test_suite_runs",
     "test_suites",

{vellum_ai-0.8.16 → vellum_ai-0.8.18}/src/vellum/client.py

@@ -9,24 +9,30 @@ from .resources.deployments.client import DeploymentsClient
 from .resources.document_indexes.client import DocumentIndexesClient
 from .resources.documents.client import DocumentsClient
 from .resources.folder_entities.client import FolderEntitiesClient
+from .resources.metric_definitions.client import MetricDefinitionsClient
 from .resources.sandboxes.client import SandboxesClient
 from .resources.test_suite_runs.client import TestSuiteRunsClient
 from .resources.test_suites.client import TestSuitesClient
 from .resources.workflow_deployments.client import WorkflowDeploymentsClient
 from .resources.workflow_sandboxes.client import WorkflowSandboxesClient
-from .types.prompt_deployment_input_request import PromptDeploymentInputRequest
-from .types.prompt_deployment_expand_meta_request import PromptDeploymentExpandMetaRequest
-from .types.raw_prompt_execution_overrides_request import RawPromptExecutionOverridesRequest
+from .types.code_execution_runtime import CodeExecutionRuntime
+from .types.code_executor_input_request import CodeExecutorInputRequest
+from .types.code_execution_package_request import CodeExecutionPackageRequest
+from .types.vellum_variable_type import VellumVariableType
 from .core.request_options import RequestOptions
-from .types.execute_prompt_response import ExecutePromptResponse
+from .types.code_executor_response import CodeExecutorResponse
 from .core.serialization import convert_and_respect_annotation_metadata
 from .core.pydantic_utilities import parse_obj_as
 from .errors.bad_request_error import BadRequestError
+from json.decoder import JSONDecodeError
+from .core.api_error import ApiError
+from .types.prompt_deployment_input_request import PromptDeploymentInputRequest
+from .types.prompt_deployment_expand_meta_request import PromptDeploymentExpandMetaRequest
+from .types.raw_prompt_execution_overrides_request import RawPromptExecutionOverridesRequest
+from .types.execute_prompt_response import ExecutePromptResponse
 from .errors.forbidden_error import ForbiddenError
 from .errors.not_found_error import NotFoundError
 from .errors.internal_server_error import InternalServerError
-from json.decoder import JSONDecodeError
-from .core.api_error import ApiError
 from .types.execute_prompt_event import ExecutePromptEvent
 import json
 from .types.workflow_request_input_request import WorkflowRequestInputRequest
@@ -48,6 +54,7 @@ from .resources.deployments.client import AsyncDeploymentsClient
 from .resources.document_indexes.client import AsyncDocumentIndexesClient
 from .resources.documents.client import AsyncDocumentsClient
 from .resources.folder_entities.client import AsyncFolderEntitiesClient
+from .resources.metric_definitions.client import AsyncMetricDefinitionsClient
 from .resources.sandboxes.client import AsyncSandboxesClient
 from .resources.test_suite_runs.client import AsyncTestSuiteRunsClient
 from .resources.test_suites.client import AsyncTestSuitesClient
@@ -117,12 +124,113 @@ class Vellum:
         self.document_indexes = DocumentIndexesClient(client_wrapper=self._client_wrapper)
         self.documents = DocumentsClient(client_wrapper=self._client_wrapper)
         self.folder_entities = FolderEntitiesClient(client_wrapper=self._client_wrapper)
+        self.metric_definitions = MetricDefinitionsClient(client_wrapper=self._client_wrapper)
         self.sandboxes = SandboxesClient(client_wrapper=self._client_wrapper)
         self.test_suite_runs = TestSuiteRunsClient(client_wrapper=self._client_wrapper)
         self.test_suites = TestSuitesClient(client_wrapper=self._client_wrapper)
         self.workflow_deployments = WorkflowDeploymentsClient(client_wrapper=self._client_wrapper)
         self.workflow_sandboxes = WorkflowSandboxesClient(client_wrapper=self._client_wrapper)
 
+    def execute_code(
+        self,
+        *,
+        code: str,
+        runtime: CodeExecutionRuntime,
+        input_values: typing.Sequence[CodeExecutorInputRequest],
+        packages: typing.Sequence[CodeExecutionPackageRequest],
+        output_type: VellumVariableType,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> CodeExecutorResponse:
+        """
+        An internal-only endpoint that's subject to breaking changes without notice. Not intended for public use.
+
+        Parameters
+        ----------
+        code : str
+
+        runtime : CodeExecutionRuntime
+
+        input_values : typing.Sequence[CodeExecutorInputRequest]
+
+        packages : typing.Sequence[CodeExecutionPackageRequest]
+
+        output_type : VellumVariableType
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        CodeExecutorResponse
+
+
+        Examples
+        --------
+        from vellum import CodeExecutionPackageRequest, StringInputRequest, Vellum
+
+        client = Vellum(
+            api_key="YOUR_API_KEY",
+        )
+        client.execute_code(
+            code="code",
+            runtime="PYTHON_3_11_6",
+            input_values=[
+                StringInputRequest(
+                    name="name",
+                    value="value",
+                )
+            ],
+            packages=[
+                CodeExecutionPackageRequest(
+                    version="version",
+                    name="name",
+                )
+            ],
+            output_type="STRING",
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            "v1/execute-code",
+            base_url=self._client_wrapper.get_environment().default,
+            method="POST",
+            json={
+                "code": code,
+                "runtime": runtime,
+                "input_values": convert_and_respect_annotation_metadata(
+                    object_=input_values, annotation=typing.Sequence[CodeExecutorInputRequest], direction="write"
+                ),
+                "packages": convert_and_respect_annotation_metadata(
+                    object_=packages, annotation=typing.Sequence[CodeExecutionPackageRequest], direction="write"
+                ),
+                "output_type": output_type,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    CodeExecutorResponse,
+                    parse_obj_as(
+                        type_=CodeExecutorResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    )
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
     def execute_prompt(
         self,
         *,
@@ -1332,12 +1440,121 @@ class AsyncVellum:
         self.document_indexes = AsyncDocumentIndexesClient(client_wrapper=self._client_wrapper)
         self.documents = AsyncDocumentsClient(client_wrapper=self._client_wrapper)
         self.folder_entities = AsyncFolderEntitiesClient(client_wrapper=self._client_wrapper)
+        self.metric_definitions = AsyncMetricDefinitionsClient(client_wrapper=self._client_wrapper)
         self.sandboxes = AsyncSandboxesClient(client_wrapper=self._client_wrapper)
         self.test_suite_runs = AsyncTestSuiteRunsClient(client_wrapper=self._client_wrapper)
         self.test_suites = AsyncTestSuitesClient(client_wrapper=self._client_wrapper)
         self.workflow_deployments = AsyncWorkflowDeploymentsClient(client_wrapper=self._client_wrapper)
         self.workflow_sandboxes = AsyncWorkflowSandboxesClient(client_wrapper=self._client_wrapper)
 
+    async def execute_code(
+        self,
+        *,
+        code: str,
+        runtime: CodeExecutionRuntime,
+        input_values: typing.Sequence[CodeExecutorInputRequest],
+        packages: typing.Sequence[CodeExecutionPackageRequest],
+        output_type: VellumVariableType,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> CodeExecutorResponse:
+        """
+        An internal-only endpoint that's subject to breaking changes without notice. Not intended for public use.
+
+        Parameters
+        ----------
+        code : str
+
+        runtime : CodeExecutionRuntime
+
+        input_values : typing.Sequence[CodeExecutorInputRequest]
+
+        packages : typing.Sequence[CodeExecutionPackageRequest]
+
+        output_type : VellumVariableType
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        CodeExecutorResponse
+
+
+        Examples
+        --------
+        import asyncio
+
+        from vellum import AsyncVellum, CodeExecutionPackageRequest, StringInputRequest
+
+        client = AsyncVellum(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.execute_code(
+                code="code",
+                runtime="PYTHON_3_11_6",
+                input_values=[
+                    StringInputRequest(
+                        name="name",
+                        value="value",
+                    )
+                ],
+                packages=[
+                    CodeExecutionPackageRequest(
+                        version="version",
+                        name="name",
+                    )
+                ],
+                output_type="STRING",
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            "v1/execute-code",
+            base_url=self._client_wrapper.get_environment().default,
+            method="POST",
+            json={
+                "code": code,
+                "runtime": runtime,
+                "input_values": convert_and_respect_annotation_metadata(
+                    object_=input_values, annotation=typing.Sequence[CodeExecutorInputRequest], direction="write"
+                ),
+                "packages": convert_and_respect_annotation_metadata(
+                    object_=packages, annotation=typing.Sequence[CodeExecutionPackageRequest], direction="write"
+                ),
+                "output_type": output_type,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    CodeExecutorResponse,
+                    parse_obj_as(
+                        type_=CodeExecutorResponse,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            if _response.status_code == 400:
+                raise BadRequestError(
+                    typing.cast(
+                        typing.Optional[typing.Any],
+                        parse_obj_as(
+                            type_=typing.Optional[typing.Any],  # type: ignore
+                            object_=_response.json(),
+                        ),
+                    )
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
     async def execute_prompt(
         self,
         *,

{vellum_ai-0.8.16 → vellum_ai-0.8.18}/src/vellum/core/client_wrapper.py

@@ -17,7 +17,7 @@ class BaseClientWrapper:
         headers: typing.Dict[str, str] = {
             "X-Fern-Language": "Python",
             "X-Fern-SDK-Name": "vellum-ai",
-            "X-Fern-SDK-Version": "0.8.16",
+            "X-Fern-SDK-Version": "0.8.18",
         }
         headers["X_API_KEY"] = self.api_key
         return headers

{vellum_ai-0.8.16 → vellum_ai-0.8.18}/src/vellum/resources/__init__.py

@@ -6,6 +6,7 @@ from . import (
     document_indexes,
     documents,
     folder_entities,
+    metric_definitions,
     sandboxes,
     test_suite_runs,
     test_suites,
@@ -25,6 +26,7 @@ __all__ = [
     "document_indexes",
     "documents",
     "folder_entities",
+    "metric_definitions",
     "sandboxes",
     "test_suite_runs",
     "test_suites",

vellum_ai-0.8.18/src/vellum/resources/metric_definitions/client.py

@@ -0,0 +1,178 @@
+# This file was auto-generated by Fern from our API Definition.
+
+import typing
+from ...core.client_wrapper import SyncClientWrapper
+from ...types.metric_definition_input_request import MetricDefinitionInputRequest
+from ...core.request_options import RequestOptions
+from ...types.metric_definition_execution import MetricDefinitionExecution
+from ...core.jsonable_encoder import jsonable_encoder
+from ...core.serialization import convert_and_respect_annotation_metadata
+from ...core.pydantic_utilities import parse_obj_as
+from json.decoder import JSONDecodeError
+from ...core.api_error import ApiError
+from ...core.client_wrapper import AsyncClientWrapper
+
+# this is used as the default value for optional parameters
+OMIT = typing.cast(typing.Any, ...)
+
+
+class MetricDefinitionsClient:
+    def __init__(self, *, client_wrapper: SyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    def execute_metric_definition(
+        self,
+        id: str,
+        *,
+        inputs: typing.Sequence[MetricDefinitionInputRequest],
+        release_tag: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> MetricDefinitionExecution:
+        """
+        An internal-only endpoint that's subject to breaking changes without notice. Not intended for public use.
+
+        Parameters
+        ----------
+        id : str
+            Either the Metric Definition's ID or its unique name
+
+        inputs : typing.Sequence[MetricDefinitionInputRequest]
+
+        release_tag : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        MetricDefinitionExecution
+
+
+        Examples
+        --------
+        from vellum import StringInputRequest, Vellum
+
+        client = Vellum(
+            api_key="YOUR_API_KEY",
+        )
+        client.metric_definitions.execute_metric_definition(
+            id="id",
+            inputs=[
+                StringInputRequest(
+                    name="name",
+                    value="value",
+                )
+            ],
+        )
+        """
+        _response = self._client_wrapper.httpx_client.request(
+            f"v1/metric-definitions/{jsonable_encoder(id)}/execute",
+            base_url=self._client_wrapper.get_environment().default,
+            method="POST",
+            json={
+                "inputs": convert_and_respect_annotation_metadata(
+                    object_=inputs, annotation=typing.Sequence[MetricDefinitionInputRequest], direction="write"
+                ),
+                "release_tag": release_tag,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    MetricDefinitionExecution,
+                    parse_obj_as(
+                        type_=MetricDefinitionExecution,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)
+
+
+class AsyncMetricDefinitionsClient:
+    def __init__(self, *, client_wrapper: AsyncClientWrapper):
+        self._client_wrapper = client_wrapper
+
+    async def execute_metric_definition(
+        self,
+        id: str,
+        *,
+        inputs: typing.Sequence[MetricDefinitionInputRequest],
+        release_tag: typing.Optional[str] = OMIT,
+        request_options: typing.Optional[RequestOptions] = None,
+    ) -> MetricDefinitionExecution:
+        """
+        An internal-only endpoint that's subject to breaking changes without notice. Not intended for public use.
+
+        Parameters
+        ----------
+        id : str
+            Either the Metric Definition's ID or its unique name
+
+        inputs : typing.Sequence[MetricDefinitionInputRequest]
+
+        release_tag : typing.Optional[str]
+
+        request_options : typing.Optional[RequestOptions]
+            Request-specific configuration.
+
+        Returns
+        -------
+        MetricDefinitionExecution
+
+
+        Examples
+        --------
+        import asyncio
+
+        from vellum import AsyncVellum, StringInputRequest
+
+        client = AsyncVellum(
+            api_key="YOUR_API_KEY",
+        )
+
+
+        async def main() -> None:
+            await client.metric_definitions.execute_metric_definition(
+                id="id",
+                inputs=[
+                    StringInputRequest(
+                        name="name",
+                        value="value",
+                    )
+                ],
+            )
+
+
+        asyncio.run(main())
+        """
+        _response = await self._client_wrapper.httpx_client.request(
+            f"v1/metric-definitions/{jsonable_encoder(id)}/execute",
+            base_url=self._client_wrapper.get_environment().default,
+            method="POST",
+            json={
+                "inputs": convert_and_respect_annotation_metadata(
+                    object_=inputs, annotation=typing.Sequence[MetricDefinitionInputRequest], direction="write"
+                ),
+                "release_tag": release_tag,
+            },
+            request_options=request_options,
+            omit=OMIT,
+        )
+        try:
+            if 200 <= _response.status_code < 300:
+                return typing.cast(
+                    MetricDefinitionExecution,
+                    parse_obj_as(
+                        type_=MetricDefinitionExecution,  # type: ignore
+                        object_=_response.json(),
+                    ),
+                )
+            _response_json = _response.json()
+        except JSONDecodeError:
+            raise ApiError(status_code=_response.status_code, body=_response.text)
+        raise ApiError(status_code=_response.status_code, body=_response_json)