edsl 0.1.39.dev3__py3-none-any.whl → 0.1.39.dev5__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 (341) hide show
  1. edsl/Base.py +413 -332
  2. edsl/BaseDiff.py +260 -260
  3. edsl/TemplateLoader.py +24 -24
  4. edsl/__init__.py +57 -49
  5. edsl/__version__.py +1 -1
  6. edsl/agents/Agent.py +1071 -867
  7. edsl/agents/AgentList.py +551 -413
  8. edsl/agents/Invigilator.py +284 -233
  9. edsl/agents/InvigilatorBase.py +257 -270
  10. edsl/agents/PromptConstructor.py +272 -354
  11. edsl/agents/QuestionInstructionPromptBuilder.py +128 -0
  12. edsl/agents/QuestionTemplateReplacementsBuilder.py +137 -0
  13. edsl/agents/__init__.py +2 -3
  14. edsl/agents/descriptors.py +99 -99
  15. edsl/agents/prompt_helpers.py +129 -129
  16. edsl/agents/question_option_processor.py +172 -0
  17. edsl/auto/AutoStudy.py +130 -117
  18. edsl/auto/StageBase.py +243 -230
  19. edsl/auto/StageGenerateSurvey.py +178 -178
  20. edsl/auto/StageLabelQuestions.py +125 -125
  21. edsl/auto/StagePersona.py +61 -61
  22. edsl/auto/StagePersonaDimensionValueRanges.py +88 -88
  23. edsl/auto/StagePersonaDimensionValues.py +74 -74
  24. edsl/auto/StagePersonaDimensions.py +69 -69
  25. edsl/auto/StageQuestions.py +74 -73
  26. edsl/auto/SurveyCreatorPipeline.py +21 -21
  27. edsl/auto/utilities.py +218 -224
  28. edsl/base/Base.py +279 -279
  29. edsl/config.py +177 -157
  30. edsl/conversation/Conversation.py +290 -290
  31. edsl/conversation/car_buying.py +59 -58
  32. edsl/conversation/chips.py +95 -95
  33. edsl/conversation/mug_negotiation.py +81 -81
  34. edsl/conversation/next_speaker_utilities.py +93 -93
  35. edsl/coop/CoopFunctionsMixin.py +15 -0
  36. edsl/coop/ExpectedParrotKeyHandler.py +125 -0
  37. edsl/coop/PriceFetcher.py +54 -54
  38. edsl/coop/__init__.py +2 -2
  39. edsl/coop/coop.py +1106 -1028
  40. edsl/coop/utils.py +131 -131
  41. edsl/data/Cache.py +573 -555
  42. edsl/data/CacheEntry.py +230 -233
  43. edsl/data/CacheHandler.py +168 -149
  44. edsl/data/RemoteCacheSync.py +186 -78
  45. edsl/data/SQLiteDict.py +292 -292
  46. edsl/data/__init__.py +5 -4
  47. edsl/data/orm.py +10 -10
  48. edsl/data_transfer_models.py +74 -73
  49. edsl/enums.py +202 -175
  50. edsl/exceptions/BaseException.py +21 -21
  51. edsl/exceptions/__init__.py +54 -54
  52. edsl/exceptions/agents.py +54 -42
  53. edsl/exceptions/cache.py +5 -5
  54. edsl/exceptions/configuration.py +16 -16
  55. edsl/exceptions/coop.py +10 -10
  56. edsl/exceptions/data.py +14 -14
  57. edsl/exceptions/general.py +34 -34
  58. edsl/exceptions/inference_services.py +5 -0
  59. edsl/exceptions/jobs.py +33 -33
  60. edsl/exceptions/language_models.py +63 -63
  61. edsl/exceptions/prompts.py +15 -15
  62. edsl/exceptions/questions.py +109 -91
  63. edsl/exceptions/results.py +29 -29
  64. edsl/exceptions/scenarios.py +29 -22
  65. edsl/exceptions/surveys.py +37 -37
  66. edsl/inference_services/AnthropicService.py +106 -87
  67. edsl/inference_services/AvailableModelCacheHandler.py +184 -0
  68. edsl/inference_services/AvailableModelFetcher.py +215 -0
  69. edsl/inference_services/AwsBedrock.py +118 -120
  70. edsl/inference_services/AzureAI.py +215 -217
  71. edsl/inference_services/DeepInfraService.py +18 -18
  72. edsl/inference_services/GoogleService.py +143 -148
  73. edsl/inference_services/GroqService.py +20 -20
  74. edsl/inference_services/InferenceServiceABC.py +80 -147
  75. edsl/inference_services/InferenceServicesCollection.py +138 -97
  76. edsl/inference_services/MistralAIService.py +120 -123
  77. edsl/inference_services/OllamaService.py +18 -18
  78. edsl/inference_services/OpenAIService.py +236 -224
  79. edsl/inference_services/PerplexityService.py +160 -163
  80. edsl/inference_services/ServiceAvailability.py +135 -0
  81. edsl/inference_services/TestService.py +90 -89
  82. edsl/inference_services/TogetherAIService.py +172 -170
  83. edsl/inference_services/data_structures.py +134 -0
  84. edsl/inference_services/models_available_cache.py +118 -118
  85. edsl/inference_services/rate_limits_cache.py +25 -25
  86. edsl/inference_services/registry.py +41 -41
  87. edsl/inference_services/write_available.py +10 -10
  88. edsl/jobs/AnswerQuestionFunctionConstructor.py +223 -0
  89. edsl/jobs/Answers.py +43 -56
  90. edsl/jobs/FetchInvigilator.py +47 -0
  91. edsl/jobs/InterviewTaskManager.py +98 -0
  92. edsl/jobs/InterviewsConstructor.py +50 -0
  93. edsl/jobs/Jobs.py +823 -898
  94. edsl/jobs/JobsChecks.py +172 -147
  95. edsl/jobs/JobsComponentConstructor.py +189 -0
  96. edsl/jobs/JobsPrompts.py +270 -268
  97. edsl/jobs/JobsRemoteInferenceHandler.py +311 -239
  98. edsl/jobs/JobsRemoteInferenceLogger.py +239 -0
  99. edsl/jobs/RequestTokenEstimator.py +30 -0
  100. edsl/jobs/__init__.py +1 -1
  101. edsl/jobs/async_interview_runner.py +138 -0
  102. edsl/jobs/buckets/BucketCollection.py +104 -63
  103. edsl/jobs/buckets/ModelBuckets.py +65 -65
  104. edsl/jobs/buckets/TokenBucket.py +283 -251
  105. edsl/jobs/buckets/TokenBucketAPI.py +211 -0
  106. edsl/jobs/buckets/TokenBucketClient.py +191 -0
  107. edsl/jobs/check_survey_scenario_compatibility.py +85 -0
  108. edsl/jobs/data_structures.py +120 -0
  109. edsl/jobs/decorators.py +35 -0
  110. edsl/jobs/interviews/Interview.py +396 -661
  111. edsl/jobs/interviews/InterviewExceptionCollection.py +99 -99
  112. edsl/jobs/interviews/InterviewExceptionEntry.py +186 -186
  113. edsl/jobs/interviews/InterviewStatistic.py +63 -63
  114. edsl/jobs/interviews/InterviewStatisticsCollection.py +25 -25
  115. edsl/jobs/interviews/InterviewStatusDictionary.py +78 -78
  116. edsl/jobs/interviews/InterviewStatusLog.py +92 -92
  117. edsl/jobs/interviews/ReportErrors.py +66 -66
  118. edsl/jobs/interviews/interview_status_enum.py +9 -9
  119. edsl/jobs/jobs_status_enums.py +9 -0
  120. edsl/jobs/loggers/HTMLTableJobLogger.py +304 -0
  121. edsl/jobs/results_exceptions_handler.py +98 -0
  122. edsl/jobs/runners/JobsRunnerAsyncio.py +151 -466
  123. edsl/jobs/runners/JobsRunnerStatus.py +297 -330
  124. edsl/jobs/tasks/QuestionTaskCreator.py +244 -242
  125. edsl/jobs/tasks/TaskCreators.py +64 -64
  126. edsl/jobs/tasks/TaskHistory.py +470 -450
  127. edsl/jobs/tasks/TaskStatusLog.py +23 -23
  128. edsl/jobs/tasks/task_status_enum.py +161 -163
  129. edsl/jobs/tokens/InterviewTokenUsage.py +27 -27
  130. edsl/jobs/tokens/TokenUsage.py +34 -34
  131. edsl/language_models/ComputeCost.py +63 -0
  132. edsl/language_models/LanguageModel.py +626 -668
  133. edsl/language_models/ModelList.py +164 -155
  134. edsl/language_models/PriceManager.py +127 -0
  135. edsl/language_models/RawResponseHandler.py +106 -0
  136. edsl/language_models/RegisterLanguageModelsMeta.py +184 -184
  137. edsl/language_models/ServiceDataSources.py +0 -0
  138. edsl/language_models/__init__.py +2 -3
  139. edsl/language_models/fake_openai_call.py +15 -15
  140. edsl/language_models/fake_openai_service.py +61 -61
  141. edsl/language_models/key_management/KeyLookup.py +63 -0
  142. edsl/language_models/key_management/KeyLookupBuilder.py +273 -0
  143. edsl/language_models/key_management/KeyLookupCollection.py +38 -0
  144. edsl/language_models/key_management/__init__.py +0 -0
  145. edsl/language_models/key_management/models.py +131 -0
  146. edsl/language_models/model.py +256 -0
  147. edsl/language_models/repair.py +156 -156
  148. edsl/language_models/utilities.py +65 -64
  149. edsl/notebooks/Notebook.py +263 -258
  150. edsl/notebooks/NotebookToLaTeX.py +142 -0
  151. edsl/notebooks/__init__.py +1 -1
  152. edsl/prompts/Prompt.py +352 -362
  153. edsl/prompts/__init__.py +2 -2
  154. edsl/questions/ExceptionExplainer.py +77 -0
  155. edsl/questions/HTMLQuestion.py +103 -0
  156. edsl/questions/QuestionBase.py +518 -664
  157. edsl/questions/QuestionBasePromptsMixin.py +221 -217
  158. edsl/questions/QuestionBudget.py +227 -227
  159. edsl/questions/QuestionCheckBox.py +359 -359
  160. edsl/questions/QuestionExtract.py +180 -182
  161. edsl/questions/QuestionFreeText.py +113 -114
  162. edsl/questions/QuestionFunctional.py +166 -166
  163. edsl/questions/QuestionList.py +223 -231
  164. edsl/questions/QuestionMatrix.py +265 -0
  165. edsl/questions/QuestionMultipleChoice.py +330 -286
  166. edsl/questions/QuestionNumerical.py +151 -153
  167. edsl/questions/QuestionRank.py +314 -324
  168. edsl/questions/Quick.py +41 -41
  169. edsl/questions/SimpleAskMixin.py +74 -73
  170. edsl/questions/__init__.py +27 -26
  171. edsl/questions/{AnswerValidatorMixin.py → answer_validator_mixin.py} +334 -289
  172. edsl/questions/compose_questions.py +98 -98
  173. edsl/questions/data_structures.py +20 -0
  174. edsl/questions/decorators.py +21 -21
  175. edsl/questions/derived/QuestionLikertFive.py +76 -76
  176. edsl/questions/derived/QuestionLinearScale.py +90 -87
  177. edsl/questions/derived/QuestionTopK.py +93 -93
  178. edsl/questions/derived/QuestionYesNo.py +82 -82
  179. edsl/questions/descriptors.py +427 -413
  180. edsl/questions/loop_processor.py +149 -0
  181. edsl/questions/prompt_templates/question_budget.jinja +13 -13
  182. edsl/questions/prompt_templates/question_checkbox.jinja +32 -32
  183. edsl/questions/prompt_templates/question_extract.jinja +11 -11
  184. edsl/questions/prompt_templates/question_free_text.jinja +3 -3
  185. edsl/questions/prompt_templates/question_linear_scale.jinja +11 -11
  186. edsl/questions/prompt_templates/question_list.jinja +17 -17
  187. edsl/questions/prompt_templates/question_multiple_choice.jinja +33 -33
  188. edsl/questions/prompt_templates/question_numerical.jinja +36 -36
  189. edsl/questions/{QuestionBaseGenMixin.py → question_base_gen_mixin.py} +168 -161
  190. edsl/questions/question_registry.py +177 -177
  191. edsl/questions/{RegisterQuestionsMeta.py → register_questions_meta.py} +71 -71
  192. edsl/questions/{ResponseValidatorABC.py → response_validator_abc.py} +188 -174
  193. edsl/questions/response_validator_factory.py +34 -0
  194. edsl/questions/settings.py +12 -12
  195. edsl/questions/templates/budget/answering_instructions.jinja +7 -7
  196. edsl/questions/templates/budget/question_presentation.jinja +7 -7
  197. edsl/questions/templates/checkbox/answering_instructions.jinja +10 -10
  198. edsl/questions/templates/checkbox/question_presentation.jinja +22 -22
  199. edsl/questions/templates/extract/answering_instructions.jinja +7 -7
  200. edsl/questions/templates/likert_five/answering_instructions.jinja +10 -10
  201. edsl/questions/templates/likert_five/question_presentation.jinja +11 -11
  202. edsl/questions/templates/linear_scale/answering_instructions.jinja +5 -5
  203. edsl/questions/templates/linear_scale/question_presentation.jinja +5 -5
  204. edsl/questions/templates/list/answering_instructions.jinja +3 -3
  205. edsl/questions/templates/list/question_presentation.jinja +5 -5
  206. edsl/questions/templates/matrix/__init__.py +1 -0
  207. edsl/questions/templates/matrix/answering_instructions.jinja +5 -0
  208. edsl/questions/templates/matrix/question_presentation.jinja +20 -0
  209. edsl/questions/templates/multiple_choice/answering_instructions.jinja +9 -9
  210. edsl/questions/templates/multiple_choice/question_presentation.jinja +11 -11
  211. edsl/questions/templates/numerical/answering_instructions.jinja +6 -6
  212. edsl/questions/templates/numerical/question_presentation.jinja +6 -6
  213. edsl/questions/templates/rank/answering_instructions.jinja +11 -11
  214. edsl/questions/templates/rank/question_presentation.jinja +15 -15
  215. edsl/questions/templates/top_k/answering_instructions.jinja +8 -8
  216. edsl/questions/templates/top_k/question_presentation.jinja +22 -22
  217. edsl/questions/templates/yes_no/answering_instructions.jinja +6 -6
  218. edsl/questions/templates/yes_no/question_presentation.jinja +11 -11
  219. edsl/results/CSSParameterizer.py +108 -108
  220. edsl/results/Dataset.py +587 -424
  221. edsl/results/DatasetExportMixin.py +594 -731
  222. edsl/results/DatasetTree.py +295 -275
  223. edsl/results/MarkdownToDocx.py +122 -0
  224. edsl/results/MarkdownToPDF.py +111 -0
  225. edsl/results/Result.py +557 -465
  226. edsl/results/Results.py +1183 -1165
  227. edsl/results/ResultsExportMixin.py +45 -43
  228. edsl/results/ResultsGGMixin.py +121 -121
  229. edsl/results/TableDisplay.py +125 -198
  230. edsl/results/TextEditor.py +50 -0
  231. edsl/results/__init__.py +2 -2
  232. edsl/results/file_exports.py +252 -0
  233. edsl/results/{ResultsFetchMixin.py → results_fetch_mixin.py} +33 -33
  234. edsl/results/{Selector.py → results_selector.py} +145 -135
  235. edsl/results/{ResultsToolsMixin.py → results_tools_mixin.py} +98 -98
  236. edsl/results/smart_objects.py +96 -0
  237. edsl/results/table_data_class.py +12 -0
  238. edsl/results/table_display.css +77 -77
  239. edsl/results/table_renderers.py +118 -0
  240. edsl/results/tree_explore.py +115 -115
  241. edsl/scenarios/ConstructDownloadLink.py +109 -0
  242. edsl/scenarios/DocumentChunker.py +102 -0
  243. edsl/scenarios/DocxScenario.py +16 -0
  244. edsl/scenarios/FileStore.py +511 -632
  245. edsl/scenarios/PdfExtractor.py +40 -0
  246. edsl/scenarios/Scenario.py +498 -601
  247. edsl/scenarios/ScenarioHtmlMixin.py +65 -64
  248. edsl/scenarios/ScenarioList.py +1458 -1287
  249. edsl/scenarios/ScenarioListExportMixin.py +45 -52
  250. edsl/scenarios/ScenarioListPdfMixin.py +239 -261
  251. edsl/scenarios/__init__.py +3 -4
  252. edsl/scenarios/directory_scanner.py +96 -0
  253. edsl/scenarios/file_methods.py +85 -0
  254. edsl/scenarios/handlers/__init__.py +13 -0
  255. edsl/scenarios/handlers/csv.py +38 -0
  256. edsl/scenarios/handlers/docx.py +76 -0
  257. edsl/scenarios/handlers/html.py +37 -0
  258. edsl/scenarios/handlers/json.py +111 -0
  259. edsl/scenarios/handlers/latex.py +5 -0
  260. edsl/scenarios/handlers/md.py +51 -0
  261. edsl/scenarios/handlers/pdf.py +68 -0
  262. edsl/scenarios/handlers/png.py +39 -0
  263. edsl/scenarios/handlers/pptx.py +105 -0
  264. edsl/scenarios/handlers/py.py +294 -0
  265. edsl/scenarios/handlers/sql.py +313 -0
  266. edsl/scenarios/handlers/sqlite.py +149 -0
  267. edsl/scenarios/handlers/txt.py +33 -0
  268. edsl/scenarios/{ScenarioJoin.py → scenario_join.py} +131 -127
  269. edsl/scenarios/scenario_selector.py +156 -0
  270. edsl/shared.py +1 -1
  271. edsl/study/ObjectEntry.py +173 -173
  272. edsl/study/ProofOfWork.py +113 -113
  273. edsl/study/SnapShot.py +80 -80
  274. edsl/study/Study.py +521 -528
  275. edsl/study/__init__.py +4 -4
  276. edsl/surveys/ConstructDAG.py +92 -0
  277. edsl/surveys/DAG.py +148 -148
  278. edsl/surveys/EditSurvey.py +221 -0
  279. edsl/surveys/InstructionHandler.py +100 -0
  280. edsl/surveys/Memory.py +31 -31
  281. edsl/surveys/MemoryManagement.py +72 -0
  282. edsl/surveys/MemoryPlan.py +244 -244
  283. edsl/surveys/Rule.py +327 -326
  284. edsl/surveys/RuleCollection.py +385 -387
  285. edsl/surveys/RuleManager.py +172 -0
  286. edsl/surveys/Simulator.py +75 -0
  287. edsl/surveys/Survey.py +1280 -1801
  288. edsl/surveys/SurveyCSS.py +273 -261
  289. edsl/surveys/SurveyExportMixin.py +259 -259
  290. edsl/surveys/{SurveyFlowVisualizationMixin.py → SurveyFlowVisualization.py} +181 -179
  291. edsl/surveys/SurveyQualtricsImport.py +284 -284
  292. edsl/surveys/SurveyToApp.py +141 -0
  293. edsl/surveys/__init__.py +5 -3
  294. edsl/surveys/base.py +53 -53
  295. edsl/surveys/descriptors.py +60 -56
  296. edsl/surveys/instructions/ChangeInstruction.py +48 -49
  297. edsl/surveys/instructions/Instruction.py +56 -65
  298. edsl/surveys/instructions/InstructionCollection.py +82 -77
  299. edsl/templates/error_reporting/base.html +23 -23
  300. edsl/templates/error_reporting/exceptions_by_model.html +34 -34
  301. edsl/templates/error_reporting/exceptions_by_question_name.html +16 -16
  302. edsl/templates/error_reporting/exceptions_by_type.html +16 -16
  303. edsl/templates/error_reporting/interview_details.html +115 -115
  304. edsl/templates/error_reporting/interviews.html +19 -19
  305. edsl/templates/error_reporting/overview.html +4 -4
  306. edsl/templates/error_reporting/performance_plot.html +1 -1
  307. edsl/templates/error_reporting/report.css +73 -73
  308. edsl/templates/error_reporting/report.html +117 -117
  309. edsl/templates/error_reporting/report.js +25 -25
  310. edsl/tools/__init__.py +1 -1
  311. edsl/tools/clusters.py +192 -192
  312. edsl/tools/embeddings.py +27 -27
  313. edsl/tools/embeddings_plotting.py +118 -118
  314. edsl/tools/plotting.py +112 -112
  315. edsl/tools/summarize.py +18 -18
  316. edsl/utilities/PrettyList.py +56 -0
  317. edsl/utilities/SystemInfo.py +28 -28
  318. edsl/utilities/__init__.py +22 -22
  319. edsl/utilities/ast_utilities.py +25 -25
  320. edsl/utilities/data/Registry.py +6 -6
  321. edsl/utilities/data/__init__.py +1 -1
  322. edsl/utilities/data/scooter_results.json +1 -1
  323. edsl/utilities/decorators.py +77 -77
  324. edsl/utilities/gcp_bucket/cloud_storage.py +96 -96
  325. edsl/utilities/interface.py +627 -627
  326. edsl/utilities/is_notebook.py +18 -0
  327. edsl/utilities/is_valid_variable_name.py +11 -0
  328. edsl/utilities/naming_utilities.py +263 -263
  329. edsl/utilities/remove_edsl_version.py +24 -0
  330. edsl/utilities/repair_functions.py +28 -28
  331. edsl/utilities/restricted_python.py +70 -70
  332. edsl/utilities/utilities.py +436 -424
  333. {edsl-0.1.39.dev3.dist-info → edsl-0.1.39.dev5.dist-info}/LICENSE +21 -21
  334. {edsl-0.1.39.dev3.dist-info → edsl-0.1.39.dev5.dist-info}/METADATA +13 -11
  335. edsl-0.1.39.dev5.dist-info/RECORD +358 -0
  336. {edsl-0.1.39.dev3.dist-info → edsl-0.1.39.dev5.dist-info}/WHEEL +1 -1
  337. edsl/language_models/KeyLookup.py +0 -30
  338. edsl/language_models/registry.py +0 -190
  339. edsl/language_models/unused/ReplicateBase.py +0 -83
  340. edsl/results/ResultsDBMixin.py +0 -238
  341. edsl-0.1.39.dev3.dist-info/RECORD +0 -277
@@ -1,91 +1,109 @@
1
- from typing import Any, SupportsIndex
2
- from jinja2 import Template
3
- import json
4
-
5
-
6
- class QuestionErrors(Exception):
7
- """
8
- Base exception class for question-related errors.
9
- """
10
-
11
- def __init__(self, message="An error occurred with the question"):
12
- self.message = message
13
- super().__init__(self.message)
14
-
15
-
16
- class QuestionAnswerValidationError(QuestionErrors):
17
- documentation = "https://docs.expectedparrot.com/en/latest/exceptions.html"
18
-
19
- explanation = """This when the answer coming from the Language Model does not conform to the expectation for that question type.
20
- For example, if the question is a multiple choice question, the answer should be drawn from the list of options provided.
21
- """
22
-
23
- def __init__(self, message="Invalid answer.", data=None, model=None):
24
- self.message = message
25
- self.data = data
26
- self.model = model
27
- super().__init__(self.message)
28
-
29
- def __str__(self):
30
- return f"""{repr(self)}
31
- Data being validated: {self.data}
32
- Pydnantic Model: {self.model}.
33
- Reported error: {self.message}."""
34
-
35
- def to_html_dict(self):
36
- return {
37
- "error_type": ("Name of the exception", "p", "/p", self.__class__.__name__),
38
- "explaination": ("Explanation", "p", "/p", self.explanation),
39
- "edsl answer": (
40
- "What model returned",
41
- "pre",
42
- "/pre",
43
- json.dumps(self.data, indent=2),
44
- ),
45
- "validating_model": (
46
- "Pydantic model for answers",
47
- "pre",
48
- "/pre",
49
- json.dumps(self.model.model_json_schema(), indent=2),
50
- ),
51
- "error_message": (
52
- "Error message Pydantic returned",
53
- "p",
54
- "/p",
55
- self.message,
56
- ),
57
- "documentation_url": (
58
- "URL to EDSL docs",
59
- f"a href='{self.documentation}'",
60
- "/a",
61
- self.documentation,
62
- ),
63
- }
64
-
65
-
66
- class QuestionCreationValidationError(QuestionErrors):
67
- pass
68
-
69
-
70
- class QuestionResponseValidationError(QuestionErrors):
71
- pass
72
-
73
-
74
- class QuestionAttributeMissing(QuestionErrors):
75
- pass
76
-
77
-
78
- class QuestionSerializationError(QuestionErrors):
79
- pass
80
-
81
-
82
- class QuestionScenarioRenderError(QuestionErrors):
83
- pass
84
-
85
-
86
- class QuestionMissingTypeError(QuestionErrors):
87
- pass
88
-
89
-
90
- class QuestionBadTypeError(QuestionErrors):
91
- pass
1
+ from typing import Any, SupportsIndex
2
+ import json
3
+ from pydantic import ValidationError
4
+
5
+
6
+ class QuestionErrors(Exception):
7
+ """
8
+ Base exception class for question-related errors.
9
+ """
10
+
11
+ def __init__(self, message="An error occurred with the question"):
12
+ self.message = message
13
+ super().__init__(self.message)
14
+
15
+
16
+ class QuestionAnswerValidationError(QuestionErrors):
17
+ documentation = "https://docs.expectedparrot.com/en/latest/exceptions.html"
18
+
19
+ explanation = """This when the answer coming from the Language Model does not conform to the expectation for that question type.
20
+ For example, if the question is a multiple choice question, the answer should be drawn from the list of options provided.
21
+ """
22
+
23
+ def __init__(
24
+ self,
25
+ message="Invalid answer.",
26
+ pydantic_error: ValidationError = None,
27
+ data: dict = None,
28
+ model=None,
29
+ ):
30
+ self.message = message
31
+ self.pydantic_error = pydantic_error
32
+ self.data = data
33
+ self.model = model
34
+ super().__init__(self.message)
35
+
36
+ def __str__(self):
37
+ if isinstance(self.message, ValidationError):
38
+ # If it's a ValidationError, just return the core error message
39
+ return str(self.message)
40
+ elif hasattr(self.message, "errors"):
41
+ # Handle the case where it's already been converted to a string but has errors
42
+ error_list = self.message.errors()
43
+ if error_list:
44
+ return str(error_list[0].get("msg", "Unknown error"))
45
+ return str(self.message)
46
+
47
+ # def __str__(self):
48
+ # return f"""{repr(self)}
49
+ # Data being validated: {self.data}
50
+ # Pydnantic Model: {self.model}.
51
+ # Reported error: {self.message}."""
52
+
53
+ def to_html_dict(self):
54
+ return {
55
+ "error_type": ("Name of the exception", "p", "/p", self.__class__.__name__),
56
+ "explaination": ("Explanation", "p", "/p", self.explanation),
57
+ "edsl answer": (
58
+ "What model returned",
59
+ "pre",
60
+ "/pre",
61
+ json.dumps(self.data, indent=2),
62
+ ),
63
+ "validating_model": (
64
+ "Pydantic model for answers",
65
+ "pre",
66
+ "/pre",
67
+ json.dumps(self.model.model_json_schema(), indent=2),
68
+ ),
69
+ "error_message": (
70
+ "Error message Pydantic returned",
71
+ "p",
72
+ "/p",
73
+ self.message,
74
+ ),
75
+ "documentation_url": (
76
+ "URL to EDSL docs",
77
+ f"a href='{self.documentation}'",
78
+ "/a",
79
+ self.documentation,
80
+ ),
81
+ }
82
+
83
+
84
+ class QuestionCreationValidationError(QuestionErrors):
85
+ pass
86
+
87
+
88
+ class QuestionResponseValidationError(QuestionErrors):
89
+ pass
90
+
91
+
92
+ class QuestionAttributeMissing(QuestionErrors):
93
+ pass
94
+
95
+
96
+ class QuestionSerializationError(QuestionErrors):
97
+ pass
98
+
99
+
100
+ class QuestionScenarioRenderError(QuestionErrors):
101
+ pass
102
+
103
+
104
+ class QuestionMissingTypeError(QuestionErrors):
105
+ pass
106
+
107
+
108
+ class QuestionBadTypeError(QuestionErrors):
109
+ pass
@@ -1,29 +1,29 @@
1
- from edsl.exceptions.BaseException import BaseException
2
-
3
-
4
- class ResultsError(BaseException):
5
- relevant_docs = "https://docs.expectedparrot.com/en/latest/results.html"
6
-
7
-
8
- class ResultsDeserializationError(ResultsError):
9
- pass
10
-
11
-
12
- class ResultsBadMutationstringError(ResultsError):
13
- pass
14
-
15
-
16
- class ResultsColumnNotFoundError(ResultsError):
17
- pass
18
-
19
-
20
- class ResultsInvalidNameError(ResultsError):
21
- pass
22
-
23
-
24
- class ResultsMutateError(ResultsError):
25
- pass
26
-
27
-
28
- class ResultsFilterError(ResultsError):
29
- pass
1
+ from edsl.exceptions.BaseException import BaseException
2
+
3
+
4
+ class ResultsError(BaseException):
5
+ relevant_docs = "https://docs.expectedparrot.com/en/latest/results.html"
6
+
7
+
8
+ class ResultsDeserializationError(ResultsError):
9
+ pass
10
+
11
+
12
+ class ResultsBadMutationstringError(ResultsError):
13
+ pass
14
+
15
+
16
+ class ResultsColumnNotFoundError(ResultsError):
17
+ pass
18
+
19
+
20
+ class ResultsInvalidNameError(ResultsError):
21
+ pass
22
+
23
+
24
+ class ResultsMutateError(ResultsError):
25
+ pass
26
+
27
+
28
+ class ResultsFilterError(ResultsError):
29
+ pass
@@ -1,22 +1,29 @@
1
- import re
2
- import textwrap
3
-
4
-
5
- class ScenarioError(Exception):
6
- documentation = "https://docs.expectedparrot.com/en/latest/scenarios.html#module-edsl.scenarios.Scenario"
7
-
8
- def __init__(self, message: str):
9
- self.message = message + "\n" + "Documentation: " + self.documentation
10
- super().__init__(self.message)
11
-
12
- def __str__(self):
13
- return self.make_urls_clickable(self.message)
14
-
15
- @staticmethod
16
- def make_urls_clickable(text):
17
- url_pattern = r"https?://[^\s]+"
18
- urls = re.findall(url_pattern, text)
19
- for url in urls:
20
- clickable_url = f"\033]8;;{url}\007{url}\033]8;;\007"
21
- text = text.replace(url, clickable_url)
22
- return text
1
+ import re
2
+ import textwrap
3
+
4
+ # from IPython.core.error import UsageError
5
+
6
+
7
+ class AgentListError(Exception):
8
+ def __init__(self, message):
9
+ super().__init__(message)
10
+
11
+
12
+ class ScenarioError(Exception):
13
+ documentation = "https://docs.expectedparrot.com/en/latest/scenarios.html#module-edsl.scenarios.Scenario"
14
+
15
+ def __init__(self, message: str):
16
+ self.message = message + "\n" + "Documentation: " + self.documentation
17
+ super().__init__(self.message)
18
+
19
+ def __str__(self):
20
+ return self.make_urls_clickable(self.message)
21
+
22
+ @staticmethod
23
+ def make_urls_clickable(text):
24
+ url_pattern = r"https?://[^\s]+"
25
+ urls = re.findall(url_pattern, text)
26
+ for url in urls:
27
+ clickable_url = f"\033]8;;{url}\007{url}\033]8;;\007"
28
+ text = text.replace(url, clickable_url)
29
+ return text
@@ -1,37 +1,37 @@
1
- from edsl.exceptions.BaseException import BaseException
2
-
3
-
4
- class SurveyError(BaseException):
5
- relevant_doc = "https://docs.expectedparrot.com/en/latest/surveys.html"
6
-
7
-
8
- class SurveyCreationError(SurveyError):
9
- pass
10
-
11
-
12
- class SurveyHasNoRulesError(SurveyError):
13
- pass
14
-
15
-
16
- class SurveyRuleSendsYouBackwardsError(SurveyError):
17
- pass
18
-
19
-
20
- class SurveyRuleSkipLogicSyntaxError(SurveyError):
21
- pass
22
-
23
-
24
- class SurveyRuleReferenceInRuleToUnknownQuestionError(SurveyError):
25
- pass
26
-
27
-
28
- class SurveyRuleRefersToFutureStateError(SurveyError):
29
- pass
30
-
31
-
32
- class SurveyRuleCollectionHasNoRulesAtNodeError(SurveyError):
33
- pass
34
-
35
-
36
- class SurveyRuleCannotEvaluateError(SurveyError):
37
- pass
1
+ from edsl.exceptions.BaseException import BaseException
2
+
3
+
4
+ class SurveyError(BaseException):
5
+ relevant_doc = "https://docs.expectedparrot.com/en/latest/surveys.html"
6
+
7
+
8
+ class SurveyCreationError(SurveyError):
9
+ pass
10
+
11
+
12
+ class SurveyHasNoRulesError(SurveyError):
13
+ pass
14
+
15
+
16
+ class SurveyRuleSendsYouBackwardsError(SurveyError):
17
+ pass
18
+
19
+
20
+ class SurveyRuleSkipLogicSyntaxError(SurveyError):
21
+ pass
22
+
23
+
24
+ class SurveyRuleReferenceInRuleToUnknownQuestionError(SurveyError):
25
+ pass
26
+
27
+
28
+ class SurveyRuleRefersToFutureStateError(SurveyError):
29
+ pass
30
+
31
+
32
+ class SurveyRuleCollectionHasNoRulesAtNodeError(SurveyError):
33
+ pass
34
+
35
+
36
+ class SurveyRuleCannotEvaluateError(SurveyError):
37
+ pass
@@ -1,87 +1,106 @@
1
- import os
2
- from typing import Any, Optional, List
3
- import re
4
- from anthropic import AsyncAnthropic
5
- from edsl.inference_services.InferenceServiceABC import InferenceServiceABC
6
- from edsl.language_models.LanguageModel import LanguageModel
7
-
8
-
9
- class AnthropicService(InferenceServiceABC):
10
- """Anthropic service class."""
11
-
12
- _inference_service_ = "anthropic"
13
- _env_key_name_ = "ANTHROPIC_API_KEY"
14
- key_sequence = ["content", 0, "text"] # ["content"][0]["text"]
15
- usage_sequence = ["usage"]
16
- input_token_name = "input_tokens"
17
- output_token_name = "output_tokens"
18
- model_exclude_list = []
19
-
20
- @classmethod
21
- def available(cls):
22
- # TODO - replace with an API call
23
- return [
24
- "claude-3-5-sonnet-20240620",
25
- "claude-3-opus-20240229",
26
- "claude-3-sonnet-20240229",
27
- "claude-3-haiku-20240307",
28
- ]
29
-
30
- @classmethod
31
- def create_model(
32
- cls, model_name: str = "claude-3-opus-20240229", model_class_name=None
33
- ) -> LanguageModel:
34
- if model_class_name is None:
35
- model_class_name = cls.to_class_name(model_name)
36
-
37
- class LLM(LanguageModel):
38
- """
39
- Child class of LanguageModel for interacting with OpenAI models
40
- """
41
-
42
- key_sequence = cls.key_sequence
43
- usage_sequence = cls.usage_sequence
44
- input_token_name = cls.input_token_name
45
- output_token_name = cls.output_token_name
46
-
47
- _inference_service_ = cls._inference_service_
48
- _model_ = model_name
49
- _parameters_ = {
50
- "temperature": 0.5,
51
- "max_tokens": 1000,
52
- "top_p": 1,
53
- "frequency_penalty": 0,
54
- "presence_penalty": 0,
55
- "logprobs": False,
56
- "top_logprobs": 3,
57
- }
58
-
59
- _tpm = cls.get_tpm(cls)
60
- _rpm = cls.get_rpm(cls)
61
-
62
- async def async_execute_model_call(
63
- self,
64
- user_prompt: str,
65
- system_prompt: str = "",
66
- files_list: Optional[List["Files"]] = None,
67
- ) -> dict[str, Any]:
68
- """Calls the OpenAI API and returns the API response."""
69
-
70
- api_key = os.environ.get("ANTHROPIC_API_KEY")
71
- client = AsyncAnthropic(api_key=api_key)
72
-
73
- response = await client.messages.create(
74
- model=model_name,
75
- max_tokens=self.max_tokens,
76
- temperature=self.temperature,
77
- system=system_prompt,
78
- messages=[
79
- # {"role": "system", "content": system_prompt},
80
- {"role": "user", "content": user_prompt},
81
- ],
82
- )
83
- return response.model_dump()
84
-
85
- LLM.__name__ = model_class_name
86
-
87
- return LLM
1
+ import os
2
+ from typing import Any, Optional, List
3
+ import re
4
+ from anthropic import AsyncAnthropic
5
+ from edsl.inference_services.InferenceServiceABC import InferenceServiceABC
6
+ from edsl.language_models.LanguageModel import LanguageModel
7
+
8
+
9
+ class AnthropicService(InferenceServiceABC):
10
+ """Anthropic service class."""
11
+
12
+ _inference_service_ = "anthropic"
13
+ _env_key_name_ = "ANTHROPIC_API_KEY"
14
+ key_sequence = ["content", 0, "text"]
15
+ usage_sequence = ["usage"]
16
+ input_token_name = "input_tokens"
17
+ output_token_name = "output_tokens"
18
+ model_exclude_list = []
19
+
20
+ @classmethod
21
+ def get_model_list(cls, api_key: str = None):
22
+
23
+ import requests
24
+
25
+ if api_key is None:
26
+ api_key = os.environ.get("ANTHROPIC_API_KEY")
27
+ headers = {"x-api-key": api_key, "anthropic-version": "2023-06-01"}
28
+ response = requests.get("https://api.anthropic.com/v1/models", headers=headers)
29
+ model_names = [m["id"] for m in response.json()["data"]]
30
+ return model_names
31
+
32
+ @classmethod
33
+ def available(cls):
34
+ return cls.get_model_list()
35
+
36
+ @classmethod
37
+ def create_model(
38
+ cls, model_name: str = "claude-3-opus-20240229", model_class_name=None
39
+ ) -> LanguageModel:
40
+ if model_class_name is None:
41
+ model_class_name = cls.to_class_name(model_name)
42
+
43
+ class LLM(LanguageModel):
44
+ """
45
+ Child class of LanguageModel for interacting with OpenAI models
46
+ """
47
+
48
+ key_sequence = cls.key_sequence
49
+ usage_sequence = cls.usage_sequence
50
+ input_token_name = cls.input_token_name
51
+ output_token_name = cls.output_token_name
52
+
53
+ _inference_service_ = cls._inference_service_
54
+ _model_ = model_name
55
+ _parameters_ = {
56
+ "temperature": 0.5,
57
+ "max_tokens": 1000,
58
+ "top_p": 1,
59
+ "frequency_penalty": 0,
60
+ "presence_penalty": 0,
61
+ "logprobs": False,
62
+ "top_logprobs": 3,
63
+ }
64
+
65
+ async def async_execute_model_call(
66
+ self,
67
+ user_prompt: str,
68
+ system_prompt: str = "",
69
+ files_list: Optional[List["Files"]] = None,
70
+ ) -> dict[str, Any]:
71
+ """Calls the Anthropic API and returns the API response."""
72
+
73
+ messages = [
74
+ {
75
+ "role": "user",
76
+ "content": [{"type": "text", "text": user_prompt}],
77
+ }
78
+ ]
79
+ if files_list:
80
+ for file_entry in files_list:
81
+ encoded_image = file_entry.base64_string
82
+ messages[0]["content"].append(
83
+ {
84
+ "type": "image",
85
+ "source": {
86
+ "type": "base64",
87
+ "media_type": file_entry.mime_type,
88
+ "data": encoded_image,
89
+ },
90
+ }
91
+ )
92
+ # breakpoint()
93
+ client = AsyncAnthropic(api_key=self.api_token)
94
+
95
+ response = await client.messages.create(
96
+ model=model_name,
97
+ max_tokens=self.max_tokens,
98
+ temperature=self.temperature,
99
+ system=system_prompt, # note that the Anthropic API uses "system" parameter rather than put it in the message
100
+ messages=messages,
101
+ )
102
+ return response.model_dump()
103
+
104
+ LLM.__name__ = model_class_name
105
+
106
+ return LLM