opik 1.6.4__py3-none-any.whl → 1.9.71__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1021) hide show
  1. opik/__init__.py +33 -2
  2. opik/anonymizer/__init__.py +5 -0
  3. opik/anonymizer/anonymizer.py +12 -0
  4. opik/anonymizer/factory.py +80 -0
  5. opik/anonymizer/recursive_anonymizer.py +64 -0
  6. opik/anonymizer/rules.py +56 -0
  7. opik/anonymizer/rules_anonymizer.py +35 -0
  8. opik/api_objects/attachment/__init__.py +5 -0
  9. opik/api_objects/attachment/attachment.py +20 -0
  10. opik/api_objects/attachment/attachment_context.py +36 -0
  11. opik/api_objects/attachment/attachments_extractor.py +153 -0
  12. opik/api_objects/attachment/client.py +220 -0
  13. opik/api_objects/attachment/converters.py +51 -0
  14. opik/api_objects/attachment/decoder.py +18 -0
  15. opik/api_objects/attachment/decoder_base64.py +83 -0
  16. opik/api_objects/attachment/decoder_helpers.py +137 -0
  17. opik/api_objects/conversation/__init__.py +0 -0
  18. opik/api_objects/conversation/conversation_factory.py +43 -0
  19. opik/api_objects/conversation/conversation_thread.py +49 -0
  20. opik/api_objects/data_helpers.py +79 -0
  21. opik/api_objects/dataset/dataset.py +107 -45
  22. opik/api_objects/dataset/rest_operations.py +12 -3
  23. opik/api_objects/experiment/experiment.py +81 -45
  24. opik/api_objects/experiment/experiment_item.py +2 -1
  25. opik/api_objects/experiment/experiments_client.py +64 -0
  26. opik/api_objects/experiment/helpers.py +35 -11
  27. opik/api_objects/experiment/rest_operations.py +88 -19
  28. opik/api_objects/helpers.py +104 -7
  29. opik/api_objects/local_recording.py +81 -0
  30. opik/api_objects/opik_client.py +872 -174
  31. opik/api_objects/opik_query_language.py +136 -18
  32. opik/api_objects/optimization/__init__.py +3 -0
  33. opik/api_objects/optimization/optimization.py +39 -0
  34. opik/api_objects/prompt/__init__.py +13 -1
  35. opik/api_objects/prompt/base_prompt.py +69 -0
  36. opik/api_objects/prompt/base_prompt_template.py +29 -0
  37. opik/api_objects/prompt/chat/__init__.py +1 -0
  38. opik/api_objects/prompt/chat/chat_prompt.py +210 -0
  39. opik/api_objects/prompt/chat/chat_prompt_template.py +350 -0
  40. opik/api_objects/prompt/chat/content_renderer_registry.py +203 -0
  41. opik/api_objects/prompt/client.py +193 -41
  42. opik/api_objects/prompt/text/__init__.py +1 -0
  43. opik/api_objects/prompt/text/prompt.py +174 -0
  44. opik/api_objects/prompt/text/prompt_template.py +55 -0
  45. opik/api_objects/prompt/types.py +29 -0
  46. opik/api_objects/rest_stream_parser.py +98 -0
  47. opik/api_objects/search_helpers.py +89 -0
  48. opik/api_objects/span/span_client.py +165 -45
  49. opik/api_objects/span/span_data.py +136 -25
  50. opik/api_objects/threads/__init__.py +0 -0
  51. opik/api_objects/threads/threads_client.py +185 -0
  52. opik/api_objects/trace/trace_client.py +72 -36
  53. opik/api_objects/trace/trace_data.py +112 -26
  54. opik/api_objects/validation_helpers.py +3 -3
  55. opik/cli/__init__.py +5 -0
  56. opik/cli/__main__.py +6 -0
  57. opik/cli/configure.py +66 -0
  58. opik/cli/exports/__init__.py +131 -0
  59. opik/cli/exports/dataset.py +278 -0
  60. opik/cli/exports/experiment.py +784 -0
  61. opik/cli/exports/project.py +685 -0
  62. opik/cli/exports/prompt.py +578 -0
  63. opik/cli/exports/utils.py +406 -0
  64. opik/cli/harbor.py +39 -0
  65. opik/cli/healthcheck.py +21 -0
  66. opik/cli/imports/__init__.py +439 -0
  67. opik/cli/imports/dataset.py +143 -0
  68. opik/cli/imports/experiment.py +1192 -0
  69. opik/cli/imports/project.py +262 -0
  70. opik/cli/imports/prompt.py +177 -0
  71. opik/cli/imports/utils.py +280 -0
  72. opik/cli/main.py +49 -0
  73. opik/cli/proxy.py +93 -0
  74. opik/cli/usage_report/__init__.py +16 -0
  75. opik/cli/usage_report/charts.py +783 -0
  76. opik/cli/usage_report/cli.py +274 -0
  77. opik/cli/usage_report/constants.py +9 -0
  78. opik/cli/usage_report/extraction.py +749 -0
  79. opik/cli/usage_report/pdf.py +244 -0
  80. opik/cli/usage_report/statistics.py +78 -0
  81. opik/cli/usage_report/utils.py +235 -0
  82. opik/config.py +62 -4
  83. opik/configurator/configure.py +45 -6
  84. opik/configurator/opik_rest_helpers.py +4 -1
  85. opik/context_storage.py +164 -65
  86. opik/datetime_helpers.py +12 -0
  87. opik/decorator/arguments_helpers.py +9 -1
  88. opik/decorator/base_track_decorator.py +298 -146
  89. opik/decorator/context_manager/__init__.py +0 -0
  90. opik/decorator/context_manager/span_context_manager.py +123 -0
  91. opik/decorator/context_manager/trace_context_manager.py +84 -0
  92. opik/decorator/generator_wrappers.py +3 -2
  93. opik/decorator/inspect_helpers.py +11 -0
  94. opik/decorator/opik_args/__init__.py +13 -0
  95. opik/decorator/opik_args/api_classes.py +71 -0
  96. opik/decorator/opik_args/helpers.py +120 -0
  97. opik/decorator/span_creation_handler.py +49 -21
  98. opik/decorator/tracker.py +9 -1
  99. opik/dict_utils.py +3 -3
  100. opik/environment.py +13 -1
  101. opik/error_tracking/api.py +1 -1
  102. opik/error_tracking/before_send.py +6 -5
  103. opik/error_tracking/environment_details.py +29 -7
  104. opik/error_tracking/error_filtering/filter_by_response_status_code.py +42 -0
  105. opik/error_tracking/error_filtering/filter_chain_builder.py +14 -3
  106. opik/evaluation/__init__.py +14 -2
  107. opik/evaluation/engine/engine.py +280 -82
  108. opik/evaluation/engine/evaluation_tasks_executor.py +15 -10
  109. opik/evaluation/engine/helpers.py +34 -9
  110. opik/evaluation/engine/metrics_evaluator.py +237 -0
  111. opik/evaluation/engine/types.py +5 -4
  112. opik/evaluation/evaluation_result.py +169 -2
  113. opik/evaluation/evaluator.py +659 -58
  114. opik/evaluation/metrics/__init__.py +121 -6
  115. opik/evaluation/metrics/aggregated_metric.py +92 -0
  116. opik/evaluation/metrics/arguments_helpers.py +15 -21
  117. opik/evaluation/metrics/arguments_validator.py +38 -0
  118. opik/evaluation/metrics/base_metric.py +20 -10
  119. opik/evaluation/metrics/conversation/__init__.py +48 -0
  120. opik/evaluation/metrics/conversation/conversation_thread_metric.py +79 -0
  121. opik/evaluation/metrics/conversation/conversation_turns_factory.py +39 -0
  122. opik/evaluation/metrics/conversation/g_eval_wrappers.py +19 -0
  123. opik/evaluation/metrics/conversation/helpers.py +84 -0
  124. opik/evaluation/metrics/conversation/heuristics/__init__.py +14 -0
  125. opik/evaluation/metrics/conversation/heuristics/degeneration/__init__.py +3 -0
  126. opik/evaluation/metrics/conversation/heuristics/degeneration/metric.py +189 -0
  127. opik/evaluation/metrics/conversation/heuristics/degeneration/phrases.py +12 -0
  128. opik/evaluation/metrics/conversation/heuristics/knowledge_retention/__init__.py +3 -0
  129. opik/evaluation/metrics/conversation/heuristics/knowledge_retention/metric.py +172 -0
  130. opik/evaluation/metrics/conversation/llm_judges/__init__.py +32 -0
  131. opik/evaluation/metrics/conversation/llm_judges/conversational_coherence/__init__.py +0 -0
  132. opik/evaluation/metrics/conversation/llm_judges/conversational_coherence/metric.py +274 -0
  133. opik/evaluation/metrics/conversation/llm_judges/conversational_coherence/schema.py +16 -0
  134. opik/evaluation/metrics/conversation/llm_judges/conversational_coherence/templates.py +95 -0
  135. opik/evaluation/metrics/conversation/llm_judges/g_eval_wrappers.py +442 -0
  136. opik/evaluation/metrics/conversation/llm_judges/session_completeness/__init__.py +0 -0
  137. opik/evaluation/metrics/conversation/llm_judges/session_completeness/metric.py +295 -0
  138. opik/evaluation/metrics/conversation/llm_judges/session_completeness/schema.py +22 -0
  139. opik/evaluation/metrics/conversation/llm_judges/session_completeness/templates.py +139 -0
  140. opik/evaluation/metrics/conversation/llm_judges/user_frustration/__init__.py +0 -0
  141. opik/evaluation/metrics/conversation/llm_judges/user_frustration/metric.py +277 -0
  142. opik/evaluation/metrics/conversation/llm_judges/user_frustration/schema.py +16 -0
  143. opik/evaluation/metrics/conversation/llm_judges/user_frustration/templates.py +135 -0
  144. opik/evaluation/metrics/conversation/types.py +34 -0
  145. opik/evaluation/metrics/conversation_types.py +9 -0
  146. opik/evaluation/metrics/heuristics/bertscore.py +107 -0
  147. opik/evaluation/metrics/heuristics/bleu.py +43 -16
  148. opik/evaluation/metrics/heuristics/chrf.py +127 -0
  149. opik/evaluation/metrics/heuristics/contains.py +50 -11
  150. opik/evaluation/metrics/heuristics/distribution_metrics.py +331 -0
  151. opik/evaluation/metrics/heuristics/equals.py +4 -1
  152. opik/evaluation/metrics/heuristics/gleu.py +113 -0
  153. opik/evaluation/metrics/heuristics/is_json.py +9 -3
  154. opik/evaluation/metrics/heuristics/language_adherence.py +123 -0
  155. opik/evaluation/metrics/heuristics/levenshtein_ratio.py +6 -5
  156. opik/evaluation/metrics/heuristics/meteor.py +119 -0
  157. opik/evaluation/metrics/heuristics/prompt_injection.py +150 -0
  158. opik/evaluation/metrics/heuristics/readability.py +129 -0
  159. opik/evaluation/metrics/heuristics/regex_match.py +4 -1
  160. opik/evaluation/metrics/heuristics/rouge.py +148 -0
  161. opik/evaluation/metrics/heuristics/sentiment.py +98 -0
  162. opik/evaluation/metrics/heuristics/spearman.py +88 -0
  163. opik/evaluation/metrics/heuristics/tone.py +155 -0
  164. opik/evaluation/metrics/heuristics/vader_sentiment.py +77 -0
  165. opik/evaluation/metrics/llm_judges/answer_relevance/metric.py +27 -30
  166. opik/evaluation/metrics/llm_judges/answer_relevance/parser.py +27 -0
  167. opik/evaluation/metrics/llm_judges/answer_relevance/templates.py +10 -10
  168. opik/evaluation/metrics/llm_judges/context_precision/metric.py +28 -31
  169. opik/evaluation/metrics/llm_judges/context_precision/parser.py +27 -0
  170. opik/evaluation/metrics/llm_judges/context_precision/template.py +7 -7
  171. opik/evaluation/metrics/llm_judges/context_recall/metric.py +27 -31
  172. opik/evaluation/metrics/llm_judges/context_recall/parser.py +27 -0
  173. opik/evaluation/metrics/llm_judges/context_recall/template.py +7 -7
  174. opik/evaluation/metrics/llm_judges/factuality/metric.py +7 -26
  175. opik/evaluation/metrics/llm_judges/factuality/parser.py +35 -0
  176. opik/evaluation/metrics/llm_judges/factuality/template.py +1 -1
  177. opik/evaluation/metrics/llm_judges/g_eval/__init__.py +5 -0
  178. opik/evaluation/metrics/llm_judges/g_eval/metric.py +244 -113
  179. opik/evaluation/metrics/llm_judges/g_eval/parser.py +161 -0
  180. opik/evaluation/metrics/llm_judges/g_eval/presets.py +209 -0
  181. opik/evaluation/metrics/llm_judges/g_eval_presets/__init__.py +36 -0
  182. opik/evaluation/metrics/llm_judges/g_eval_presets/agent_assessment.py +77 -0
  183. opik/evaluation/metrics/llm_judges/g_eval_presets/bias_classifier.py +181 -0
  184. opik/evaluation/metrics/llm_judges/g_eval_presets/compliance_risk.py +41 -0
  185. opik/evaluation/metrics/llm_judges/g_eval_presets/prompt_uncertainty.py +41 -0
  186. opik/evaluation/metrics/llm_judges/g_eval_presets/qa_suite.py +146 -0
  187. opik/evaluation/metrics/llm_judges/hallucination/metric.py +23 -27
  188. opik/evaluation/metrics/llm_judges/hallucination/parser.py +29 -0
  189. opik/evaluation/metrics/llm_judges/hallucination/template.py +2 -4
  190. opik/evaluation/metrics/llm_judges/llm_juries/__init__.py +3 -0
  191. opik/evaluation/metrics/llm_judges/llm_juries/metric.py +76 -0
  192. opik/evaluation/metrics/llm_judges/moderation/metric.py +23 -28
  193. opik/evaluation/metrics/llm_judges/moderation/parser.py +27 -0
  194. opik/evaluation/metrics/llm_judges/moderation/template.py +2 -2
  195. opik/evaluation/metrics/llm_judges/parsing_helpers.py +26 -0
  196. opik/evaluation/metrics/llm_judges/structure_output_compliance/__init__.py +0 -0
  197. opik/evaluation/metrics/llm_judges/structure_output_compliance/metric.py +144 -0
  198. opik/evaluation/metrics/llm_judges/structure_output_compliance/parser.py +79 -0
  199. opik/evaluation/metrics/llm_judges/structure_output_compliance/schema.py +15 -0
  200. opik/evaluation/metrics/llm_judges/structure_output_compliance/template.py +50 -0
  201. opik/evaluation/metrics/llm_judges/syc_eval/__init__.py +0 -0
  202. opik/evaluation/metrics/llm_judges/syc_eval/metric.py +252 -0
  203. opik/evaluation/metrics/llm_judges/syc_eval/parser.py +82 -0
  204. opik/evaluation/metrics/llm_judges/syc_eval/template.py +155 -0
  205. opik/evaluation/metrics/llm_judges/trajectory_accuracy/__init__.py +3 -0
  206. opik/evaluation/metrics/llm_judges/trajectory_accuracy/metric.py +171 -0
  207. opik/evaluation/metrics/llm_judges/trajectory_accuracy/parser.py +38 -0
  208. opik/evaluation/metrics/llm_judges/trajectory_accuracy/templates.py +65 -0
  209. opik/evaluation/metrics/llm_judges/usefulness/metric.py +23 -32
  210. opik/evaluation/metrics/llm_judges/usefulness/parser.py +28 -0
  211. opik/evaluation/metrics/ragas_metric.py +112 -0
  212. opik/evaluation/models/__init__.py +10 -0
  213. opik/evaluation/models/base_model.py +140 -18
  214. opik/evaluation/models/langchain/__init__.py +3 -0
  215. opik/evaluation/models/langchain/langchain_chat_model.py +166 -0
  216. opik/evaluation/models/langchain/message_converters.py +106 -0
  217. opik/evaluation/models/langchain/opik_monitoring.py +23 -0
  218. opik/evaluation/models/litellm/litellm_chat_model.py +186 -40
  219. opik/evaluation/models/litellm/opik_monitor.py +24 -21
  220. opik/evaluation/models/litellm/util.py +125 -0
  221. opik/evaluation/models/litellm/warning_filters.py +16 -4
  222. opik/evaluation/models/model_capabilities.py +187 -0
  223. opik/evaluation/models/models_factory.py +25 -3
  224. opik/evaluation/preprocessing.py +92 -0
  225. opik/evaluation/report.py +70 -12
  226. opik/evaluation/rest_operations.py +49 -45
  227. opik/evaluation/samplers/__init__.py +4 -0
  228. opik/evaluation/samplers/base_dataset_sampler.py +40 -0
  229. opik/evaluation/samplers/random_dataset_sampler.py +48 -0
  230. opik/evaluation/score_statistics.py +66 -0
  231. opik/evaluation/scorers/__init__.py +4 -0
  232. opik/evaluation/scorers/scorer_function.py +55 -0
  233. opik/evaluation/scorers/scorer_wrapper_metric.py +130 -0
  234. opik/evaluation/test_case.py +3 -2
  235. opik/evaluation/test_result.py +1 -0
  236. opik/evaluation/threads/__init__.py +0 -0
  237. opik/evaluation/threads/context_helper.py +32 -0
  238. opik/evaluation/threads/evaluation_engine.py +181 -0
  239. opik/evaluation/threads/evaluation_result.py +18 -0
  240. opik/evaluation/threads/evaluator.py +120 -0
  241. opik/evaluation/threads/helpers.py +51 -0
  242. opik/evaluation/types.py +9 -1
  243. opik/exceptions.py +116 -3
  244. opik/file_upload/__init__.py +0 -0
  245. opik/file_upload/base_upload_manager.py +39 -0
  246. opik/file_upload/file_upload_monitor.py +14 -0
  247. opik/file_upload/file_uploader.py +141 -0
  248. opik/file_upload/mime_type.py +9 -0
  249. opik/file_upload/s3_multipart_upload/__init__.py +0 -0
  250. opik/file_upload/s3_multipart_upload/file_parts_strategy.py +89 -0
  251. opik/file_upload/s3_multipart_upload/s3_file_uploader.py +86 -0
  252. opik/file_upload/s3_multipart_upload/s3_upload_error.py +29 -0
  253. opik/file_upload/thread_pool.py +17 -0
  254. opik/file_upload/upload_client.py +114 -0
  255. opik/file_upload/upload_manager.py +255 -0
  256. opik/file_upload/upload_options.py +37 -0
  257. opik/format_helpers.py +17 -0
  258. opik/guardrails/__init__.py +4 -0
  259. opik/guardrails/guardrail.py +157 -0
  260. opik/guardrails/guards/__init__.py +5 -0
  261. opik/guardrails/guards/guard.py +17 -0
  262. opik/guardrails/guards/pii.py +47 -0
  263. opik/guardrails/guards/topic.py +76 -0
  264. opik/guardrails/rest_api_client.py +34 -0
  265. opik/guardrails/schemas.py +24 -0
  266. opik/guardrails/tracing.py +61 -0
  267. opik/healthcheck/__init__.py +2 -1
  268. opik/healthcheck/checks.py +2 -2
  269. opik/healthcheck/rich_representation.py +1 -1
  270. opik/hooks/__init__.py +23 -0
  271. opik/hooks/anonymizer_hook.py +36 -0
  272. opik/hooks/httpx_client_hook.py +112 -0
  273. opik/httpx_client.py +75 -4
  274. opik/id_helpers.py +18 -0
  275. opik/integrations/adk/__init__.py +14 -0
  276. opik/integrations/adk/callback_context_info_extractors.py +32 -0
  277. opik/integrations/adk/graph/__init__.py +0 -0
  278. opik/integrations/adk/graph/mermaid_graph_builder.py +128 -0
  279. opik/integrations/adk/graph/nodes.py +101 -0
  280. opik/integrations/adk/graph/subgraph_edges_builders.py +41 -0
  281. opik/integrations/adk/helpers.py +48 -0
  282. opik/integrations/adk/legacy_opik_tracer.py +381 -0
  283. opik/integrations/adk/opik_tracer.py +370 -0
  284. opik/integrations/adk/patchers/__init__.py +4 -0
  285. opik/integrations/adk/patchers/adk_otel_tracer/__init__.py +0 -0
  286. opik/integrations/adk/patchers/adk_otel_tracer/llm_span_helpers.py +30 -0
  287. opik/integrations/adk/patchers/adk_otel_tracer/opik_adk_otel_tracer.py +201 -0
  288. opik/integrations/adk/patchers/litellm_wrappers.py +91 -0
  289. opik/integrations/adk/patchers/llm_response_wrapper.py +105 -0
  290. opik/integrations/adk/patchers/patchers.py +64 -0
  291. opik/integrations/adk/recursive_callback_injector.py +126 -0
  292. opik/integrations/aisuite/aisuite_decorator.py +8 -3
  293. opik/integrations/aisuite/opik_tracker.py +1 -0
  294. opik/integrations/anthropic/messages_create_decorator.py +8 -3
  295. opik/integrations/anthropic/opik_tracker.py +0 -1
  296. opik/integrations/bedrock/converse/__init__.py +0 -0
  297. opik/integrations/bedrock/converse/chunks_aggregator.py +188 -0
  298. opik/integrations/bedrock/{converse_decorator.py → converse/converse_decorator.py} +18 -8
  299. opik/integrations/bedrock/invoke_agent_decorator.py +12 -7
  300. opik/integrations/bedrock/invoke_model/__init__.py +0 -0
  301. opik/integrations/bedrock/invoke_model/chunks_aggregator/__init__.py +78 -0
  302. opik/integrations/bedrock/invoke_model/chunks_aggregator/api.py +45 -0
  303. opik/integrations/bedrock/invoke_model/chunks_aggregator/base.py +23 -0
  304. opik/integrations/bedrock/invoke_model/chunks_aggregator/claude.py +121 -0
  305. opik/integrations/bedrock/invoke_model/chunks_aggregator/format_detector.py +107 -0
  306. opik/integrations/bedrock/invoke_model/chunks_aggregator/llama.py +108 -0
  307. opik/integrations/bedrock/invoke_model/chunks_aggregator/mistral.py +118 -0
  308. opik/integrations/bedrock/invoke_model/chunks_aggregator/nova.py +99 -0
  309. opik/integrations/bedrock/invoke_model/invoke_model_decorator.py +178 -0
  310. opik/integrations/bedrock/invoke_model/response_types.py +34 -0
  311. opik/integrations/bedrock/invoke_model/stream_wrappers.py +122 -0
  312. opik/integrations/bedrock/invoke_model/usage_converters.py +87 -0
  313. opik/integrations/bedrock/invoke_model/usage_extraction.py +108 -0
  314. opik/integrations/bedrock/opik_tracker.py +43 -4
  315. opik/integrations/bedrock/types.py +19 -0
  316. opik/integrations/crewai/crewai_decorator.py +34 -56
  317. opik/integrations/crewai/opik_tracker.py +31 -10
  318. opik/integrations/crewai/patchers/__init__.py +5 -0
  319. opik/integrations/crewai/patchers/flow.py +118 -0
  320. opik/integrations/crewai/patchers/litellm_completion.py +30 -0
  321. opik/integrations/crewai/patchers/llm_client.py +207 -0
  322. opik/integrations/dspy/callback.py +246 -84
  323. opik/integrations/dspy/graph.py +88 -0
  324. opik/integrations/dspy/parsers.py +168 -0
  325. opik/integrations/genai/encoder_extension.py +2 -6
  326. opik/integrations/genai/generate_content_decorator.py +20 -13
  327. opik/integrations/guardrails/guardrails_decorator.py +4 -0
  328. opik/integrations/harbor/__init__.py +17 -0
  329. opik/integrations/harbor/experiment_service.py +269 -0
  330. opik/integrations/harbor/opik_tracker.py +528 -0
  331. opik/integrations/haystack/constants.py +35 -0
  332. opik/integrations/haystack/converters.py +1 -2
  333. opik/integrations/haystack/opik_connector.py +28 -6
  334. opik/integrations/haystack/opik_span_bridge.py +284 -0
  335. opik/integrations/haystack/opik_tracer.py +124 -222
  336. opik/integrations/langchain/__init__.py +3 -1
  337. opik/integrations/langchain/helpers.py +96 -0
  338. opik/integrations/langchain/langgraph_async_context_bridge.py +131 -0
  339. opik/integrations/langchain/langgraph_tracer_injector.py +88 -0
  340. opik/integrations/langchain/opik_encoder_extension.py +2 -2
  341. opik/integrations/langchain/opik_tracer.py +641 -206
  342. opik/integrations/langchain/provider_usage_extractors/__init__.py +5 -0
  343. opik/integrations/langchain/provider_usage_extractors/anthropic_usage_extractor.py +101 -0
  344. opik/integrations/langchain/provider_usage_extractors/anthropic_vertexai_usage_extractor.py +67 -0
  345. opik/integrations/langchain/provider_usage_extractors/bedrock_usage_extractor.py +94 -0
  346. opik/integrations/langchain/provider_usage_extractors/google_generative_ai_usage_extractor.py +109 -0
  347. opik/integrations/langchain/provider_usage_extractors/groq_usage_extractor.py +92 -0
  348. opik/integrations/langchain/provider_usage_extractors/langchain_run_helpers/__init__.py +15 -0
  349. opik/integrations/langchain/provider_usage_extractors/langchain_run_helpers/helpers.py +134 -0
  350. opik/integrations/langchain/provider_usage_extractors/langchain_run_helpers/langchain_usage.py +163 -0
  351. opik/integrations/langchain/provider_usage_extractors/openai_usage_extractor.py +124 -0
  352. opik/integrations/langchain/provider_usage_extractors/provider_usage_extractor_protocol.py +29 -0
  353. opik/integrations/langchain/provider_usage_extractors/usage_extractor.py +48 -0
  354. opik/integrations/langchain/provider_usage_extractors/vertexai_usage_extractor.py +109 -0
  355. opik/integrations/litellm/__init__.py +5 -0
  356. opik/integrations/litellm/completion_chunks_aggregator.py +115 -0
  357. opik/integrations/litellm/litellm_completion_decorator.py +242 -0
  358. opik/integrations/litellm/opik_tracker.py +43 -0
  359. opik/integrations/litellm/stream_patchers.py +151 -0
  360. opik/integrations/llama_index/callback.py +179 -78
  361. opik/integrations/llama_index/event_parsing_utils.py +29 -9
  362. opik/integrations/openai/agents/opik_tracing_processor.py +204 -32
  363. opik/integrations/openai/agents/span_data_parsers.py +15 -6
  364. opik/integrations/openai/chat_completion_chunks_aggregator.py +1 -1
  365. opik/integrations/openai/{openai_decorator.py → openai_chat_completions_decorator.py} +45 -35
  366. opik/integrations/openai/openai_responses_decorator.py +158 -0
  367. opik/integrations/openai/opik_tracker.py +94 -13
  368. opik/integrations/openai/response_events_aggregator.py +36 -0
  369. opik/integrations/openai/stream_patchers.py +125 -15
  370. opik/integrations/sagemaker/auth.py +5 -1
  371. opik/jsonable_encoder.py +29 -1
  372. opik/llm_usage/base_original_provider_usage.py +15 -8
  373. opik/llm_usage/bedrock_usage.py +8 -2
  374. opik/llm_usage/google_usage.py +6 -1
  375. opik/llm_usage/llm_usage_info.py +6 -0
  376. opik/llm_usage/{openai_usage.py → openai_chat_completions_usage.py} +2 -12
  377. opik/llm_usage/{openai_agent_usage.py → openai_responses_usage.py} +7 -15
  378. opik/llm_usage/opik_usage.py +36 -10
  379. opik/llm_usage/opik_usage_factory.py +35 -19
  380. opik/logging_messages.py +19 -7
  381. opik/message_processing/arguments_utils.py +22 -0
  382. opik/message_processing/batching/base_batcher.py +45 -17
  383. opik/message_processing/batching/batch_manager.py +22 -10
  384. opik/message_processing/batching/batch_manager_constuctors.py +36 -11
  385. opik/message_processing/batching/batchers.py +167 -44
  386. opik/message_processing/batching/flushing_thread.py +0 -3
  387. opik/message_processing/batching/sequence_splitter.py +50 -5
  388. opik/message_processing/emulation/__init__.py +0 -0
  389. opik/message_processing/emulation/emulator_message_processor.py +578 -0
  390. opik/message_processing/emulation/local_emulator_message_processor.py +140 -0
  391. opik/message_processing/emulation/models.py +162 -0
  392. opik/message_processing/encoder_helpers.py +79 -0
  393. opik/message_processing/message_queue.py +79 -0
  394. opik/message_processing/messages.py +154 -12
  395. opik/message_processing/preprocessing/__init__.py +0 -0
  396. opik/message_processing/preprocessing/attachments_preprocessor.py +70 -0
  397. opik/message_processing/preprocessing/batching_preprocessor.py +53 -0
  398. opik/message_processing/preprocessing/constants.py +1 -0
  399. opik/message_processing/preprocessing/file_upload_preprocessor.py +38 -0
  400. opik/message_processing/preprocessing/preprocessor.py +36 -0
  401. opik/message_processing/processors/__init__.py +0 -0
  402. opik/message_processing/processors/attachments_extraction_processor.py +146 -0
  403. opik/message_processing/processors/message_processors.py +92 -0
  404. opik/message_processing/processors/message_processors_chain.py +96 -0
  405. opik/message_processing/processors/online_message_processor.py +324 -0
  406. opik/message_processing/queue_consumer.py +61 -13
  407. opik/message_processing/streamer.py +102 -31
  408. opik/message_processing/streamer_constructors.py +67 -12
  409. opik/opik_context.py +103 -11
  410. opik/plugins/pytest/decorator.py +2 -2
  411. opik/plugins/pytest/experiment_runner.py +3 -2
  412. opik/plugins/pytest/hooks.py +6 -4
  413. opik/rate_limit/__init__.py +0 -0
  414. opik/rate_limit/rate_limit.py +25 -0
  415. opik/rest_api/__init__.py +643 -11
  416. opik/rest_api/alerts/__init__.py +7 -0
  417. opik/rest_api/alerts/client.py +667 -0
  418. opik/rest_api/alerts/raw_client.py +1015 -0
  419. opik/rest_api/alerts/types/__init__.py +7 -0
  420. opik/rest_api/alerts/types/get_webhook_examples_request_alert_type.py +5 -0
  421. opik/rest_api/annotation_queues/__init__.py +4 -0
  422. opik/rest_api/annotation_queues/client.py +668 -0
  423. opik/rest_api/annotation_queues/raw_client.py +1019 -0
  424. opik/rest_api/attachments/__init__.py +17 -0
  425. opik/rest_api/attachments/client.py +752 -0
  426. opik/rest_api/attachments/raw_client.py +1125 -0
  427. opik/rest_api/attachments/types/__init__.py +15 -0
  428. opik/rest_api/attachments/types/attachment_list_request_entity_type.py +5 -0
  429. opik/rest_api/attachments/types/download_attachment_request_entity_type.py +5 -0
  430. opik/rest_api/attachments/types/start_multipart_upload_request_entity_type.py +5 -0
  431. opik/rest_api/attachments/types/upload_attachment_request_entity_type.py +5 -0
  432. opik/rest_api/automation_rule_evaluators/__init__.py +2 -0
  433. opik/rest_api/automation_rule_evaluators/client.py +182 -1162
  434. opik/rest_api/automation_rule_evaluators/raw_client.py +598 -0
  435. opik/rest_api/chat_completions/__init__.py +2 -0
  436. opik/rest_api/chat_completions/client.py +115 -149
  437. opik/rest_api/chat_completions/raw_client.py +339 -0
  438. opik/rest_api/check/__init__.py +2 -0
  439. opik/rest_api/check/client.py +88 -106
  440. opik/rest_api/check/raw_client.py +258 -0
  441. opik/rest_api/client.py +112 -212
  442. opik/rest_api/core/__init__.py +5 -0
  443. opik/rest_api/core/api_error.py +12 -6
  444. opik/rest_api/core/client_wrapper.py +4 -14
  445. opik/rest_api/core/datetime_utils.py +1 -3
  446. opik/rest_api/core/file.py +2 -5
  447. opik/rest_api/core/http_client.py +42 -120
  448. opik/rest_api/core/http_response.py +55 -0
  449. opik/rest_api/core/jsonable_encoder.py +1 -4
  450. opik/rest_api/core/pydantic_utilities.py +79 -147
  451. opik/rest_api/core/query_encoder.py +1 -3
  452. opik/rest_api/core/serialization.py +10 -10
  453. opik/rest_api/dashboards/__init__.py +4 -0
  454. opik/rest_api/dashboards/client.py +462 -0
  455. opik/rest_api/dashboards/raw_client.py +648 -0
  456. opik/rest_api/datasets/__init__.py +5 -0
  457. opik/rest_api/datasets/client.py +1638 -1091
  458. opik/rest_api/datasets/raw_client.py +3389 -0
  459. opik/rest_api/datasets/types/__init__.py +8 -0
  460. opik/rest_api/datasets/types/dataset_update_visibility.py +5 -0
  461. opik/rest_api/datasets/types/dataset_write_visibility.py +5 -0
  462. opik/rest_api/errors/__init__.py +2 -0
  463. opik/rest_api/errors/bad_request_error.py +4 -3
  464. opik/rest_api/errors/conflict_error.py +4 -3
  465. opik/rest_api/errors/forbidden_error.py +4 -2
  466. opik/rest_api/errors/not_found_error.py +4 -3
  467. opik/rest_api/errors/not_implemented_error.py +4 -3
  468. opik/rest_api/errors/unauthorized_error.py +4 -3
  469. opik/rest_api/errors/unprocessable_entity_error.py +4 -3
  470. opik/rest_api/experiments/__init__.py +5 -0
  471. opik/rest_api/experiments/client.py +676 -752
  472. opik/rest_api/experiments/raw_client.py +1872 -0
  473. opik/rest_api/experiments/types/__init__.py +10 -0
  474. opik/rest_api/experiments/types/experiment_update_status.py +5 -0
  475. opik/rest_api/experiments/types/experiment_update_type.py +5 -0
  476. opik/rest_api/experiments/types/experiment_write_status.py +5 -0
  477. opik/rest_api/experiments/types/experiment_write_type.py +5 -0
  478. opik/rest_api/feedback_definitions/__init__.py +2 -0
  479. opik/rest_api/feedback_definitions/client.py +96 -370
  480. opik/rest_api/feedback_definitions/raw_client.py +541 -0
  481. opik/rest_api/feedback_definitions/types/__init__.py +2 -0
  482. opik/rest_api/feedback_definitions/types/find_feedback_definitions_request_type.py +1 -3
  483. opik/rest_api/guardrails/__init__.py +4 -0
  484. opik/rest_api/guardrails/client.py +104 -0
  485. opik/rest_api/guardrails/raw_client.py +102 -0
  486. opik/rest_api/llm_provider_key/__init__.py +2 -0
  487. opik/rest_api/llm_provider_key/client.py +166 -440
  488. opik/rest_api/llm_provider_key/raw_client.py +643 -0
  489. opik/rest_api/llm_provider_key/types/__init__.py +2 -0
  490. opik/rest_api/llm_provider_key/types/provider_api_key_write_provider.py +1 -1
  491. opik/rest_api/manual_evaluation/__init__.py +4 -0
  492. opik/rest_api/manual_evaluation/client.py +347 -0
  493. opik/rest_api/manual_evaluation/raw_client.py +543 -0
  494. opik/rest_api/open_telemetry_ingestion/__init__.py +2 -0
  495. opik/rest_api/open_telemetry_ingestion/client.py +38 -63
  496. opik/rest_api/open_telemetry_ingestion/raw_client.py +88 -0
  497. opik/rest_api/optimizations/__init__.py +7 -0
  498. opik/rest_api/optimizations/client.py +704 -0
  499. opik/rest_api/optimizations/raw_client.py +920 -0
  500. opik/rest_api/optimizations/types/__init__.py +7 -0
  501. opik/rest_api/optimizations/types/optimization_update_status.py +7 -0
  502. opik/rest_api/projects/__init__.py +10 -1
  503. opik/rest_api/projects/client.py +180 -855
  504. opik/rest_api/projects/raw_client.py +1216 -0
  505. opik/rest_api/projects/types/__init__.py +11 -4
  506. opik/rest_api/projects/types/project_metric_request_public_interval.py +1 -3
  507. opik/rest_api/projects/types/project_metric_request_public_metric_type.py +11 -1
  508. opik/rest_api/projects/types/project_update_visibility.py +5 -0
  509. opik/rest_api/projects/types/project_write_visibility.py +5 -0
  510. opik/rest_api/prompts/__init__.py +4 -2
  511. opik/rest_api/prompts/client.py +381 -970
  512. opik/rest_api/prompts/raw_client.py +1634 -0
  513. opik/rest_api/prompts/types/__init__.py +5 -1
  514. opik/rest_api/prompts/types/create_prompt_version_detail_template_structure.py +5 -0
  515. opik/rest_api/prompts/types/prompt_write_template_structure.py +5 -0
  516. opik/rest_api/raw_client.py +156 -0
  517. opik/rest_api/redirect/__init__.py +4 -0
  518. opik/rest_api/redirect/client.py +375 -0
  519. opik/rest_api/redirect/raw_client.py +566 -0
  520. opik/rest_api/service_toggles/__init__.py +4 -0
  521. opik/rest_api/service_toggles/client.py +91 -0
  522. opik/rest_api/service_toggles/raw_client.py +93 -0
  523. opik/rest_api/spans/__init__.py +2 -0
  524. opik/rest_api/spans/client.py +659 -1354
  525. opik/rest_api/spans/raw_client.py +2383 -0
  526. opik/rest_api/spans/types/__init__.py +2 -0
  527. opik/rest_api/spans/types/find_feedback_score_names_1_request_type.py +1 -3
  528. opik/rest_api/spans/types/get_span_stats_request_type.py +1 -3
  529. opik/rest_api/spans/types/get_spans_by_project_request_type.py +1 -3
  530. opik/rest_api/spans/types/span_search_stream_request_public_type.py +1 -3
  531. opik/rest_api/system_usage/__init__.py +2 -0
  532. opik/rest_api/system_usage/client.py +157 -216
  533. opik/rest_api/system_usage/raw_client.py +455 -0
  534. opik/rest_api/traces/__init__.py +2 -0
  535. opik/rest_api/traces/client.py +2102 -1625
  536. opik/rest_api/traces/raw_client.py +4144 -0
  537. opik/rest_api/types/__init__.py +629 -24
  538. opik/rest_api/types/aggregation_data.py +27 -0
  539. opik/rest_api/types/alert.py +33 -0
  540. opik/rest_api/types/alert_alert_type.py +5 -0
  541. opik/rest_api/types/alert_page_public.py +24 -0
  542. opik/rest_api/types/alert_public.py +33 -0
  543. opik/rest_api/types/alert_public_alert_type.py +5 -0
  544. opik/rest_api/types/alert_trigger.py +27 -0
  545. opik/rest_api/types/alert_trigger_config.py +28 -0
  546. opik/rest_api/types/alert_trigger_config_public.py +28 -0
  547. opik/rest_api/types/alert_trigger_config_public_type.py +10 -0
  548. opik/rest_api/types/alert_trigger_config_type.py +10 -0
  549. opik/rest_api/types/alert_trigger_config_write.py +22 -0
  550. opik/rest_api/types/alert_trigger_config_write_type.py +10 -0
  551. opik/rest_api/types/alert_trigger_event_type.py +19 -0
  552. opik/rest_api/types/alert_trigger_public.py +27 -0
  553. opik/rest_api/types/alert_trigger_public_event_type.py +19 -0
  554. opik/rest_api/types/alert_trigger_write.py +23 -0
  555. opik/rest_api/types/alert_trigger_write_event_type.py +19 -0
  556. opik/rest_api/types/alert_write.py +28 -0
  557. opik/rest_api/types/alert_write_alert_type.py +5 -0
  558. opik/rest_api/types/annotation_queue.py +42 -0
  559. opik/rest_api/types/annotation_queue_batch.py +27 -0
  560. opik/rest_api/types/{json_schema_element.py → annotation_queue_item_ids.py} +5 -7
  561. opik/rest_api/types/annotation_queue_page_public.py +28 -0
  562. opik/rest_api/types/annotation_queue_public.py +38 -0
  563. opik/rest_api/types/annotation_queue_public_scope.py +5 -0
  564. opik/rest_api/types/{workspace_metadata.py → annotation_queue_reviewer.py} +6 -7
  565. opik/rest_api/types/annotation_queue_reviewer_public.py +20 -0
  566. opik/rest_api/types/annotation_queue_scope.py +5 -0
  567. opik/rest_api/types/annotation_queue_write.py +31 -0
  568. opik/rest_api/types/annotation_queue_write_scope.py +5 -0
  569. opik/rest_api/types/assistant_message.py +7 -8
  570. opik/rest_api/types/assistant_message_role.py +1 -3
  571. opik/rest_api/types/attachment.py +22 -0
  572. opik/rest_api/types/attachment_page.py +28 -0
  573. opik/rest_api/types/audio_url.py +19 -0
  574. opik/rest_api/types/audio_url_public.py +19 -0
  575. opik/rest_api/types/audio_url_write.py +19 -0
  576. opik/rest_api/types/automation_rule_evaluator.py +160 -0
  577. opik/rest_api/types/automation_rule_evaluator_llm_as_judge.py +6 -6
  578. opik/rest_api/types/automation_rule_evaluator_llm_as_judge_public.py +6 -6
  579. opik/rest_api/types/automation_rule_evaluator_llm_as_judge_write.py +6 -6
  580. opik/rest_api/types/automation_rule_evaluator_object_object_public.py +155 -0
  581. opik/rest_api/types/automation_rule_evaluator_page_public.py +6 -6
  582. opik/rest_api/types/automation_rule_evaluator_public.py +155 -0
  583. opik/rest_api/types/automation_rule_evaluator_span_llm_as_judge.py +22 -0
  584. opik/rest_api/types/automation_rule_evaluator_span_llm_as_judge_public.py +22 -0
  585. opik/rest_api/types/automation_rule_evaluator_span_llm_as_judge_write.py +22 -0
  586. opik/rest_api/types/automation_rule_evaluator_span_user_defined_metric_python.py +22 -0
  587. opik/rest_api/types/automation_rule_evaluator_span_user_defined_metric_python_public.py +22 -0
  588. opik/rest_api/types/automation_rule_evaluator_span_user_defined_metric_python_write.py +22 -0
  589. opik/rest_api/types/automation_rule_evaluator_trace_thread_llm_as_judge.py +22 -0
  590. opik/rest_api/types/automation_rule_evaluator_trace_thread_llm_as_judge_public.py +22 -0
  591. opik/rest_api/types/automation_rule_evaluator_trace_thread_llm_as_judge_write.py +22 -0
  592. opik/rest_api/types/automation_rule_evaluator_trace_thread_user_defined_metric_python.py +22 -0
  593. opik/rest_api/types/automation_rule_evaluator_trace_thread_user_defined_metric_python_public.py +22 -0
  594. opik/rest_api/types/automation_rule_evaluator_trace_thread_user_defined_metric_python_write.py +22 -0
  595. opik/rest_api/types/automation_rule_evaluator_update.py +143 -0
  596. opik/rest_api/types/automation_rule_evaluator_update_llm_as_judge.py +6 -6
  597. opik/rest_api/types/automation_rule_evaluator_update_span_llm_as_judge.py +22 -0
  598. opik/rest_api/types/automation_rule_evaluator_update_span_user_defined_metric_python.py +22 -0
  599. opik/rest_api/types/automation_rule_evaluator_update_trace_thread_llm_as_judge.py +22 -0
  600. opik/rest_api/types/automation_rule_evaluator_update_trace_thread_user_defined_metric_python.py +22 -0
  601. opik/rest_api/types/automation_rule_evaluator_update_user_defined_metric_python.py +6 -6
  602. opik/rest_api/types/automation_rule_evaluator_user_defined_metric_python.py +6 -6
  603. opik/rest_api/types/automation_rule_evaluator_user_defined_metric_python_public.py +6 -6
  604. opik/rest_api/types/automation_rule_evaluator_user_defined_metric_python_write.py +6 -6
  605. opik/rest_api/types/automation_rule_evaluator_write.py +143 -0
  606. opik/rest_api/types/avg_value_stat_public.py +3 -5
  607. opik/rest_api/types/batch_delete.py +3 -5
  608. opik/rest_api/types/batch_delete_by_project.py +20 -0
  609. opik/rest_api/types/bi_information.py +3 -5
  610. opik/rest_api/types/bi_information_response.py +4 -6
  611. opik/rest_api/types/boolean_feedback_definition.py +25 -0
  612. opik/rest_api/types/boolean_feedback_definition_create.py +20 -0
  613. opik/rest_api/types/boolean_feedback_definition_public.py +25 -0
  614. opik/rest_api/types/boolean_feedback_definition_update.py +20 -0
  615. opik/rest_api/types/boolean_feedback_detail.py +29 -0
  616. opik/rest_api/types/boolean_feedback_detail_create.py +29 -0
  617. opik/rest_api/types/boolean_feedback_detail_public.py +29 -0
  618. opik/rest_api/types/boolean_feedback_detail_update.py +29 -0
  619. opik/rest_api/types/categorical_feedback_definition.py +5 -7
  620. opik/rest_api/types/categorical_feedback_definition_create.py +4 -6
  621. opik/rest_api/types/categorical_feedback_definition_public.py +5 -7
  622. opik/rest_api/types/categorical_feedback_definition_update.py +4 -6
  623. opik/rest_api/types/categorical_feedback_detail.py +3 -5
  624. opik/rest_api/types/categorical_feedback_detail_create.py +3 -5
  625. opik/rest_api/types/categorical_feedback_detail_public.py +3 -5
  626. opik/rest_api/types/categorical_feedback_detail_update.py +3 -5
  627. opik/rest_api/types/chat_completion_choice.py +4 -6
  628. opik/rest_api/types/chat_completion_response.py +5 -6
  629. opik/rest_api/types/check.py +22 -0
  630. opik/rest_api/types/{json_node_compare.py → check_name.py} +1 -1
  631. opik/rest_api/types/check_public.py +22 -0
  632. opik/rest_api/types/check_public_name.py +5 -0
  633. opik/rest_api/types/check_public_result.py +5 -0
  634. opik/rest_api/types/check_result.py +5 -0
  635. opik/rest_api/types/chunked_output_json_node.py +4 -6
  636. opik/rest_api/types/chunked_output_json_node_public.py +4 -6
  637. opik/rest_api/types/chunked_output_json_node_public_type.py +6 -10
  638. opik/rest_api/types/chunked_output_json_node_type.py +6 -10
  639. opik/rest_api/types/column.py +8 -10
  640. opik/rest_api/types/column_compare.py +8 -10
  641. opik/rest_api/types/column_public.py +8 -10
  642. opik/rest_api/types/column_types_item.py +1 -3
  643. opik/rest_api/types/comment.py +4 -6
  644. opik/rest_api/types/comment_compare.py +4 -6
  645. opik/rest_api/types/comment_public.py +4 -6
  646. opik/rest_api/types/complete_multipart_upload_request.py +33 -0
  647. opik/rest_api/types/complete_multipart_upload_request_entity_type.py +5 -0
  648. opik/rest_api/types/completion_tokens_details.py +3 -5
  649. opik/rest_api/types/count_value_stat_public.py +3 -5
  650. opik/rest_api/types/dashboard_page_public.py +24 -0
  651. opik/rest_api/types/dashboard_public.py +30 -0
  652. opik/rest_api/types/data_point_double.py +21 -0
  653. opik/rest_api/types/data_point_number_public.py +3 -5
  654. opik/rest_api/types/dataset.py +14 -6
  655. opik/rest_api/types/dataset_expansion.py +42 -0
  656. opik/rest_api/types/dataset_expansion_response.py +39 -0
  657. opik/rest_api/types/dataset_item.py +9 -8
  658. opik/rest_api/types/dataset_item_batch.py +3 -5
  659. opik/rest_api/types/dataset_item_changes_public.py +5 -0
  660. opik/rest_api/types/dataset_item_compare.py +9 -8
  661. opik/rest_api/types/dataset_item_compare_source.py +1 -3
  662. opik/rest_api/types/dataset_item_filter.py +27 -0
  663. opik/rest_api/types/dataset_item_filter_operator.py +21 -0
  664. opik/rest_api/types/dataset_item_page_compare.py +10 -7
  665. opik/rest_api/types/dataset_item_page_public.py +10 -7
  666. opik/rest_api/types/dataset_item_public.py +9 -8
  667. opik/rest_api/types/dataset_item_public_source.py +1 -3
  668. opik/rest_api/types/dataset_item_source.py +1 -3
  669. opik/rest_api/types/dataset_item_update.py +39 -0
  670. opik/rest_api/types/dataset_item_write.py +5 -6
  671. opik/rest_api/types/dataset_item_write_source.py +1 -3
  672. opik/rest_api/types/dataset_page_public.py +9 -6
  673. opik/rest_api/types/dataset_public.py +14 -6
  674. opik/rest_api/types/dataset_public_status.py +5 -0
  675. opik/rest_api/types/dataset_public_visibility.py +5 -0
  676. opik/rest_api/types/dataset_status.py +5 -0
  677. opik/rest_api/types/dataset_version_diff.py +22 -0
  678. opik/rest_api/types/dataset_version_diff_stats.py +24 -0
  679. opik/rest_api/types/dataset_version_page_public.py +23 -0
  680. opik/rest_api/types/dataset_version_public.py +59 -0
  681. opik/rest_api/types/dataset_version_summary.py +46 -0
  682. opik/rest_api/types/dataset_version_summary_public.py +46 -0
  683. opik/rest_api/types/dataset_visibility.py +5 -0
  684. opik/rest_api/types/delete_attachments_request.py +23 -0
  685. opik/rest_api/types/delete_attachments_request_entity_type.py +5 -0
  686. opik/rest_api/types/delete_feedback_score.py +4 -5
  687. opik/rest_api/types/delete_ids_holder.py +19 -0
  688. opik/rest_api/types/delta.py +7 -9
  689. opik/rest_api/types/error_count_with_deviation.py +21 -0
  690. opik/rest_api/types/error_count_with_deviation_detailed.py +21 -0
  691. opik/rest_api/types/error_info.py +3 -5
  692. opik/rest_api/types/error_info_experiment_item_bulk_write_view.py +21 -0
  693. opik/rest_api/types/error_info_public.py +3 -5
  694. opik/rest_api/types/error_info_write.py +3 -5
  695. opik/rest_api/types/error_message.py +3 -5
  696. opik/rest_api/types/error_message_detail.py +3 -5
  697. opik/rest_api/types/error_message_detailed.py +3 -5
  698. opik/rest_api/types/error_message_public.py +3 -5
  699. opik/rest_api/types/experiment.py +21 -10
  700. opik/rest_api/types/experiment_group_aggregations_response.py +20 -0
  701. opik/rest_api/types/experiment_group_response.py +22 -0
  702. opik/rest_api/types/experiment_item.py +14 -11
  703. opik/rest_api/types/experiment_item_bulk_record.py +27 -0
  704. opik/rest_api/types/experiment_item_bulk_record_experiment_item_bulk_write_view.py +27 -0
  705. opik/rest_api/types/experiment_item_bulk_upload.py +27 -0
  706. opik/rest_api/types/experiment_item_compare.py +14 -11
  707. opik/rest_api/types/experiment_item_compare_trace_visibility_mode.py +5 -0
  708. opik/rest_api/types/experiment_item_public.py +6 -6
  709. opik/rest_api/types/experiment_item_public_trace_visibility_mode.py +5 -0
  710. opik/rest_api/types/experiment_item_trace_visibility_mode.py +5 -0
  711. opik/rest_api/types/experiment_page_public.py +9 -6
  712. opik/rest_api/types/experiment_public.py +21 -10
  713. opik/rest_api/types/experiment_public_status.py +5 -0
  714. opik/rest_api/types/experiment_public_type.py +5 -0
  715. opik/rest_api/types/experiment_score.py +20 -0
  716. opik/rest_api/types/experiment_score_public.py +20 -0
  717. opik/rest_api/types/experiment_score_write.py +20 -0
  718. opik/rest_api/types/experiment_status.py +5 -0
  719. opik/rest_api/types/experiment_type.py +5 -0
  720. opik/rest_api/types/export_trace_service_request.py +5 -0
  721. opik/rest_api/types/feedback.py +40 -27
  722. opik/rest_api/types/feedback_create.py +27 -13
  723. opik/rest_api/types/feedback_definition_page_public.py +4 -6
  724. opik/rest_api/types/feedback_object_public.py +40 -27
  725. opik/rest_api/types/feedback_public.py +40 -27
  726. opik/rest_api/types/feedback_score.py +7 -7
  727. opik/rest_api/types/feedback_score_average.py +3 -5
  728. opik/rest_api/types/feedback_score_average_detailed.py +3 -5
  729. opik/rest_api/types/feedback_score_average_public.py +3 -5
  730. opik/rest_api/types/feedback_score_batch.py +4 -6
  731. opik/rest_api/types/feedback_score_batch_item.py +6 -6
  732. opik/rest_api/types/feedback_score_batch_item_source.py +1 -3
  733. opik/rest_api/types/feedback_score_batch_item_thread.py +32 -0
  734. opik/rest_api/types/feedback_score_batch_item_thread_source.py +5 -0
  735. opik/rest_api/types/feedback_score_compare.py +7 -7
  736. opik/rest_api/types/feedback_score_compare_source.py +1 -3
  737. opik/rest_api/types/feedback_score_experiment_item_bulk_write_view.py +31 -0
  738. opik/rest_api/types/feedback_score_experiment_item_bulk_write_view_source.py +5 -0
  739. opik/rest_api/types/feedback_score_names.py +4 -6
  740. opik/rest_api/types/feedback_score_public.py +11 -7
  741. opik/rest_api/types/feedback_score_public_source.py +1 -3
  742. opik/rest_api/types/feedback_score_source.py +1 -3
  743. opik/rest_api/types/feedback_update.py +27 -13
  744. opik/rest_api/types/function.py +4 -7
  745. opik/rest_api/types/function_call.py +3 -5
  746. opik/rest_api/types/group_content.py +19 -0
  747. opik/rest_api/types/group_content_with_aggregations.py +21 -0
  748. opik/rest_api/types/group_detail.py +19 -0
  749. opik/rest_api/types/group_details.py +20 -0
  750. opik/rest_api/types/guardrail.py +34 -0
  751. opik/rest_api/types/guardrail_batch.py +20 -0
  752. opik/rest_api/types/guardrail_name.py +5 -0
  753. opik/rest_api/types/guardrail_result.py +5 -0
  754. opik/rest_api/types/guardrail_write.py +33 -0
  755. opik/rest_api/types/guardrail_write_name.py +5 -0
  756. opik/rest_api/types/guardrail_write_result.py +5 -0
  757. opik/rest_api/types/guardrails_validation.py +21 -0
  758. opik/rest_api/types/guardrails_validation_public.py +21 -0
  759. opik/rest_api/types/ids_holder.py +19 -0
  760. opik/rest_api/types/image_url.py +20 -0
  761. opik/rest_api/types/image_url_public.py +20 -0
  762. opik/rest_api/types/image_url_write.py +20 -0
  763. opik/rest_api/types/json_list_string.py +7 -0
  764. opik/rest_api/types/json_list_string_compare.py +7 -0
  765. opik/rest_api/types/json_list_string_experiment_item_bulk_write_view.py +7 -0
  766. opik/rest_api/types/json_list_string_public.py +7 -0
  767. opik/rest_api/types/json_list_string_write.py +7 -0
  768. opik/rest_api/types/json_schema.py +5 -8
  769. opik/rest_api/types/llm_as_judge_code.py +8 -12
  770. opik/rest_api/types/llm_as_judge_code_public.py +8 -12
  771. opik/rest_api/types/llm_as_judge_code_write.py +8 -12
  772. opik/rest_api/types/llm_as_judge_message.py +9 -7
  773. opik/rest_api/types/llm_as_judge_message_content.py +26 -0
  774. opik/rest_api/types/llm_as_judge_message_content_public.py +26 -0
  775. opik/rest_api/types/llm_as_judge_message_content_write.py +26 -0
  776. opik/rest_api/types/llm_as_judge_message_public.py +9 -7
  777. opik/rest_api/types/llm_as_judge_message_public_role.py +1 -1
  778. opik/rest_api/types/llm_as_judge_message_role.py +1 -1
  779. opik/rest_api/types/llm_as_judge_message_write.py +9 -7
  780. opik/rest_api/types/llm_as_judge_message_write_role.py +1 -1
  781. opik/rest_api/types/llm_as_judge_model_parameters.py +6 -5
  782. opik/rest_api/types/llm_as_judge_model_parameters_public.py +6 -5
  783. opik/rest_api/types/llm_as_judge_model_parameters_write.py +6 -5
  784. opik/rest_api/types/llm_as_judge_output_schema.py +4 -6
  785. opik/rest_api/types/llm_as_judge_output_schema_public.py +4 -6
  786. opik/rest_api/types/llm_as_judge_output_schema_public_type.py +1 -3
  787. opik/rest_api/types/llm_as_judge_output_schema_type.py +1 -3
  788. opik/rest_api/types/llm_as_judge_output_schema_write.py +4 -6
  789. opik/rest_api/types/llm_as_judge_output_schema_write_type.py +1 -3
  790. opik/rest_api/types/log_item.py +5 -7
  791. opik/rest_api/types/log_item_level.py +1 -3
  792. opik/rest_api/types/log_page.py +4 -6
  793. opik/rest_api/types/manual_evaluation_request.py +38 -0
  794. opik/rest_api/types/manual_evaluation_request_entity_type.py +5 -0
  795. opik/rest_api/types/manual_evaluation_response.py +27 -0
  796. opik/rest_api/types/multipart_upload_part.py +20 -0
  797. opik/rest_api/types/numerical_feedback_definition.py +5 -7
  798. opik/rest_api/types/numerical_feedback_definition_create.py +4 -6
  799. opik/rest_api/types/numerical_feedback_definition_public.py +5 -7
  800. opik/rest_api/types/numerical_feedback_definition_update.py +4 -6
  801. opik/rest_api/types/numerical_feedback_detail.py +3 -5
  802. opik/rest_api/types/numerical_feedback_detail_create.py +3 -5
  803. opik/rest_api/types/numerical_feedback_detail_public.py +3 -5
  804. opik/rest_api/types/numerical_feedback_detail_update.py +3 -5
  805. opik/rest_api/types/optimization.py +37 -0
  806. opik/rest_api/types/optimization_page_public.py +28 -0
  807. opik/rest_api/types/optimization_public.py +37 -0
  808. opik/rest_api/types/optimization_public_status.py +7 -0
  809. opik/rest_api/types/optimization_status.py +7 -0
  810. opik/rest_api/types/optimization_studio_config.py +27 -0
  811. opik/rest_api/types/optimization_studio_config_public.py +27 -0
  812. opik/rest_api/types/optimization_studio_config_write.py +27 -0
  813. opik/rest_api/types/optimization_studio_log.py +22 -0
  814. opik/rest_api/types/optimization_write.py +30 -0
  815. opik/rest_api/types/optimization_write_status.py +7 -0
  816. opik/rest_api/types/page_columns.py +4 -6
  817. opik/rest_api/types/percentage_value_stat_public.py +4 -6
  818. opik/rest_api/types/percentage_values.py +8 -16
  819. opik/rest_api/types/percentage_values_detailed.py +8 -16
  820. opik/rest_api/types/percentage_values_public.py +8 -16
  821. opik/rest_api/types/project.py +12 -7
  822. opik/rest_api/types/project_detailed.py +12 -7
  823. opik/rest_api/types/project_detailed_visibility.py +5 -0
  824. opik/rest_api/types/project_metric_response_public.py +5 -9
  825. opik/rest_api/types/project_metric_response_public_interval.py +1 -3
  826. opik/rest_api/types/project_metric_response_public_metric_type.py +11 -1
  827. opik/rest_api/types/project_page_public.py +8 -10
  828. opik/rest_api/types/project_public.py +6 -6
  829. opik/rest_api/types/project_public_visibility.py +5 -0
  830. opik/rest_api/types/project_reference.py +31 -0
  831. opik/rest_api/types/project_reference_public.py +31 -0
  832. opik/rest_api/types/project_stat_item_object_public.py +8 -17
  833. opik/rest_api/types/project_stats_public.py +4 -6
  834. opik/rest_api/types/project_stats_summary.py +4 -6
  835. opik/rest_api/types/project_stats_summary_item.py +9 -6
  836. opik/rest_api/types/project_visibility.py +5 -0
  837. opik/rest_api/types/prompt.py +12 -7
  838. opik/rest_api/types/prompt_detail.py +12 -7
  839. opik/rest_api/types/prompt_detail_template_structure.py +5 -0
  840. opik/rest_api/types/prompt_page_public.py +9 -6
  841. opik/rest_api/types/prompt_public.py +11 -6
  842. opik/rest_api/types/prompt_public_template_structure.py +5 -0
  843. opik/rest_api/types/prompt_template_structure.py +5 -0
  844. opik/rest_api/types/prompt_tokens_details.py +19 -0
  845. opik/rest_api/types/prompt_version.py +7 -6
  846. opik/rest_api/types/prompt_version_detail.py +7 -6
  847. opik/rest_api/types/prompt_version_detail_template_structure.py +5 -0
  848. opik/rest_api/types/prompt_version_link.py +4 -5
  849. opik/rest_api/types/prompt_version_link_public.py +4 -5
  850. opik/rest_api/types/prompt_version_link_write.py +3 -5
  851. opik/rest_api/types/prompt_version_page_public.py +9 -6
  852. opik/rest_api/types/prompt_version_public.py +7 -6
  853. opik/rest_api/types/prompt_version_public_template_structure.py +5 -0
  854. opik/rest_api/types/prompt_version_template_structure.py +5 -0
  855. opik/rest_api/types/prompt_version_update.py +33 -0
  856. opik/rest_api/types/provider_api_key.py +18 -8
  857. opik/rest_api/types/provider_api_key_page_public.py +27 -0
  858. opik/rest_api/types/provider_api_key_provider.py +1 -1
  859. opik/rest_api/types/provider_api_key_public.py +18 -8
  860. opik/rest_api/types/provider_api_key_public_provider.py +1 -1
  861. opik/rest_api/types/response_format.py +5 -7
  862. opik/rest_api/types/response_format_type.py +1 -3
  863. opik/rest_api/types/result.py +21 -0
  864. opik/rest_api/types/results_number_public.py +4 -6
  865. opik/rest_api/types/score_name.py +4 -5
  866. opik/rest_api/types/service_toggles_config.py +44 -0
  867. opik/rest_api/types/span.py +13 -15
  868. opik/rest_api/types/span_batch.py +4 -6
  869. opik/rest_api/types/span_enrichment_options.py +31 -0
  870. opik/rest_api/types/span_experiment_item_bulk_write_view.py +39 -0
  871. opik/rest_api/types/span_experiment_item_bulk_write_view_type.py +5 -0
  872. opik/rest_api/types/span_filter.py +23 -0
  873. opik/rest_api/types/span_filter_operator.py +21 -0
  874. opik/rest_api/types/span_filter_public.py +4 -6
  875. opik/rest_api/types/span_filter_public_operator.py +2 -0
  876. opik/rest_api/types/span_filter_write.py +23 -0
  877. opik/rest_api/types/span_filter_write_operator.py +21 -0
  878. opik/rest_api/types/span_llm_as_judge_code.py +27 -0
  879. opik/rest_api/types/span_llm_as_judge_code_public.py +27 -0
  880. opik/rest_api/types/span_llm_as_judge_code_write.py +27 -0
  881. opik/rest_api/types/span_page_public.py +9 -6
  882. opik/rest_api/types/span_public.py +19 -16
  883. opik/rest_api/types/span_public_type.py +1 -1
  884. opik/rest_api/types/span_type.py +1 -1
  885. opik/rest_api/types/span_update.py +46 -0
  886. opik/rest_api/types/span_update_type.py +5 -0
  887. opik/rest_api/types/span_user_defined_metric_python_code.py +20 -0
  888. opik/rest_api/types/span_user_defined_metric_python_code_public.py +20 -0
  889. opik/rest_api/types/span_user_defined_metric_python_code_write.py +20 -0
  890. opik/rest_api/types/span_write.py +13 -14
  891. opik/rest_api/types/span_write_type.py +1 -1
  892. opik/rest_api/types/spans_count_response.py +20 -0
  893. opik/rest_api/types/start_multipart_upload_response.py +20 -0
  894. opik/rest_api/types/stream_options.py +3 -5
  895. opik/rest_api/types/studio_evaluation.py +20 -0
  896. opik/rest_api/types/studio_evaluation_public.py +20 -0
  897. opik/rest_api/types/studio_evaluation_write.py +20 -0
  898. opik/rest_api/types/studio_llm_model.py +21 -0
  899. opik/rest_api/types/studio_llm_model_public.py +21 -0
  900. opik/rest_api/types/studio_llm_model_write.py +21 -0
  901. opik/rest_api/types/studio_message.py +20 -0
  902. opik/rest_api/types/studio_message_public.py +20 -0
  903. opik/rest_api/types/studio_message_write.py +20 -0
  904. opik/rest_api/types/studio_metric.py +21 -0
  905. opik/rest_api/types/studio_metric_public.py +21 -0
  906. opik/rest_api/types/studio_metric_write.py +21 -0
  907. opik/rest_api/types/studio_optimizer.py +21 -0
  908. opik/rest_api/types/studio_optimizer_public.py +21 -0
  909. opik/rest_api/types/studio_optimizer_write.py +21 -0
  910. opik/rest_api/types/studio_prompt.py +20 -0
  911. opik/rest_api/types/studio_prompt_public.py +20 -0
  912. opik/rest_api/types/studio_prompt_write.py +20 -0
  913. opik/rest_api/types/tool.py +4 -6
  914. opik/rest_api/types/tool_call.py +4 -6
  915. opik/rest_api/types/trace.py +26 -12
  916. opik/rest_api/types/trace_batch.py +4 -6
  917. opik/rest_api/types/trace_count_response.py +4 -6
  918. opik/rest_api/types/trace_enrichment_options.py +32 -0
  919. opik/rest_api/types/trace_experiment_item_bulk_write_view.py +41 -0
  920. opik/rest_api/types/trace_filter.py +23 -0
  921. opik/rest_api/types/trace_filter_operator.py +21 -0
  922. opik/rest_api/types/trace_filter_public.py +23 -0
  923. opik/rest_api/types/trace_filter_public_operator.py +21 -0
  924. opik/rest_api/types/trace_filter_write.py +23 -0
  925. opik/rest_api/types/trace_filter_write_operator.py +21 -0
  926. opik/rest_api/types/trace_page_public.py +8 -10
  927. opik/rest_api/types/trace_public.py +27 -13
  928. opik/rest_api/types/trace_public_visibility_mode.py +5 -0
  929. opik/rest_api/types/trace_thread.py +18 -9
  930. opik/rest_api/types/trace_thread_filter.py +23 -0
  931. opik/rest_api/types/trace_thread_filter_operator.py +21 -0
  932. opik/rest_api/types/trace_thread_filter_public.py +23 -0
  933. opik/rest_api/types/trace_thread_filter_public_operator.py +21 -0
  934. opik/rest_api/types/trace_thread_filter_write.py +23 -0
  935. opik/rest_api/types/trace_thread_filter_write_operator.py +21 -0
  936. opik/rest_api/types/trace_thread_identifier.py +22 -0
  937. opik/rest_api/types/trace_thread_llm_as_judge_code.py +26 -0
  938. opik/rest_api/types/trace_thread_llm_as_judge_code_public.py +26 -0
  939. opik/rest_api/types/trace_thread_llm_as_judge_code_write.py +26 -0
  940. opik/rest_api/types/trace_thread_page.py +9 -6
  941. opik/rest_api/types/trace_thread_status.py +5 -0
  942. opik/rest_api/types/trace_thread_update.py +19 -0
  943. opik/rest_api/types/trace_thread_user_defined_metric_python_code.py +19 -0
  944. opik/rest_api/types/trace_thread_user_defined_metric_python_code_public.py +19 -0
  945. opik/rest_api/types/trace_thread_user_defined_metric_python_code_write.py +19 -0
  946. opik/rest_api/types/trace_update.py +39 -0
  947. opik/rest_api/types/trace_visibility_mode.py +5 -0
  948. opik/rest_api/types/trace_write.py +10 -11
  949. opik/rest_api/types/usage.py +6 -6
  950. opik/rest_api/types/user_defined_metric_python_code.py +3 -5
  951. opik/rest_api/types/user_defined_metric_python_code_public.py +3 -5
  952. opik/rest_api/types/user_defined_metric_python_code_write.py +3 -5
  953. opik/rest_api/types/value_entry.py +27 -0
  954. opik/rest_api/types/value_entry_compare.py +27 -0
  955. opik/rest_api/types/value_entry_compare_source.py +5 -0
  956. opik/rest_api/types/value_entry_experiment_item_bulk_write_view.py +27 -0
  957. opik/rest_api/types/value_entry_experiment_item_bulk_write_view_source.py +5 -0
  958. opik/rest_api/types/value_entry_public.py +27 -0
  959. opik/rest_api/types/value_entry_public_source.py +5 -0
  960. opik/rest_api/types/value_entry_source.py +5 -0
  961. opik/rest_api/types/video_url.py +19 -0
  962. opik/rest_api/types/video_url_public.py +19 -0
  963. opik/rest_api/types/video_url_write.py +19 -0
  964. opik/rest_api/types/webhook.py +28 -0
  965. opik/rest_api/types/webhook_examples.py +19 -0
  966. opik/rest_api/types/webhook_public.py +28 -0
  967. opik/rest_api/types/webhook_test_result.py +23 -0
  968. opik/rest_api/types/webhook_test_result_status.py +5 -0
  969. opik/rest_api/types/webhook_write.py +23 -0
  970. opik/rest_api/types/welcome_wizard_tracking.py +22 -0
  971. opik/rest_api/types/workspace_configuration.py +27 -0
  972. opik/rest_api/types/workspace_metric_request.py +24 -0
  973. opik/rest_api/types/workspace_metric_response.py +20 -0
  974. opik/rest_api/types/workspace_metrics_summary_request.py +23 -0
  975. opik/rest_api/types/workspace_metrics_summary_response.py +20 -0
  976. opik/rest_api/types/workspace_name_holder.py +19 -0
  977. opik/rest_api/types/workspace_spans_count.py +20 -0
  978. opik/rest_api/types/workspace_trace_count.py +3 -5
  979. opik/rest_api/welcome_wizard/__init__.py +4 -0
  980. opik/rest_api/welcome_wizard/client.py +195 -0
  981. opik/rest_api/welcome_wizard/raw_client.py +208 -0
  982. opik/rest_api/workspaces/__init__.py +2 -0
  983. opik/rest_api/workspaces/client.py +550 -77
  984. opik/rest_api/workspaces/raw_client.py +923 -0
  985. opik/rest_client_configurator/api.py +1 -0
  986. opik/rest_client_configurator/retry_decorator.py +1 -0
  987. opik/s3_httpx_client.py +67 -0
  988. opik/simulation/__init__.py +6 -0
  989. opik/simulation/simulated_user.py +99 -0
  990. opik/simulation/simulator.py +108 -0
  991. opik/synchronization.py +11 -24
  992. opik/tracing_runtime_config.py +48 -0
  993. opik/types.py +48 -2
  994. opik/url_helpers.py +13 -3
  995. opik/validation/chat_prompt_messages.py +241 -0
  996. opik/validation/feedback_score.py +4 -5
  997. opik/validation/parameter.py +122 -0
  998. opik/validation/parameters_validator.py +175 -0
  999. opik/validation/validator.py +30 -2
  1000. opik/validation/validator_helpers.py +147 -0
  1001. opik-1.9.71.dist-info/METADATA +370 -0
  1002. opik-1.9.71.dist-info/RECORD +1110 -0
  1003. {opik-1.6.4.dist-info → opik-1.9.71.dist-info}/WHEEL +1 -1
  1004. opik-1.9.71.dist-info/licenses/LICENSE +203 -0
  1005. opik/api_objects/prompt/prompt.py +0 -107
  1006. opik/api_objects/prompt/prompt_template.py +0 -35
  1007. opik/cli.py +0 -193
  1008. opik/evaluation/metrics/models.py +0 -8
  1009. opik/hooks.py +0 -13
  1010. opik/integrations/bedrock/chunks_aggregator.py +0 -55
  1011. opik/integrations/bedrock/helpers.py +0 -8
  1012. opik/integrations/langchain/google_run_helpers.py +0 -75
  1013. opik/integrations/langchain/openai_run_helpers.py +0 -122
  1014. opik/message_processing/message_processors.py +0 -203
  1015. opik/rest_api/types/delta_role.py +0 -7
  1016. opik/rest_api/types/json_object_schema.py +0 -34
  1017. opik-1.6.4.dist-info/METADATA +0 -270
  1018. opik-1.6.4.dist-info/RECORD +0 -507
  1019. /opik/integrations/bedrock/{stream_wrappers.py → converse/stream_wrappers.py} +0 -0
  1020. {opik-1.6.4.dist-info → opik-1.9.71.dist-info}/entry_points.txt +0 -0
  1021. {opik-1.6.4.dist-info → opik-1.9.71.dist-info}/top_level.txt +0 -0
@@ -0,0 +1,1872 @@
1
+ # This file was auto-generated by Fern from our API Definition.
2
+
3
+ import contextlib
4
+ import typing
5
+ from json.decoder import JSONDecodeError
6
+
7
+ from ..core.api_error import ApiError
8
+ from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
9
+ from ..core.http_response import AsyncHttpResponse, HttpResponse
10
+ from ..core.jsonable_encoder import jsonable_encoder
11
+ from ..core.pydantic_utilities import parse_obj_as
12
+ from ..core.request_options import RequestOptions
13
+ from ..core.serialization import convert_and_respect_annotation_metadata
14
+ from ..errors.bad_request_error import BadRequestError
15
+ from ..errors.conflict_error import ConflictError
16
+ from ..errors.not_found_error import NotFoundError
17
+ from ..errors.unprocessable_entity_error import UnprocessableEntityError
18
+ from ..types.experiment_group_aggregations_response import ExperimentGroupAggregationsResponse
19
+ from ..types.experiment_group_response import ExperimentGroupResponse
20
+ from ..types.experiment_item import ExperimentItem
21
+ from ..types.experiment_item_bulk_record_experiment_item_bulk_write_view import (
22
+ ExperimentItemBulkRecordExperimentItemBulkWriteView,
23
+ )
24
+ from ..types.experiment_item_public import ExperimentItemPublic
25
+ from ..types.experiment_page_public import ExperimentPagePublic
26
+ from ..types.experiment_public import ExperimentPublic
27
+ from ..types.experiment_score import ExperimentScore
28
+ from ..types.experiment_score_write import ExperimentScoreWrite
29
+ from ..types.json_list_string_write import JsonListStringWrite
30
+ from ..types.json_node import JsonNode
31
+ from ..types.prompt_version_link_write import PromptVersionLinkWrite
32
+ from .types.experiment_update_status import ExperimentUpdateStatus
33
+ from .types.experiment_update_type import ExperimentUpdateType
34
+ from .types.experiment_write_status import ExperimentWriteStatus
35
+ from .types.experiment_write_type import ExperimentWriteType
36
+
37
+ # this is used as the default value for optional parameters
38
+ OMIT = typing.cast(typing.Any, ...)
39
+
40
+
41
+ class RawExperimentsClient:
42
+ def __init__(self, *, client_wrapper: SyncClientWrapper):
43
+ self._client_wrapper = client_wrapper
44
+
45
+ def find_experiments(
46
+ self,
47
+ *,
48
+ page: typing.Optional[int] = None,
49
+ size: typing.Optional[int] = None,
50
+ dataset_id: typing.Optional[str] = None,
51
+ optimization_id: typing.Optional[str] = None,
52
+ types: typing.Optional[str] = None,
53
+ name: typing.Optional[str] = None,
54
+ dataset_deleted: typing.Optional[bool] = None,
55
+ prompt_id: typing.Optional[str] = None,
56
+ sorting: typing.Optional[str] = None,
57
+ filters: typing.Optional[str] = None,
58
+ request_options: typing.Optional[RequestOptions] = None,
59
+ ) -> HttpResponse[ExperimentPagePublic]:
60
+ """
61
+ Find experiments
62
+
63
+ Parameters
64
+ ----------
65
+ page : typing.Optional[int]
66
+
67
+ size : typing.Optional[int]
68
+
69
+ dataset_id : typing.Optional[str]
70
+
71
+ optimization_id : typing.Optional[str]
72
+
73
+ types : typing.Optional[str]
74
+
75
+ name : typing.Optional[str]
76
+
77
+ dataset_deleted : typing.Optional[bool]
78
+
79
+ prompt_id : typing.Optional[str]
80
+
81
+ sorting : typing.Optional[str]
82
+
83
+ filters : typing.Optional[str]
84
+
85
+ request_options : typing.Optional[RequestOptions]
86
+ Request-specific configuration.
87
+
88
+ Returns
89
+ -------
90
+ HttpResponse[ExperimentPagePublic]
91
+ Experiments resource
92
+ """
93
+ _response = self._client_wrapper.httpx_client.request(
94
+ "v1/private/experiments",
95
+ method="GET",
96
+ params={
97
+ "page": page,
98
+ "size": size,
99
+ "datasetId": dataset_id,
100
+ "optimization_id": optimization_id,
101
+ "types": types,
102
+ "name": name,
103
+ "dataset_deleted": dataset_deleted,
104
+ "prompt_id": prompt_id,
105
+ "sorting": sorting,
106
+ "filters": filters,
107
+ },
108
+ request_options=request_options,
109
+ )
110
+ try:
111
+ if 200 <= _response.status_code < 300:
112
+ _data = typing.cast(
113
+ ExperimentPagePublic,
114
+ parse_obj_as(
115
+ type_=ExperimentPagePublic, # type: ignore
116
+ object_=_response.json(),
117
+ ),
118
+ )
119
+ return HttpResponse(response=_response, data=_data)
120
+ if _response.status_code == 400:
121
+ raise BadRequestError(
122
+ headers=dict(_response.headers),
123
+ body=typing.cast(
124
+ typing.Optional[typing.Any],
125
+ parse_obj_as(
126
+ type_=typing.Optional[typing.Any], # type: ignore
127
+ object_=_response.json(),
128
+ ),
129
+ ),
130
+ )
131
+ _response_json = _response.json()
132
+ except JSONDecodeError:
133
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
134
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
135
+
136
+ def create_experiment(
137
+ self,
138
+ *,
139
+ dataset_name: str,
140
+ id: typing.Optional[str] = OMIT,
141
+ name: typing.Optional[str] = OMIT,
142
+ metadata: typing.Optional[JsonListStringWrite] = OMIT,
143
+ type: typing.Optional[ExperimentWriteType] = OMIT,
144
+ optimization_id: typing.Optional[str] = OMIT,
145
+ status: typing.Optional[ExperimentWriteStatus] = OMIT,
146
+ experiment_scores: typing.Optional[typing.Sequence[ExperimentScoreWrite]] = OMIT,
147
+ prompt_version: typing.Optional[PromptVersionLinkWrite] = OMIT,
148
+ prompt_versions: typing.Optional[typing.Sequence[PromptVersionLinkWrite]] = OMIT,
149
+ request_options: typing.Optional[RequestOptions] = None,
150
+ ) -> HttpResponse[None]:
151
+ """
152
+ Create experiment
153
+
154
+ Parameters
155
+ ----------
156
+ dataset_name : str
157
+
158
+ id : typing.Optional[str]
159
+
160
+ name : typing.Optional[str]
161
+
162
+ metadata : typing.Optional[JsonListStringWrite]
163
+
164
+ type : typing.Optional[ExperimentWriteType]
165
+
166
+ optimization_id : typing.Optional[str]
167
+
168
+ status : typing.Optional[ExperimentWriteStatus]
169
+
170
+ experiment_scores : typing.Optional[typing.Sequence[ExperimentScoreWrite]]
171
+
172
+ prompt_version : typing.Optional[PromptVersionLinkWrite]
173
+
174
+ prompt_versions : typing.Optional[typing.Sequence[PromptVersionLinkWrite]]
175
+
176
+ request_options : typing.Optional[RequestOptions]
177
+ Request-specific configuration.
178
+
179
+ Returns
180
+ -------
181
+ HttpResponse[None]
182
+ """
183
+ _response = self._client_wrapper.httpx_client.request(
184
+ "v1/private/experiments",
185
+ method="POST",
186
+ json={
187
+ "id": id,
188
+ "dataset_name": dataset_name,
189
+ "name": name,
190
+ "metadata": convert_and_respect_annotation_metadata(
191
+ object_=metadata, annotation=JsonListStringWrite, direction="write"
192
+ ),
193
+ "type": type,
194
+ "optimization_id": optimization_id,
195
+ "status": status,
196
+ "experiment_scores": convert_and_respect_annotation_metadata(
197
+ object_=experiment_scores, annotation=typing.Sequence[ExperimentScoreWrite], direction="write"
198
+ ),
199
+ "prompt_version": convert_and_respect_annotation_metadata(
200
+ object_=prompt_version, annotation=PromptVersionLinkWrite, direction="write"
201
+ ),
202
+ "prompt_versions": convert_and_respect_annotation_metadata(
203
+ object_=prompt_versions, annotation=typing.Sequence[PromptVersionLinkWrite], direction="write"
204
+ ),
205
+ },
206
+ headers={
207
+ "content-type": "application/json",
208
+ },
209
+ request_options=request_options,
210
+ omit=OMIT,
211
+ )
212
+ try:
213
+ if 200 <= _response.status_code < 300:
214
+ return HttpResponse(response=_response, data=None)
215
+ _response_json = _response.json()
216
+ except JSONDecodeError:
217
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
218
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
219
+
220
+ def create_experiment_items(
221
+ self,
222
+ *,
223
+ experiment_items: typing.Sequence[ExperimentItem],
224
+ request_options: typing.Optional[RequestOptions] = None,
225
+ ) -> HttpResponse[None]:
226
+ """
227
+ Create experiment items
228
+
229
+ Parameters
230
+ ----------
231
+ experiment_items : typing.Sequence[ExperimentItem]
232
+
233
+ request_options : typing.Optional[RequestOptions]
234
+ Request-specific configuration.
235
+
236
+ Returns
237
+ -------
238
+ HttpResponse[None]
239
+ """
240
+ _response = self._client_wrapper.httpx_client.request(
241
+ "v1/private/experiments/items",
242
+ method="POST",
243
+ json={
244
+ "experiment_items": convert_and_respect_annotation_metadata(
245
+ object_=experiment_items, annotation=typing.Sequence[ExperimentItem], direction="write"
246
+ ),
247
+ },
248
+ headers={
249
+ "content-type": "application/json",
250
+ },
251
+ request_options=request_options,
252
+ omit=OMIT,
253
+ )
254
+ try:
255
+ if 200 <= _response.status_code < 300:
256
+ return HttpResponse(response=_response, data=None)
257
+ _response_json = _response.json()
258
+ except JSONDecodeError:
259
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
260
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
261
+
262
+ def delete_experiment_items(
263
+ self, *, ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None
264
+ ) -> HttpResponse[None]:
265
+ """
266
+ Delete experiment items
267
+
268
+ Parameters
269
+ ----------
270
+ ids : typing.Sequence[str]
271
+
272
+ request_options : typing.Optional[RequestOptions]
273
+ Request-specific configuration.
274
+
275
+ Returns
276
+ -------
277
+ HttpResponse[None]
278
+ """
279
+ _response = self._client_wrapper.httpx_client.request(
280
+ "v1/private/experiments/items/delete",
281
+ method="POST",
282
+ json={
283
+ "ids": ids,
284
+ },
285
+ headers={
286
+ "content-type": "application/json",
287
+ },
288
+ request_options=request_options,
289
+ omit=OMIT,
290
+ )
291
+ try:
292
+ if 200 <= _response.status_code < 300:
293
+ return HttpResponse(response=_response, data=None)
294
+ _response_json = _response.json()
295
+ except JSONDecodeError:
296
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
297
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
298
+
299
+ def delete_experiments_by_id(
300
+ self, *, ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None
301
+ ) -> HttpResponse[None]:
302
+ """
303
+ Delete experiments by id
304
+
305
+ Parameters
306
+ ----------
307
+ ids : typing.Sequence[str]
308
+
309
+ request_options : typing.Optional[RequestOptions]
310
+ Request-specific configuration.
311
+
312
+ Returns
313
+ -------
314
+ HttpResponse[None]
315
+ """
316
+ _response = self._client_wrapper.httpx_client.request(
317
+ "v1/private/experiments/delete",
318
+ method="POST",
319
+ json={
320
+ "ids": ids,
321
+ },
322
+ headers={
323
+ "content-type": "application/json",
324
+ },
325
+ request_options=request_options,
326
+ omit=OMIT,
327
+ )
328
+ try:
329
+ if 200 <= _response.status_code < 300:
330
+ return HttpResponse(response=_response, data=None)
331
+ _response_json = _response.json()
332
+ except JSONDecodeError:
333
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
334
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
335
+
336
+ def experiment_items_bulk(
337
+ self,
338
+ *,
339
+ experiment_name: str,
340
+ dataset_name: str,
341
+ items: typing.Sequence[ExperimentItemBulkRecordExperimentItemBulkWriteView],
342
+ experiment_id: typing.Optional[str] = OMIT,
343
+ request_options: typing.Optional[RequestOptions] = None,
344
+ ) -> HttpResponse[None]:
345
+ """
346
+ Record experiment items in bulk with traces, spans, and feedback scores. Maximum request size is 4MB.
347
+
348
+ Parameters
349
+ ----------
350
+ experiment_name : str
351
+
352
+ dataset_name : str
353
+
354
+ items : typing.Sequence[ExperimentItemBulkRecordExperimentItemBulkWriteView]
355
+
356
+ experiment_id : typing.Optional[str]
357
+ Optional experiment ID. If provided, items will be added to the existing experiment and experimentName will be ignored. If not provided or experiment with that ID doesn't exist, a new experiment will be created with the given experimentName
358
+
359
+ request_options : typing.Optional[RequestOptions]
360
+ Request-specific configuration.
361
+
362
+ Returns
363
+ -------
364
+ HttpResponse[None]
365
+ """
366
+ _response = self._client_wrapper.httpx_client.request(
367
+ "v1/private/experiments/items/bulk",
368
+ method="PUT",
369
+ json={
370
+ "experiment_name": experiment_name,
371
+ "dataset_name": dataset_name,
372
+ "experiment_id": experiment_id,
373
+ "items": convert_and_respect_annotation_metadata(
374
+ object_=items,
375
+ annotation=typing.Sequence[ExperimentItemBulkRecordExperimentItemBulkWriteView],
376
+ direction="write",
377
+ ),
378
+ },
379
+ headers={
380
+ "content-type": "application/json",
381
+ },
382
+ request_options=request_options,
383
+ omit=OMIT,
384
+ )
385
+ try:
386
+ if 200 <= _response.status_code < 300:
387
+ return HttpResponse(response=_response, data=None)
388
+ if _response.status_code == 400:
389
+ raise BadRequestError(
390
+ headers=dict(_response.headers),
391
+ body=typing.cast(
392
+ typing.Optional[typing.Any],
393
+ parse_obj_as(
394
+ type_=typing.Optional[typing.Any], # type: ignore
395
+ object_=_response.json(),
396
+ ),
397
+ ),
398
+ )
399
+ if _response.status_code == 409:
400
+ raise ConflictError(
401
+ headers=dict(_response.headers),
402
+ body=typing.cast(
403
+ typing.Optional[typing.Any],
404
+ parse_obj_as(
405
+ type_=typing.Optional[typing.Any], # type: ignore
406
+ object_=_response.json(),
407
+ ),
408
+ ),
409
+ )
410
+ if _response.status_code == 422:
411
+ raise UnprocessableEntityError(
412
+ headers=dict(_response.headers),
413
+ body=typing.cast(
414
+ typing.Optional[typing.Any],
415
+ parse_obj_as(
416
+ type_=typing.Optional[typing.Any], # type: ignore
417
+ object_=_response.json(),
418
+ ),
419
+ ),
420
+ )
421
+ _response_json = _response.json()
422
+ except JSONDecodeError:
423
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
424
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
425
+
426
+ def find_feedback_score_names(
427
+ self, *, experiment_ids: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None
428
+ ) -> HttpResponse[typing.List[str]]:
429
+ """
430
+ Find Feedback Score names
431
+
432
+ Parameters
433
+ ----------
434
+ experiment_ids : typing.Optional[str]
435
+
436
+ request_options : typing.Optional[RequestOptions]
437
+ Request-specific configuration.
438
+
439
+ Returns
440
+ -------
441
+ HttpResponse[typing.List[str]]
442
+ Feedback Scores resource
443
+ """
444
+ _response = self._client_wrapper.httpx_client.request(
445
+ "v1/private/experiments/feedback-scores/names",
446
+ method="GET",
447
+ params={
448
+ "experiment_ids": experiment_ids,
449
+ },
450
+ request_options=request_options,
451
+ )
452
+ try:
453
+ if 200 <= _response.status_code < 300:
454
+ _data = typing.cast(
455
+ typing.List[str],
456
+ parse_obj_as(
457
+ type_=typing.List[str], # type: ignore
458
+ object_=_response.json(),
459
+ ),
460
+ )
461
+ return HttpResponse(response=_response, data=_data)
462
+ _response_json = _response.json()
463
+ except JSONDecodeError:
464
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
465
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
466
+
467
+ def find_experiment_groups(
468
+ self,
469
+ *,
470
+ groups: typing.Optional[str] = None,
471
+ types: typing.Optional[str] = None,
472
+ name: typing.Optional[str] = None,
473
+ filters: typing.Optional[str] = None,
474
+ request_options: typing.Optional[RequestOptions] = None,
475
+ ) -> HttpResponse[ExperimentGroupResponse]:
476
+ """
477
+ Find experiments grouped by specified fields
478
+
479
+ Parameters
480
+ ----------
481
+ groups : typing.Optional[str]
482
+
483
+ types : typing.Optional[str]
484
+
485
+ name : typing.Optional[str]
486
+
487
+ filters : typing.Optional[str]
488
+
489
+ request_options : typing.Optional[RequestOptions]
490
+ Request-specific configuration.
491
+
492
+ Returns
493
+ -------
494
+ HttpResponse[ExperimentGroupResponse]
495
+ Experiment groups
496
+ """
497
+ _response = self._client_wrapper.httpx_client.request(
498
+ "v1/private/experiments/groups",
499
+ method="GET",
500
+ params={
501
+ "groups": groups,
502
+ "types": types,
503
+ "name": name,
504
+ "filters": filters,
505
+ },
506
+ request_options=request_options,
507
+ )
508
+ try:
509
+ if 200 <= _response.status_code < 300:
510
+ _data = typing.cast(
511
+ ExperimentGroupResponse,
512
+ parse_obj_as(
513
+ type_=ExperimentGroupResponse, # type: ignore
514
+ object_=_response.json(),
515
+ ),
516
+ )
517
+ return HttpResponse(response=_response, data=_data)
518
+ if _response.status_code == 400:
519
+ raise BadRequestError(
520
+ headers=dict(_response.headers),
521
+ body=typing.cast(
522
+ typing.Optional[typing.Any],
523
+ parse_obj_as(
524
+ type_=typing.Optional[typing.Any], # type: ignore
525
+ object_=_response.json(),
526
+ ),
527
+ ),
528
+ )
529
+ _response_json = _response.json()
530
+ except JSONDecodeError:
531
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
532
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
533
+
534
+ def find_experiment_groups_aggregations(
535
+ self,
536
+ *,
537
+ groups: typing.Optional[str] = None,
538
+ types: typing.Optional[str] = None,
539
+ name: typing.Optional[str] = None,
540
+ filters: typing.Optional[str] = None,
541
+ request_options: typing.Optional[RequestOptions] = None,
542
+ ) -> HttpResponse[ExperimentGroupAggregationsResponse]:
543
+ """
544
+ Find experiments grouped by specified fields with aggregation metrics
545
+
546
+ Parameters
547
+ ----------
548
+ groups : typing.Optional[str]
549
+
550
+ types : typing.Optional[str]
551
+
552
+ name : typing.Optional[str]
553
+
554
+ filters : typing.Optional[str]
555
+
556
+ request_options : typing.Optional[RequestOptions]
557
+ Request-specific configuration.
558
+
559
+ Returns
560
+ -------
561
+ HttpResponse[ExperimentGroupAggregationsResponse]
562
+ Experiment groups with aggregations
563
+ """
564
+ _response = self._client_wrapper.httpx_client.request(
565
+ "v1/private/experiments/groups/aggregations",
566
+ method="GET",
567
+ params={
568
+ "groups": groups,
569
+ "types": types,
570
+ "name": name,
571
+ "filters": filters,
572
+ },
573
+ request_options=request_options,
574
+ )
575
+ try:
576
+ if 200 <= _response.status_code < 300:
577
+ _data = typing.cast(
578
+ ExperimentGroupAggregationsResponse,
579
+ parse_obj_as(
580
+ type_=ExperimentGroupAggregationsResponse, # type: ignore
581
+ object_=_response.json(),
582
+ ),
583
+ )
584
+ return HttpResponse(response=_response, data=_data)
585
+ if _response.status_code == 400:
586
+ raise BadRequestError(
587
+ headers=dict(_response.headers),
588
+ body=typing.cast(
589
+ typing.Optional[typing.Any],
590
+ parse_obj_as(
591
+ type_=typing.Optional[typing.Any], # type: ignore
592
+ object_=_response.json(),
593
+ ),
594
+ ),
595
+ )
596
+ _response_json = _response.json()
597
+ except JSONDecodeError:
598
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
599
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
600
+
601
+ def finish_experiments(
602
+ self, *, ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None
603
+ ) -> HttpResponse[None]:
604
+ """
605
+ Finish experiments and trigger alert events
606
+
607
+ Parameters
608
+ ----------
609
+ ids : typing.Sequence[str]
610
+
611
+ request_options : typing.Optional[RequestOptions]
612
+ Request-specific configuration.
613
+
614
+ Returns
615
+ -------
616
+ HttpResponse[None]
617
+ """
618
+ _response = self._client_wrapper.httpx_client.request(
619
+ "v1/private/experiments/finish",
620
+ method="POST",
621
+ json={
622
+ "ids": ids,
623
+ },
624
+ headers={
625
+ "content-type": "application/json",
626
+ },
627
+ request_options=request_options,
628
+ omit=OMIT,
629
+ )
630
+ try:
631
+ if 200 <= _response.status_code < 300:
632
+ return HttpResponse(response=_response, data=None)
633
+ if _response.status_code == 400:
634
+ raise BadRequestError(
635
+ headers=dict(_response.headers),
636
+ body=typing.cast(
637
+ typing.Optional[typing.Any],
638
+ parse_obj_as(
639
+ type_=typing.Optional[typing.Any], # type: ignore
640
+ object_=_response.json(),
641
+ ),
642
+ ),
643
+ )
644
+ _response_json = _response.json()
645
+ except JSONDecodeError:
646
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
647
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
648
+
649
+ def get_experiment_by_id(
650
+ self, id: str, *, request_options: typing.Optional[RequestOptions] = None
651
+ ) -> HttpResponse[ExperimentPublic]:
652
+ """
653
+ Get experiment by id
654
+
655
+ Parameters
656
+ ----------
657
+ id : str
658
+
659
+ request_options : typing.Optional[RequestOptions]
660
+ Request-specific configuration.
661
+
662
+ Returns
663
+ -------
664
+ HttpResponse[ExperimentPublic]
665
+ Experiment resource
666
+ """
667
+ _response = self._client_wrapper.httpx_client.request(
668
+ f"v1/private/experiments/{jsonable_encoder(id)}",
669
+ method="GET",
670
+ request_options=request_options,
671
+ )
672
+ try:
673
+ if 200 <= _response.status_code < 300:
674
+ _data = typing.cast(
675
+ ExperimentPublic,
676
+ parse_obj_as(
677
+ type_=ExperimentPublic, # type: ignore
678
+ object_=_response.json(),
679
+ ),
680
+ )
681
+ return HttpResponse(response=_response, data=_data)
682
+ if _response.status_code == 404:
683
+ raise NotFoundError(
684
+ headers=dict(_response.headers),
685
+ body=typing.cast(
686
+ typing.Optional[typing.Any],
687
+ parse_obj_as(
688
+ type_=typing.Optional[typing.Any], # type: ignore
689
+ object_=_response.json(),
690
+ ),
691
+ ),
692
+ )
693
+ _response_json = _response.json()
694
+ except JSONDecodeError:
695
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
696
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
697
+
698
+ def update_experiment(
699
+ self,
700
+ id: str,
701
+ *,
702
+ name: typing.Optional[str] = OMIT,
703
+ metadata: typing.Optional[JsonNode] = OMIT,
704
+ type: typing.Optional[ExperimentUpdateType] = OMIT,
705
+ status: typing.Optional[ExperimentUpdateStatus] = OMIT,
706
+ experiment_scores: typing.Optional[typing.Sequence[ExperimentScore]] = OMIT,
707
+ request_options: typing.Optional[RequestOptions] = None,
708
+ ) -> HttpResponse[None]:
709
+ """
710
+ Update experiment by id
711
+
712
+ Parameters
713
+ ----------
714
+ id : str
715
+
716
+ name : typing.Optional[str]
717
+
718
+ metadata : typing.Optional[JsonNode]
719
+
720
+ type : typing.Optional[ExperimentUpdateType]
721
+
722
+ status : typing.Optional[ExperimentUpdateStatus]
723
+ The status of the experiment
724
+
725
+ experiment_scores : typing.Optional[typing.Sequence[ExperimentScore]]
726
+
727
+ request_options : typing.Optional[RequestOptions]
728
+ Request-specific configuration.
729
+
730
+ Returns
731
+ -------
732
+ HttpResponse[None]
733
+ """
734
+ _response = self._client_wrapper.httpx_client.request(
735
+ f"v1/private/experiments/{jsonable_encoder(id)}",
736
+ method="PATCH",
737
+ json={
738
+ "name": name,
739
+ "metadata": metadata,
740
+ "type": type,
741
+ "status": status,
742
+ "experiment_scores": convert_and_respect_annotation_metadata(
743
+ object_=experiment_scores, annotation=typing.Sequence[ExperimentScore], direction="write"
744
+ ),
745
+ },
746
+ headers={
747
+ "content-type": "application/json",
748
+ },
749
+ request_options=request_options,
750
+ omit=OMIT,
751
+ )
752
+ try:
753
+ if 200 <= _response.status_code < 300:
754
+ return HttpResponse(response=_response, data=None)
755
+ if _response.status_code == 400:
756
+ raise BadRequestError(
757
+ headers=dict(_response.headers),
758
+ body=typing.cast(
759
+ typing.Optional[typing.Any],
760
+ parse_obj_as(
761
+ type_=typing.Optional[typing.Any], # type: ignore
762
+ object_=_response.json(),
763
+ ),
764
+ ),
765
+ )
766
+ if _response.status_code == 404:
767
+ raise NotFoundError(
768
+ headers=dict(_response.headers),
769
+ body=typing.cast(
770
+ typing.Optional[typing.Any],
771
+ parse_obj_as(
772
+ type_=typing.Optional[typing.Any], # type: ignore
773
+ object_=_response.json(),
774
+ ),
775
+ ),
776
+ )
777
+ _response_json = _response.json()
778
+ except JSONDecodeError:
779
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
780
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
781
+
782
+ def get_experiment_item_by_id(
783
+ self, id: str, *, request_options: typing.Optional[RequestOptions] = None
784
+ ) -> HttpResponse[ExperimentItemPublic]:
785
+ """
786
+ Get experiment item by id
787
+
788
+ Parameters
789
+ ----------
790
+ id : str
791
+
792
+ request_options : typing.Optional[RequestOptions]
793
+ Request-specific configuration.
794
+
795
+ Returns
796
+ -------
797
+ HttpResponse[ExperimentItemPublic]
798
+ Experiment item resource
799
+ """
800
+ _response = self._client_wrapper.httpx_client.request(
801
+ f"v1/private/experiments/items/{jsonable_encoder(id)}",
802
+ method="GET",
803
+ request_options=request_options,
804
+ )
805
+ try:
806
+ if 200 <= _response.status_code < 300:
807
+ _data = typing.cast(
808
+ ExperimentItemPublic,
809
+ parse_obj_as(
810
+ type_=ExperimentItemPublic, # type: ignore
811
+ object_=_response.json(),
812
+ ),
813
+ )
814
+ return HttpResponse(response=_response, data=_data)
815
+ if _response.status_code == 404:
816
+ raise NotFoundError(
817
+ headers=dict(_response.headers),
818
+ body=typing.cast(
819
+ typing.Optional[typing.Any],
820
+ parse_obj_as(
821
+ type_=typing.Optional[typing.Any], # type: ignore
822
+ object_=_response.json(),
823
+ ),
824
+ ),
825
+ )
826
+ _response_json = _response.json()
827
+ except JSONDecodeError:
828
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
829
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
830
+
831
+ @contextlib.contextmanager
832
+ def stream_experiment_items(
833
+ self,
834
+ *,
835
+ experiment_name: str,
836
+ limit: typing.Optional[int] = OMIT,
837
+ last_retrieved_id: typing.Optional[str] = OMIT,
838
+ truncate: typing.Optional[bool] = OMIT,
839
+ request_options: typing.Optional[RequestOptions] = None,
840
+ ) -> typing.Iterator[HttpResponse[typing.Iterator[bytes]]]:
841
+ """
842
+ Stream experiment items
843
+
844
+ Parameters
845
+ ----------
846
+ experiment_name : str
847
+
848
+ limit : typing.Optional[int]
849
+
850
+ last_retrieved_id : typing.Optional[str]
851
+
852
+ truncate : typing.Optional[bool]
853
+ Truncate image included in either input, output or metadata
854
+
855
+ request_options : typing.Optional[RequestOptions]
856
+ Request-specific configuration. You can pass in configuration such as `chunk_size`, and more to customize the request and response.
857
+
858
+ Returns
859
+ -------
860
+ typing.Iterator[HttpResponse[typing.Iterator[bytes]]]
861
+ Experiment items stream or error during process
862
+ """
863
+ with self._client_wrapper.httpx_client.stream(
864
+ "v1/private/experiments/items/stream",
865
+ method="POST",
866
+ json={
867
+ "experiment_name": experiment_name,
868
+ "limit": limit,
869
+ "last_retrieved_id": last_retrieved_id,
870
+ "truncate": truncate,
871
+ },
872
+ headers={
873
+ "content-type": "application/json",
874
+ },
875
+ request_options=request_options,
876
+ omit=OMIT,
877
+ ) as _response:
878
+
879
+ def stream() -> HttpResponse[typing.Iterator[bytes]]:
880
+ try:
881
+ if 200 <= _response.status_code < 300:
882
+ _chunk_size = request_options.get("chunk_size", None) if request_options is not None else None
883
+ return HttpResponse(
884
+ response=_response, data=(_chunk for _chunk in _response.iter_bytes(chunk_size=_chunk_size))
885
+ )
886
+ _response.read()
887
+ _response_json = _response.json()
888
+ except JSONDecodeError:
889
+ raise ApiError(
890
+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.text
891
+ )
892
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
893
+
894
+ yield stream()
895
+
896
+ @contextlib.contextmanager
897
+ def stream_experiments(
898
+ self,
899
+ *,
900
+ name: str,
901
+ limit: typing.Optional[int] = OMIT,
902
+ last_retrieved_id: typing.Optional[str] = OMIT,
903
+ request_options: typing.Optional[RequestOptions] = None,
904
+ ) -> typing.Iterator[HttpResponse[typing.Iterator[bytes]]]:
905
+ """
906
+ Stream experiments
907
+
908
+ Parameters
909
+ ----------
910
+ name : str
911
+
912
+ limit : typing.Optional[int]
913
+
914
+ last_retrieved_id : typing.Optional[str]
915
+
916
+ request_options : typing.Optional[RequestOptions]
917
+ Request-specific configuration. You can pass in configuration such as `chunk_size`, and more to customize the request and response.
918
+
919
+ Returns
920
+ -------
921
+ typing.Iterator[HttpResponse[typing.Iterator[bytes]]]
922
+ Experiments stream or error during process
923
+ """
924
+ with self._client_wrapper.httpx_client.stream(
925
+ "v1/private/experiments/stream",
926
+ method="POST",
927
+ json={
928
+ "name": name,
929
+ "limit": limit,
930
+ "last_retrieved_id": last_retrieved_id,
931
+ },
932
+ headers={
933
+ "content-type": "application/json",
934
+ },
935
+ request_options=request_options,
936
+ omit=OMIT,
937
+ ) as _response:
938
+
939
+ def stream() -> HttpResponse[typing.Iterator[bytes]]:
940
+ try:
941
+ if 200 <= _response.status_code < 300:
942
+ _chunk_size = request_options.get("chunk_size", None) if request_options is not None else None
943
+ return HttpResponse(
944
+ response=_response, data=(_chunk for _chunk in _response.iter_bytes(chunk_size=_chunk_size))
945
+ )
946
+ _response.read()
947
+ _response_json = _response.json()
948
+ except JSONDecodeError:
949
+ raise ApiError(
950
+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.text
951
+ )
952
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
953
+
954
+ yield stream()
955
+
956
+
957
+ class AsyncRawExperimentsClient:
958
+ def __init__(self, *, client_wrapper: AsyncClientWrapper):
959
+ self._client_wrapper = client_wrapper
960
+
961
+ async def find_experiments(
962
+ self,
963
+ *,
964
+ page: typing.Optional[int] = None,
965
+ size: typing.Optional[int] = None,
966
+ dataset_id: typing.Optional[str] = None,
967
+ optimization_id: typing.Optional[str] = None,
968
+ types: typing.Optional[str] = None,
969
+ name: typing.Optional[str] = None,
970
+ dataset_deleted: typing.Optional[bool] = None,
971
+ prompt_id: typing.Optional[str] = None,
972
+ sorting: typing.Optional[str] = None,
973
+ filters: typing.Optional[str] = None,
974
+ request_options: typing.Optional[RequestOptions] = None,
975
+ ) -> AsyncHttpResponse[ExperimentPagePublic]:
976
+ """
977
+ Find experiments
978
+
979
+ Parameters
980
+ ----------
981
+ page : typing.Optional[int]
982
+
983
+ size : typing.Optional[int]
984
+
985
+ dataset_id : typing.Optional[str]
986
+
987
+ optimization_id : typing.Optional[str]
988
+
989
+ types : typing.Optional[str]
990
+
991
+ name : typing.Optional[str]
992
+
993
+ dataset_deleted : typing.Optional[bool]
994
+
995
+ prompt_id : typing.Optional[str]
996
+
997
+ sorting : typing.Optional[str]
998
+
999
+ filters : typing.Optional[str]
1000
+
1001
+ request_options : typing.Optional[RequestOptions]
1002
+ Request-specific configuration.
1003
+
1004
+ Returns
1005
+ -------
1006
+ AsyncHttpResponse[ExperimentPagePublic]
1007
+ Experiments resource
1008
+ """
1009
+ _response = await self._client_wrapper.httpx_client.request(
1010
+ "v1/private/experiments",
1011
+ method="GET",
1012
+ params={
1013
+ "page": page,
1014
+ "size": size,
1015
+ "datasetId": dataset_id,
1016
+ "optimization_id": optimization_id,
1017
+ "types": types,
1018
+ "name": name,
1019
+ "dataset_deleted": dataset_deleted,
1020
+ "prompt_id": prompt_id,
1021
+ "sorting": sorting,
1022
+ "filters": filters,
1023
+ },
1024
+ request_options=request_options,
1025
+ )
1026
+ try:
1027
+ if 200 <= _response.status_code < 300:
1028
+ _data = typing.cast(
1029
+ ExperimentPagePublic,
1030
+ parse_obj_as(
1031
+ type_=ExperimentPagePublic, # type: ignore
1032
+ object_=_response.json(),
1033
+ ),
1034
+ )
1035
+ return AsyncHttpResponse(response=_response, data=_data)
1036
+ if _response.status_code == 400:
1037
+ raise BadRequestError(
1038
+ headers=dict(_response.headers),
1039
+ body=typing.cast(
1040
+ typing.Optional[typing.Any],
1041
+ parse_obj_as(
1042
+ type_=typing.Optional[typing.Any], # type: ignore
1043
+ object_=_response.json(),
1044
+ ),
1045
+ ),
1046
+ )
1047
+ _response_json = _response.json()
1048
+ except JSONDecodeError:
1049
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
1050
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
1051
+
1052
+ async def create_experiment(
1053
+ self,
1054
+ *,
1055
+ dataset_name: str,
1056
+ id: typing.Optional[str] = OMIT,
1057
+ name: typing.Optional[str] = OMIT,
1058
+ metadata: typing.Optional[JsonListStringWrite] = OMIT,
1059
+ type: typing.Optional[ExperimentWriteType] = OMIT,
1060
+ optimization_id: typing.Optional[str] = OMIT,
1061
+ status: typing.Optional[ExperimentWriteStatus] = OMIT,
1062
+ experiment_scores: typing.Optional[typing.Sequence[ExperimentScoreWrite]] = OMIT,
1063
+ prompt_version: typing.Optional[PromptVersionLinkWrite] = OMIT,
1064
+ prompt_versions: typing.Optional[typing.Sequence[PromptVersionLinkWrite]] = OMIT,
1065
+ request_options: typing.Optional[RequestOptions] = None,
1066
+ ) -> AsyncHttpResponse[None]:
1067
+ """
1068
+ Create experiment
1069
+
1070
+ Parameters
1071
+ ----------
1072
+ dataset_name : str
1073
+
1074
+ id : typing.Optional[str]
1075
+
1076
+ name : typing.Optional[str]
1077
+
1078
+ metadata : typing.Optional[JsonListStringWrite]
1079
+
1080
+ type : typing.Optional[ExperimentWriteType]
1081
+
1082
+ optimization_id : typing.Optional[str]
1083
+
1084
+ status : typing.Optional[ExperimentWriteStatus]
1085
+
1086
+ experiment_scores : typing.Optional[typing.Sequence[ExperimentScoreWrite]]
1087
+
1088
+ prompt_version : typing.Optional[PromptVersionLinkWrite]
1089
+
1090
+ prompt_versions : typing.Optional[typing.Sequence[PromptVersionLinkWrite]]
1091
+
1092
+ request_options : typing.Optional[RequestOptions]
1093
+ Request-specific configuration.
1094
+
1095
+ Returns
1096
+ -------
1097
+ AsyncHttpResponse[None]
1098
+ """
1099
+ _response = await self._client_wrapper.httpx_client.request(
1100
+ "v1/private/experiments",
1101
+ method="POST",
1102
+ json={
1103
+ "id": id,
1104
+ "dataset_name": dataset_name,
1105
+ "name": name,
1106
+ "metadata": convert_and_respect_annotation_metadata(
1107
+ object_=metadata, annotation=JsonListStringWrite, direction="write"
1108
+ ),
1109
+ "type": type,
1110
+ "optimization_id": optimization_id,
1111
+ "status": status,
1112
+ "experiment_scores": convert_and_respect_annotation_metadata(
1113
+ object_=experiment_scores, annotation=typing.Sequence[ExperimentScoreWrite], direction="write"
1114
+ ),
1115
+ "prompt_version": convert_and_respect_annotation_metadata(
1116
+ object_=prompt_version, annotation=PromptVersionLinkWrite, direction="write"
1117
+ ),
1118
+ "prompt_versions": convert_and_respect_annotation_metadata(
1119
+ object_=prompt_versions, annotation=typing.Sequence[PromptVersionLinkWrite], direction="write"
1120
+ ),
1121
+ },
1122
+ headers={
1123
+ "content-type": "application/json",
1124
+ },
1125
+ request_options=request_options,
1126
+ omit=OMIT,
1127
+ )
1128
+ try:
1129
+ if 200 <= _response.status_code < 300:
1130
+ return AsyncHttpResponse(response=_response, data=None)
1131
+ _response_json = _response.json()
1132
+ except JSONDecodeError:
1133
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
1134
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
1135
+
1136
+ async def create_experiment_items(
1137
+ self,
1138
+ *,
1139
+ experiment_items: typing.Sequence[ExperimentItem],
1140
+ request_options: typing.Optional[RequestOptions] = None,
1141
+ ) -> AsyncHttpResponse[None]:
1142
+ """
1143
+ Create experiment items
1144
+
1145
+ Parameters
1146
+ ----------
1147
+ experiment_items : typing.Sequence[ExperimentItem]
1148
+
1149
+ request_options : typing.Optional[RequestOptions]
1150
+ Request-specific configuration.
1151
+
1152
+ Returns
1153
+ -------
1154
+ AsyncHttpResponse[None]
1155
+ """
1156
+ _response = await self._client_wrapper.httpx_client.request(
1157
+ "v1/private/experiments/items",
1158
+ method="POST",
1159
+ json={
1160
+ "experiment_items": convert_and_respect_annotation_metadata(
1161
+ object_=experiment_items, annotation=typing.Sequence[ExperimentItem], direction="write"
1162
+ ),
1163
+ },
1164
+ headers={
1165
+ "content-type": "application/json",
1166
+ },
1167
+ request_options=request_options,
1168
+ omit=OMIT,
1169
+ )
1170
+ try:
1171
+ if 200 <= _response.status_code < 300:
1172
+ return AsyncHttpResponse(response=_response, data=None)
1173
+ _response_json = _response.json()
1174
+ except JSONDecodeError:
1175
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
1176
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
1177
+
1178
+ async def delete_experiment_items(
1179
+ self, *, ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None
1180
+ ) -> AsyncHttpResponse[None]:
1181
+ """
1182
+ Delete experiment items
1183
+
1184
+ Parameters
1185
+ ----------
1186
+ ids : typing.Sequence[str]
1187
+
1188
+ request_options : typing.Optional[RequestOptions]
1189
+ Request-specific configuration.
1190
+
1191
+ Returns
1192
+ -------
1193
+ AsyncHttpResponse[None]
1194
+ """
1195
+ _response = await self._client_wrapper.httpx_client.request(
1196
+ "v1/private/experiments/items/delete",
1197
+ method="POST",
1198
+ json={
1199
+ "ids": ids,
1200
+ },
1201
+ headers={
1202
+ "content-type": "application/json",
1203
+ },
1204
+ request_options=request_options,
1205
+ omit=OMIT,
1206
+ )
1207
+ try:
1208
+ if 200 <= _response.status_code < 300:
1209
+ return AsyncHttpResponse(response=_response, data=None)
1210
+ _response_json = _response.json()
1211
+ except JSONDecodeError:
1212
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
1213
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
1214
+
1215
+ async def delete_experiments_by_id(
1216
+ self, *, ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None
1217
+ ) -> AsyncHttpResponse[None]:
1218
+ """
1219
+ Delete experiments by id
1220
+
1221
+ Parameters
1222
+ ----------
1223
+ ids : typing.Sequence[str]
1224
+
1225
+ request_options : typing.Optional[RequestOptions]
1226
+ Request-specific configuration.
1227
+
1228
+ Returns
1229
+ -------
1230
+ AsyncHttpResponse[None]
1231
+ """
1232
+ _response = await self._client_wrapper.httpx_client.request(
1233
+ "v1/private/experiments/delete",
1234
+ method="POST",
1235
+ json={
1236
+ "ids": ids,
1237
+ },
1238
+ headers={
1239
+ "content-type": "application/json",
1240
+ },
1241
+ request_options=request_options,
1242
+ omit=OMIT,
1243
+ )
1244
+ try:
1245
+ if 200 <= _response.status_code < 300:
1246
+ return AsyncHttpResponse(response=_response, data=None)
1247
+ _response_json = _response.json()
1248
+ except JSONDecodeError:
1249
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
1250
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
1251
+
1252
+ async def experiment_items_bulk(
1253
+ self,
1254
+ *,
1255
+ experiment_name: str,
1256
+ dataset_name: str,
1257
+ items: typing.Sequence[ExperimentItemBulkRecordExperimentItemBulkWriteView],
1258
+ experiment_id: typing.Optional[str] = OMIT,
1259
+ request_options: typing.Optional[RequestOptions] = None,
1260
+ ) -> AsyncHttpResponse[None]:
1261
+ """
1262
+ Record experiment items in bulk with traces, spans, and feedback scores. Maximum request size is 4MB.
1263
+
1264
+ Parameters
1265
+ ----------
1266
+ experiment_name : str
1267
+
1268
+ dataset_name : str
1269
+
1270
+ items : typing.Sequence[ExperimentItemBulkRecordExperimentItemBulkWriteView]
1271
+
1272
+ experiment_id : typing.Optional[str]
1273
+ Optional experiment ID. If provided, items will be added to the existing experiment and experimentName will be ignored. If not provided or experiment with that ID doesn't exist, a new experiment will be created with the given experimentName
1274
+
1275
+ request_options : typing.Optional[RequestOptions]
1276
+ Request-specific configuration.
1277
+
1278
+ Returns
1279
+ -------
1280
+ AsyncHttpResponse[None]
1281
+ """
1282
+ _response = await self._client_wrapper.httpx_client.request(
1283
+ "v1/private/experiments/items/bulk",
1284
+ method="PUT",
1285
+ json={
1286
+ "experiment_name": experiment_name,
1287
+ "dataset_name": dataset_name,
1288
+ "experiment_id": experiment_id,
1289
+ "items": convert_and_respect_annotation_metadata(
1290
+ object_=items,
1291
+ annotation=typing.Sequence[ExperimentItemBulkRecordExperimentItemBulkWriteView],
1292
+ direction="write",
1293
+ ),
1294
+ },
1295
+ headers={
1296
+ "content-type": "application/json",
1297
+ },
1298
+ request_options=request_options,
1299
+ omit=OMIT,
1300
+ )
1301
+ try:
1302
+ if 200 <= _response.status_code < 300:
1303
+ return AsyncHttpResponse(response=_response, data=None)
1304
+ if _response.status_code == 400:
1305
+ raise BadRequestError(
1306
+ headers=dict(_response.headers),
1307
+ body=typing.cast(
1308
+ typing.Optional[typing.Any],
1309
+ parse_obj_as(
1310
+ type_=typing.Optional[typing.Any], # type: ignore
1311
+ object_=_response.json(),
1312
+ ),
1313
+ ),
1314
+ )
1315
+ if _response.status_code == 409:
1316
+ raise ConflictError(
1317
+ headers=dict(_response.headers),
1318
+ body=typing.cast(
1319
+ typing.Optional[typing.Any],
1320
+ parse_obj_as(
1321
+ type_=typing.Optional[typing.Any], # type: ignore
1322
+ object_=_response.json(),
1323
+ ),
1324
+ ),
1325
+ )
1326
+ if _response.status_code == 422:
1327
+ raise UnprocessableEntityError(
1328
+ headers=dict(_response.headers),
1329
+ body=typing.cast(
1330
+ typing.Optional[typing.Any],
1331
+ parse_obj_as(
1332
+ type_=typing.Optional[typing.Any], # type: ignore
1333
+ object_=_response.json(),
1334
+ ),
1335
+ ),
1336
+ )
1337
+ _response_json = _response.json()
1338
+ except JSONDecodeError:
1339
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
1340
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
1341
+
1342
+ async def find_feedback_score_names(
1343
+ self, *, experiment_ids: typing.Optional[str] = None, request_options: typing.Optional[RequestOptions] = None
1344
+ ) -> AsyncHttpResponse[typing.List[str]]:
1345
+ """
1346
+ Find Feedback Score names
1347
+
1348
+ Parameters
1349
+ ----------
1350
+ experiment_ids : typing.Optional[str]
1351
+
1352
+ request_options : typing.Optional[RequestOptions]
1353
+ Request-specific configuration.
1354
+
1355
+ Returns
1356
+ -------
1357
+ AsyncHttpResponse[typing.List[str]]
1358
+ Feedback Scores resource
1359
+ """
1360
+ _response = await self._client_wrapper.httpx_client.request(
1361
+ "v1/private/experiments/feedback-scores/names",
1362
+ method="GET",
1363
+ params={
1364
+ "experiment_ids": experiment_ids,
1365
+ },
1366
+ request_options=request_options,
1367
+ )
1368
+ try:
1369
+ if 200 <= _response.status_code < 300:
1370
+ _data = typing.cast(
1371
+ typing.List[str],
1372
+ parse_obj_as(
1373
+ type_=typing.List[str], # type: ignore
1374
+ object_=_response.json(),
1375
+ ),
1376
+ )
1377
+ return AsyncHttpResponse(response=_response, data=_data)
1378
+ _response_json = _response.json()
1379
+ except JSONDecodeError:
1380
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
1381
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
1382
+
1383
+ async def find_experiment_groups(
1384
+ self,
1385
+ *,
1386
+ groups: typing.Optional[str] = None,
1387
+ types: typing.Optional[str] = None,
1388
+ name: typing.Optional[str] = None,
1389
+ filters: typing.Optional[str] = None,
1390
+ request_options: typing.Optional[RequestOptions] = None,
1391
+ ) -> AsyncHttpResponse[ExperimentGroupResponse]:
1392
+ """
1393
+ Find experiments grouped by specified fields
1394
+
1395
+ Parameters
1396
+ ----------
1397
+ groups : typing.Optional[str]
1398
+
1399
+ types : typing.Optional[str]
1400
+
1401
+ name : typing.Optional[str]
1402
+
1403
+ filters : typing.Optional[str]
1404
+
1405
+ request_options : typing.Optional[RequestOptions]
1406
+ Request-specific configuration.
1407
+
1408
+ Returns
1409
+ -------
1410
+ AsyncHttpResponse[ExperimentGroupResponse]
1411
+ Experiment groups
1412
+ """
1413
+ _response = await self._client_wrapper.httpx_client.request(
1414
+ "v1/private/experiments/groups",
1415
+ method="GET",
1416
+ params={
1417
+ "groups": groups,
1418
+ "types": types,
1419
+ "name": name,
1420
+ "filters": filters,
1421
+ },
1422
+ request_options=request_options,
1423
+ )
1424
+ try:
1425
+ if 200 <= _response.status_code < 300:
1426
+ _data = typing.cast(
1427
+ ExperimentGroupResponse,
1428
+ parse_obj_as(
1429
+ type_=ExperimentGroupResponse, # type: ignore
1430
+ object_=_response.json(),
1431
+ ),
1432
+ )
1433
+ return AsyncHttpResponse(response=_response, data=_data)
1434
+ if _response.status_code == 400:
1435
+ raise BadRequestError(
1436
+ headers=dict(_response.headers),
1437
+ body=typing.cast(
1438
+ typing.Optional[typing.Any],
1439
+ parse_obj_as(
1440
+ type_=typing.Optional[typing.Any], # type: ignore
1441
+ object_=_response.json(),
1442
+ ),
1443
+ ),
1444
+ )
1445
+ _response_json = _response.json()
1446
+ except JSONDecodeError:
1447
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
1448
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
1449
+
1450
+ async def find_experiment_groups_aggregations(
1451
+ self,
1452
+ *,
1453
+ groups: typing.Optional[str] = None,
1454
+ types: typing.Optional[str] = None,
1455
+ name: typing.Optional[str] = None,
1456
+ filters: typing.Optional[str] = None,
1457
+ request_options: typing.Optional[RequestOptions] = None,
1458
+ ) -> AsyncHttpResponse[ExperimentGroupAggregationsResponse]:
1459
+ """
1460
+ Find experiments grouped by specified fields with aggregation metrics
1461
+
1462
+ Parameters
1463
+ ----------
1464
+ groups : typing.Optional[str]
1465
+
1466
+ types : typing.Optional[str]
1467
+
1468
+ name : typing.Optional[str]
1469
+
1470
+ filters : typing.Optional[str]
1471
+
1472
+ request_options : typing.Optional[RequestOptions]
1473
+ Request-specific configuration.
1474
+
1475
+ Returns
1476
+ -------
1477
+ AsyncHttpResponse[ExperimentGroupAggregationsResponse]
1478
+ Experiment groups with aggregations
1479
+ """
1480
+ _response = await self._client_wrapper.httpx_client.request(
1481
+ "v1/private/experiments/groups/aggregations",
1482
+ method="GET",
1483
+ params={
1484
+ "groups": groups,
1485
+ "types": types,
1486
+ "name": name,
1487
+ "filters": filters,
1488
+ },
1489
+ request_options=request_options,
1490
+ )
1491
+ try:
1492
+ if 200 <= _response.status_code < 300:
1493
+ _data = typing.cast(
1494
+ ExperimentGroupAggregationsResponse,
1495
+ parse_obj_as(
1496
+ type_=ExperimentGroupAggregationsResponse, # type: ignore
1497
+ object_=_response.json(),
1498
+ ),
1499
+ )
1500
+ return AsyncHttpResponse(response=_response, data=_data)
1501
+ if _response.status_code == 400:
1502
+ raise BadRequestError(
1503
+ headers=dict(_response.headers),
1504
+ body=typing.cast(
1505
+ typing.Optional[typing.Any],
1506
+ parse_obj_as(
1507
+ type_=typing.Optional[typing.Any], # type: ignore
1508
+ object_=_response.json(),
1509
+ ),
1510
+ ),
1511
+ )
1512
+ _response_json = _response.json()
1513
+ except JSONDecodeError:
1514
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
1515
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
1516
+
1517
+ async def finish_experiments(
1518
+ self, *, ids: typing.Sequence[str], request_options: typing.Optional[RequestOptions] = None
1519
+ ) -> AsyncHttpResponse[None]:
1520
+ """
1521
+ Finish experiments and trigger alert events
1522
+
1523
+ Parameters
1524
+ ----------
1525
+ ids : typing.Sequence[str]
1526
+
1527
+ request_options : typing.Optional[RequestOptions]
1528
+ Request-specific configuration.
1529
+
1530
+ Returns
1531
+ -------
1532
+ AsyncHttpResponse[None]
1533
+ """
1534
+ _response = await self._client_wrapper.httpx_client.request(
1535
+ "v1/private/experiments/finish",
1536
+ method="POST",
1537
+ json={
1538
+ "ids": ids,
1539
+ },
1540
+ headers={
1541
+ "content-type": "application/json",
1542
+ },
1543
+ request_options=request_options,
1544
+ omit=OMIT,
1545
+ )
1546
+ try:
1547
+ if 200 <= _response.status_code < 300:
1548
+ return AsyncHttpResponse(response=_response, data=None)
1549
+ if _response.status_code == 400:
1550
+ raise BadRequestError(
1551
+ headers=dict(_response.headers),
1552
+ body=typing.cast(
1553
+ typing.Optional[typing.Any],
1554
+ parse_obj_as(
1555
+ type_=typing.Optional[typing.Any], # type: ignore
1556
+ object_=_response.json(),
1557
+ ),
1558
+ ),
1559
+ )
1560
+ _response_json = _response.json()
1561
+ except JSONDecodeError:
1562
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
1563
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
1564
+
1565
+ async def get_experiment_by_id(
1566
+ self, id: str, *, request_options: typing.Optional[RequestOptions] = None
1567
+ ) -> AsyncHttpResponse[ExperimentPublic]:
1568
+ """
1569
+ Get experiment by id
1570
+
1571
+ Parameters
1572
+ ----------
1573
+ id : str
1574
+
1575
+ request_options : typing.Optional[RequestOptions]
1576
+ Request-specific configuration.
1577
+
1578
+ Returns
1579
+ -------
1580
+ AsyncHttpResponse[ExperimentPublic]
1581
+ Experiment resource
1582
+ """
1583
+ _response = await self._client_wrapper.httpx_client.request(
1584
+ f"v1/private/experiments/{jsonable_encoder(id)}",
1585
+ method="GET",
1586
+ request_options=request_options,
1587
+ )
1588
+ try:
1589
+ if 200 <= _response.status_code < 300:
1590
+ _data = typing.cast(
1591
+ ExperimentPublic,
1592
+ parse_obj_as(
1593
+ type_=ExperimentPublic, # type: ignore
1594
+ object_=_response.json(),
1595
+ ),
1596
+ )
1597
+ return AsyncHttpResponse(response=_response, data=_data)
1598
+ if _response.status_code == 404:
1599
+ raise NotFoundError(
1600
+ headers=dict(_response.headers),
1601
+ body=typing.cast(
1602
+ typing.Optional[typing.Any],
1603
+ parse_obj_as(
1604
+ type_=typing.Optional[typing.Any], # type: ignore
1605
+ object_=_response.json(),
1606
+ ),
1607
+ ),
1608
+ )
1609
+ _response_json = _response.json()
1610
+ except JSONDecodeError:
1611
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
1612
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
1613
+
1614
+ async def update_experiment(
1615
+ self,
1616
+ id: str,
1617
+ *,
1618
+ name: typing.Optional[str] = OMIT,
1619
+ metadata: typing.Optional[JsonNode] = OMIT,
1620
+ type: typing.Optional[ExperimentUpdateType] = OMIT,
1621
+ status: typing.Optional[ExperimentUpdateStatus] = OMIT,
1622
+ experiment_scores: typing.Optional[typing.Sequence[ExperimentScore]] = OMIT,
1623
+ request_options: typing.Optional[RequestOptions] = None,
1624
+ ) -> AsyncHttpResponse[None]:
1625
+ """
1626
+ Update experiment by id
1627
+
1628
+ Parameters
1629
+ ----------
1630
+ id : str
1631
+
1632
+ name : typing.Optional[str]
1633
+
1634
+ metadata : typing.Optional[JsonNode]
1635
+
1636
+ type : typing.Optional[ExperimentUpdateType]
1637
+
1638
+ status : typing.Optional[ExperimentUpdateStatus]
1639
+ The status of the experiment
1640
+
1641
+ experiment_scores : typing.Optional[typing.Sequence[ExperimentScore]]
1642
+
1643
+ request_options : typing.Optional[RequestOptions]
1644
+ Request-specific configuration.
1645
+
1646
+ Returns
1647
+ -------
1648
+ AsyncHttpResponse[None]
1649
+ """
1650
+ _response = await self._client_wrapper.httpx_client.request(
1651
+ f"v1/private/experiments/{jsonable_encoder(id)}",
1652
+ method="PATCH",
1653
+ json={
1654
+ "name": name,
1655
+ "metadata": metadata,
1656
+ "type": type,
1657
+ "status": status,
1658
+ "experiment_scores": convert_and_respect_annotation_metadata(
1659
+ object_=experiment_scores, annotation=typing.Sequence[ExperimentScore], direction="write"
1660
+ ),
1661
+ },
1662
+ headers={
1663
+ "content-type": "application/json",
1664
+ },
1665
+ request_options=request_options,
1666
+ omit=OMIT,
1667
+ )
1668
+ try:
1669
+ if 200 <= _response.status_code < 300:
1670
+ return AsyncHttpResponse(response=_response, data=None)
1671
+ if _response.status_code == 400:
1672
+ raise BadRequestError(
1673
+ headers=dict(_response.headers),
1674
+ body=typing.cast(
1675
+ typing.Optional[typing.Any],
1676
+ parse_obj_as(
1677
+ type_=typing.Optional[typing.Any], # type: ignore
1678
+ object_=_response.json(),
1679
+ ),
1680
+ ),
1681
+ )
1682
+ if _response.status_code == 404:
1683
+ raise NotFoundError(
1684
+ headers=dict(_response.headers),
1685
+ body=typing.cast(
1686
+ typing.Optional[typing.Any],
1687
+ parse_obj_as(
1688
+ type_=typing.Optional[typing.Any], # type: ignore
1689
+ object_=_response.json(),
1690
+ ),
1691
+ ),
1692
+ )
1693
+ _response_json = _response.json()
1694
+ except JSONDecodeError:
1695
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
1696
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
1697
+
1698
+ async def get_experiment_item_by_id(
1699
+ self, id: str, *, request_options: typing.Optional[RequestOptions] = None
1700
+ ) -> AsyncHttpResponse[ExperimentItemPublic]:
1701
+ """
1702
+ Get experiment item by id
1703
+
1704
+ Parameters
1705
+ ----------
1706
+ id : str
1707
+
1708
+ request_options : typing.Optional[RequestOptions]
1709
+ Request-specific configuration.
1710
+
1711
+ Returns
1712
+ -------
1713
+ AsyncHttpResponse[ExperimentItemPublic]
1714
+ Experiment item resource
1715
+ """
1716
+ _response = await self._client_wrapper.httpx_client.request(
1717
+ f"v1/private/experiments/items/{jsonable_encoder(id)}",
1718
+ method="GET",
1719
+ request_options=request_options,
1720
+ )
1721
+ try:
1722
+ if 200 <= _response.status_code < 300:
1723
+ _data = typing.cast(
1724
+ ExperimentItemPublic,
1725
+ parse_obj_as(
1726
+ type_=ExperimentItemPublic, # type: ignore
1727
+ object_=_response.json(),
1728
+ ),
1729
+ )
1730
+ return AsyncHttpResponse(response=_response, data=_data)
1731
+ if _response.status_code == 404:
1732
+ raise NotFoundError(
1733
+ headers=dict(_response.headers),
1734
+ body=typing.cast(
1735
+ typing.Optional[typing.Any],
1736
+ parse_obj_as(
1737
+ type_=typing.Optional[typing.Any], # type: ignore
1738
+ object_=_response.json(),
1739
+ ),
1740
+ ),
1741
+ )
1742
+ _response_json = _response.json()
1743
+ except JSONDecodeError:
1744
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response.text)
1745
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
1746
+
1747
+ @contextlib.asynccontextmanager
1748
+ async def stream_experiment_items(
1749
+ self,
1750
+ *,
1751
+ experiment_name: str,
1752
+ limit: typing.Optional[int] = OMIT,
1753
+ last_retrieved_id: typing.Optional[str] = OMIT,
1754
+ truncate: typing.Optional[bool] = OMIT,
1755
+ request_options: typing.Optional[RequestOptions] = None,
1756
+ ) -> typing.AsyncIterator[AsyncHttpResponse[typing.AsyncIterator[bytes]]]:
1757
+ """
1758
+ Stream experiment items
1759
+
1760
+ Parameters
1761
+ ----------
1762
+ experiment_name : str
1763
+
1764
+ limit : typing.Optional[int]
1765
+
1766
+ last_retrieved_id : typing.Optional[str]
1767
+
1768
+ truncate : typing.Optional[bool]
1769
+ Truncate image included in either input, output or metadata
1770
+
1771
+ request_options : typing.Optional[RequestOptions]
1772
+ Request-specific configuration. You can pass in configuration such as `chunk_size`, and more to customize the request and response.
1773
+
1774
+ Returns
1775
+ -------
1776
+ typing.AsyncIterator[AsyncHttpResponse[typing.AsyncIterator[bytes]]]
1777
+ Experiment items stream or error during process
1778
+ """
1779
+ async with self._client_wrapper.httpx_client.stream(
1780
+ "v1/private/experiments/items/stream",
1781
+ method="POST",
1782
+ json={
1783
+ "experiment_name": experiment_name,
1784
+ "limit": limit,
1785
+ "last_retrieved_id": last_retrieved_id,
1786
+ "truncate": truncate,
1787
+ },
1788
+ headers={
1789
+ "content-type": "application/json",
1790
+ },
1791
+ request_options=request_options,
1792
+ omit=OMIT,
1793
+ ) as _response:
1794
+
1795
+ async def stream() -> AsyncHttpResponse[typing.AsyncIterator[bytes]]:
1796
+ try:
1797
+ if 200 <= _response.status_code < 300:
1798
+ _chunk_size = request_options.get("chunk_size", None) if request_options is not None else None
1799
+ return AsyncHttpResponse(
1800
+ response=_response,
1801
+ data=(_chunk async for _chunk in _response.aiter_bytes(chunk_size=_chunk_size)),
1802
+ )
1803
+ await _response.aread()
1804
+ _response_json = _response.json()
1805
+ except JSONDecodeError:
1806
+ raise ApiError(
1807
+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.text
1808
+ )
1809
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
1810
+
1811
+ yield await stream()
1812
+
1813
+ @contextlib.asynccontextmanager
1814
+ async def stream_experiments(
1815
+ self,
1816
+ *,
1817
+ name: str,
1818
+ limit: typing.Optional[int] = OMIT,
1819
+ last_retrieved_id: typing.Optional[str] = OMIT,
1820
+ request_options: typing.Optional[RequestOptions] = None,
1821
+ ) -> typing.AsyncIterator[AsyncHttpResponse[typing.AsyncIterator[bytes]]]:
1822
+ """
1823
+ Stream experiments
1824
+
1825
+ Parameters
1826
+ ----------
1827
+ name : str
1828
+
1829
+ limit : typing.Optional[int]
1830
+
1831
+ last_retrieved_id : typing.Optional[str]
1832
+
1833
+ request_options : typing.Optional[RequestOptions]
1834
+ Request-specific configuration. You can pass in configuration such as `chunk_size`, and more to customize the request and response.
1835
+
1836
+ Returns
1837
+ -------
1838
+ typing.AsyncIterator[AsyncHttpResponse[typing.AsyncIterator[bytes]]]
1839
+ Experiments stream or error during process
1840
+ """
1841
+ async with self._client_wrapper.httpx_client.stream(
1842
+ "v1/private/experiments/stream",
1843
+ method="POST",
1844
+ json={
1845
+ "name": name,
1846
+ "limit": limit,
1847
+ "last_retrieved_id": last_retrieved_id,
1848
+ },
1849
+ headers={
1850
+ "content-type": "application/json",
1851
+ },
1852
+ request_options=request_options,
1853
+ omit=OMIT,
1854
+ ) as _response:
1855
+
1856
+ async def stream() -> AsyncHttpResponse[typing.AsyncIterator[bytes]]:
1857
+ try:
1858
+ if 200 <= _response.status_code < 300:
1859
+ _chunk_size = request_options.get("chunk_size", None) if request_options is not None else None
1860
+ return AsyncHttpResponse(
1861
+ response=_response,
1862
+ data=(_chunk async for _chunk in _response.aiter_bytes(chunk_size=_chunk_size)),
1863
+ )
1864
+ await _response.aread()
1865
+ _response_json = _response.json()
1866
+ except JSONDecodeError:
1867
+ raise ApiError(
1868
+ status_code=_response.status_code, headers=dict(_response.headers), body=_response.text
1869
+ )
1870
+ raise ApiError(status_code=_response.status_code, headers=dict(_response.headers), body=_response_json)
1871
+
1872
+ yield await stream()