edsl 0.1.39.dev3__py3-none-any.whl → 0.1.39.dev4__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 (344) 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/hack.py +10 -0
  48. edsl/data/orm.py +10 -10
  49. edsl/data_transfer_models.py +74 -73
  50. edsl/enums.py +202 -175
  51. edsl/exceptions/BaseException.py +21 -21
  52. edsl/exceptions/__init__.py +54 -54
  53. edsl/exceptions/agents.py +54 -42
  54. edsl/exceptions/cache.py +5 -5
  55. edsl/exceptions/configuration.py +16 -16
  56. edsl/exceptions/coop.py +10 -10
  57. edsl/exceptions/data.py +14 -14
  58. edsl/exceptions/general.py +34 -34
  59. edsl/exceptions/inference_services.py +5 -0
  60. edsl/exceptions/jobs.py +33 -33
  61. edsl/exceptions/language_models.py +63 -63
  62. edsl/exceptions/prompts.py +15 -15
  63. edsl/exceptions/questions.py +109 -91
  64. edsl/exceptions/results.py +29 -29
  65. edsl/exceptions/scenarios.py +29 -22
  66. edsl/exceptions/surveys.py +37 -37
  67. edsl/inference_services/AnthropicService.py +106 -87
  68. edsl/inference_services/AvailableModelCacheHandler.py +184 -0
  69. edsl/inference_services/AvailableModelFetcher.py +215 -0
  70. edsl/inference_services/AwsBedrock.py +118 -120
  71. edsl/inference_services/AzureAI.py +215 -217
  72. edsl/inference_services/DeepInfraService.py +18 -18
  73. edsl/inference_services/GoogleService.py +143 -148
  74. edsl/inference_services/GroqService.py +20 -20
  75. edsl/inference_services/InferenceServiceABC.py +80 -147
  76. edsl/inference_services/InferenceServicesCollection.py +138 -97
  77. edsl/inference_services/MistralAIService.py +120 -123
  78. edsl/inference_services/OllamaService.py +18 -18
  79. edsl/inference_services/OpenAIService.py +236 -224
  80. edsl/inference_services/PerplexityService.py +160 -163
  81. edsl/inference_services/ServiceAvailability.py +135 -0
  82. edsl/inference_services/TestService.py +90 -89
  83. edsl/inference_services/TogetherAIService.py +172 -170
  84. edsl/inference_services/data_structures.py +134 -0
  85. edsl/inference_services/models_available_cache.py +118 -118
  86. edsl/inference_services/rate_limits_cache.py +25 -25
  87. edsl/inference_services/registry.py +41 -41
  88. edsl/inference_services/write_available.py +10 -10
  89. edsl/jobs/AnswerQuestionFunctionConstructor.py +223 -0
  90. edsl/jobs/Answers.py +43 -56
  91. edsl/jobs/FetchInvigilator.py +47 -0
  92. edsl/jobs/InterviewTaskManager.py +98 -0
  93. edsl/jobs/InterviewsConstructor.py +50 -0
  94. edsl/jobs/Jobs.py +823 -898
  95. edsl/jobs/JobsChecks.py +172 -147
  96. edsl/jobs/JobsComponentConstructor.py +189 -0
  97. edsl/jobs/JobsPrompts.py +270 -268
  98. edsl/jobs/JobsRemoteInferenceHandler.py +311 -239
  99. edsl/jobs/JobsRemoteInferenceLogger.py +239 -0
  100. edsl/jobs/RequestTokenEstimator.py +30 -0
  101. edsl/jobs/__init__.py +1 -1
  102. edsl/jobs/async_interview_runner.py +138 -0
  103. edsl/jobs/buckets/BucketCollection.py +104 -63
  104. edsl/jobs/buckets/ModelBuckets.py +65 -65
  105. edsl/jobs/buckets/TokenBucket.py +283 -251
  106. edsl/jobs/buckets/TokenBucketAPI.py +211 -0
  107. edsl/jobs/buckets/TokenBucketClient.py +191 -0
  108. edsl/jobs/check_survey_scenario_compatibility.py +85 -0
  109. edsl/jobs/data_structures.py +120 -0
  110. edsl/jobs/decorators.py +35 -0
  111. edsl/jobs/interviews/Interview.py +396 -661
  112. edsl/jobs/interviews/InterviewExceptionCollection.py +99 -99
  113. edsl/jobs/interviews/InterviewExceptionEntry.py +186 -186
  114. edsl/jobs/interviews/InterviewStatistic.py +63 -63
  115. edsl/jobs/interviews/InterviewStatisticsCollection.py +25 -25
  116. edsl/jobs/interviews/InterviewStatusDictionary.py +78 -78
  117. edsl/jobs/interviews/InterviewStatusLog.py +92 -92
  118. edsl/jobs/interviews/ReportErrors.py +66 -66
  119. edsl/jobs/interviews/interview_status_enum.py +9 -9
  120. edsl/jobs/jobs_status_enums.py +9 -0
  121. edsl/jobs/loggers/HTMLTableJobLogger.py +304 -0
  122. edsl/jobs/results_exceptions_handler.py +98 -0
  123. edsl/jobs/runners/JobsRunnerAsyncio.py +151 -466
  124. edsl/jobs/runners/JobsRunnerStatus.py +297 -330
  125. edsl/jobs/tasks/QuestionTaskCreator.py +244 -242
  126. edsl/jobs/tasks/TaskCreators.py +64 -64
  127. edsl/jobs/tasks/TaskHistory.py +470 -450
  128. edsl/jobs/tasks/TaskStatusLog.py +23 -23
  129. edsl/jobs/tasks/task_status_enum.py +161 -163
  130. edsl/jobs/tokens/InterviewTokenUsage.py +27 -27
  131. edsl/jobs/tokens/TokenUsage.py +34 -34
  132. edsl/language_models/ComputeCost.py +63 -0
  133. edsl/language_models/LanguageModel.py +626 -668
  134. edsl/language_models/ModelList.py +164 -155
  135. edsl/language_models/PriceManager.py +127 -0
  136. edsl/language_models/RawResponseHandler.py +106 -0
  137. edsl/language_models/RegisterLanguageModelsMeta.py +184 -184
  138. edsl/language_models/ServiceDataSources.py +0 -0
  139. edsl/language_models/__init__.py +2 -3
  140. edsl/language_models/fake_openai_call.py +15 -15
  141. edsl/language_models/fake_openai_service.py +61 -61
  142. edsl/language_models/key_management/KeyLookup.py +63 -0
  143. edsl/language_models/key_management/KeyLookupBuilder.py +273 -0
  144. edsl/language_models/key_management/KeyLookupCollection.py +38 -0
  145. edsl/language_models/key_management/__init__.py +0 -0
  146. edsl/language_models/key_management/models.py +131 -0
  147. edsl/language_models/model.py +256 -0
  148. edsl/language_models/repair.py +156 -156
  149. edsl/language_models/utilities.py +65 -64
  150. edsl/notebooks/Notebook.py +263 -258
  151. edsl/notebooks/NotebookToLaTeX.py +142 -0
  152. edsl/notebooks/__init__.py +1 -1
  153. edsl/prompts/Prompt.py +352 -362
  154. edsl/prompts/__init__.py +2 -2
  155. edsl/questions/ExceptionExplainer.py +77 -0
  156. edsl/questions/HTMLQuestion.py +103 -0
  157. edsl/questions/QuestionBase.py +518 -664
  158. edsl/questions/QuestionBasePromptsMixin.py +221 -217
  159. edsl/questions/QuestionBudget.py +227 -227
  160. edsl/questions/QuestionCheckBox.py +359 -359
  161. edsl/questions/QuestionExtract.py +180 -182
  162. edsl/questions/QuestionFreeText.py +113 -114
  163. edsl/questions/QuestionFunctional.py +166 -166
  164. edsl/questions/QuestionList.py +223 -231
  165. edsl/questions/QuestionMatrix.py +265 -0
  166. edsl/questions/QuestionMultipleChoice.py +330 -286
  167. edsl/questions/QuestionNumerical.py +151 -153
  168. edsl/questions/QuestionRank.py +314 -324
  169. edsl/questions/Quick.py +41 -41
  170. edsl/questions/SimpleAskMixin.py +74 -73
  171. edsl/questions/__init__.py +27 -26
  172. edsl/questions/{AnswerValidatorMixin.py → answer_validator_mixin.py} +334 -289
  173. edsl/questions/compose_questions.py +98 -98
  174. edsl/questions/data_structures.py +20 -0
  175. edsl/questions/decorators.py +21 -21
  176. edsl/questions/derived/QuestionLikertFive.py +76 -76
  177. edsl/questions/derived/QuestionLinearScale.py +90 -87
  178. edsl/questions/derived/QuestionTopK.py +93 -93
  179. edsl/questions/derived/QuestionYesNo.py +82 -82
  180. edsl/questions/descriptors.py +427 -413
  181. edsl/questions/loop_processor.py +149 -0
  182. edsl/questions/prompt_templates/question_budget.jinja +13 -13
  183. edsl/questions/prompt_templates/question_checkbox.jinja +32 -32
  184. edsl/questions/prompt_templates/question_extract.jinja +11 -11
  185. edsl/questions/prompt_templates/question_free_text.jinja +3 -3
  186. edsl/questions/prompt_templates/question_linear_scale.jinja +11 -11
  187. edsl/questions/prompt_templates/question_list.jinja +17 -17
  188. edsl/questions/prompt_templates/question_multiple_choice.jinja +33 -33
  189. edsl/questions/prompt_templates/question_numerical.jinja +36 -36
  190. edsl/questions/{QuestionBaseGenMixin.py → question_base_gen_mixin.py} +168 -161
  191. edsl/questions/question_registry.py +177 -177
  192. edsl/questions/{RegisterQuestionsMeta.py → register_questions_meta.py} +71 -71
  193. edsl/questions/{ResponseValidatorABC.py → response_validator_abc.py} +188 -174
  194. edsl/questions/response_validator_factory.py +34 -0
  195. edsl/questions/settings.py +12 -12
  196. edsl/questions/templates/budget/answering_instructions.jinja +7 -7
  197. edsl/questions/templates/budget/question_presentation.jinja +7 -7
  198. edsl/questions/templates/checkbox/answering_instructions.jinja +10 -10
  199. edsl/questions/templates/checkbox/question_presentation.jinja +22 -22
  200. edsl/questions/templates/extract/answering_instructions.jinja +7 -7
  201. edsl/questions/templates/likert_five/answering_instructions.jinja +10 -10
  202. edsl/questions/templates/likert_five/question_presentation.jinja +11 -11
  203. edsl/questions/templates/linear_scale/answering_instructions.jinja +5 -5
  204. edsl/questions/templates/linear_scale/question_presentation.jinja +5 -5
  205. edsl/questions/templates/list/answering_instructions.jinja +3 -3
  206. edsl/questions/templates/list/question_presentation.jinja +5 -5
  207. edsl/questions/templates/matrix/__init__.py +1 -0
  208. edsl/questions/templates/matrix/answering_instructions.jinja +5 -0
  209. edsl/questions/templates/matrix/question_presentation.jinja +20 -0
  210. edsl/questions/templates/multiple_choice/answering_instructions.jinja +9 -9
  211. edsl/questions/templates/multiple_choice/question_presentation.jinja +11 -11
  212. edsl/questions/templates/numerical/answering_instructions.jinja +6 -6
  213. edsl/questions/templates/numerical/question_presentation.jinja +6 -6
  214. edsl/questions/templates/rank/answering_instructions.jinja +11 -11
  215. edsl/questions/templates/rank/question_presentation.jinja +15 -15
  216. edsl/questions/templates/top_k/answering_instructions.jinja +8 -8
  217. edsl/questions/templates/top_k/question_presentation.jinja +22 -22
  218. edsl/questions/templates/yes_no/answering_instructions.jinja +6 -6
  219. edsl/questions/templates/yes_no/question_presentation.jinja +11 -11
  220. edsl/results/CSSParameterizer.py +108 -108
  221. edsl/results/Dataset.py +587 -424
  222. edsl/results/DatasetExportMixin.py +594 -731
  223. edsl/results/DatasetTree.py +295 -275
  224. edsl/results/MarkdownToDocx.py +122 -0
  225. edsl/results/MarkdownToPDF.py +111 -0
  226. edsl/results/Result.py +557 -465
  227. edsl/results/Results.py +1183 -1165
  228. edsl/results/ResultsExportMixin.py +45 -43
  229. edsl/results/ResultsGGMixin.py +121 -121
  230. edsl/results/TableDisplay.py +125 -198
  231. edsl/results/TextEditor.py +50 -0
  232. edsl/results/__init__.py +2 -2
  233. edsl/results/file_exports.py +252 -0
  234. edsl/results/{ResultsFetchMixin.py → results_fetch_mixin.py} +33 -33
  235. edsl/results/{Selector.py → results_selector.py} +145 -135
  236. edsl/results/{ResultsToolsMixin.py → results_tools_mixin.py} +98 -98
  237. edsl/results/smart_objects.py +96 -0
  238. edsl/results/table_data_class.py +12 -0
  239. edsl/results/table_display.css +77 -77
  240. edsl/results/table_renderers.py +118 -0
  241. edsl/results/tree_explore.py +115 -115
  242. edsl/scenarios/ConstructDownloadLink.py +109 -0
  243. edsl/scenarios/DocumentChunker.py +102 -0
  244. edsl/scenarios/DocxScenario.py +16 -0
  245. edsl/scenarios/FileStore.py +511 -632
  246. edsl/scenarios/PdfExtractor.py +40 -0
  247. edsl/scenarios/Scenario.py +498 -601
  248. edsl/scenarios/ScenarioHtmlMixin.py +65 -64
  249. edsl/scenarios/ScenarioList.py +1458 -1287
  250. edsl/scenarios/ScenarioListExportMixin.py +45 -52
  251. edsl/scenarios/ScenarioListPdfMixin.py +239 -261
  252. edsl/scenarios/__init__.py +3 -4
  253. edsl/scenarios/directory_scanner.py +96 -0
  254. edsl/scenarios/file_methods.py +85 -0
  255. edsl/scenarios/handlers/__init__.py +13 -0
  256. edsl/scenarios/handlers/csv.py +38 -0
  257. edsl/scenarios/handlers/docx.py +76 -0
  258. edsl/scenarios/handlers/html.py +37 -0
  259. edsl/scenarios/handlers/json.py +111 -0
  260. edsl/scenarios/handlers/latex.py +5 -0
  261. edsl/scenarios/handlers/md.py +51 -0
  262. edsl/scenarios/handlers/pdf.py +68 -0
  263. edsl/scenarios/handlers/png.py +39 -0
  264. edsl/scenarios/handlers/pptx.py +105 -0
  265. edsl/scenarios/handlers/py.py +294 -0
  266. edsl/scenarios/handlers/sql.py +313 -0
  267. edsl/scenarios/handlers/sqlite.py +149 -0
  268. edsl/scenarios/handlers/txt.py +33 -0
  269. edsl/scenarios/{ScenarioJoin.py → scenario_join.py} +131 -127
  270. edsl/scenarios/scenario_selector.py +156 -0
  271. edsl/shared.py +1 -1
  272. edsl/study/ObjectEntry.py +173 -173
  273. edsl/study/ProofOfWork.py +113 -113
  274. edsl/study/SnapShot.py +80 -80
  275. edsl/study/Study.py +521 -528
  276. edsl/study/__init__.py +4 -4
  277. edsl/surveys/ConstructDAG.py +92 -0
  278. edsl/surveys/DAG.py +148 -148
  279. edsl/surveys/EditSurvey.py +221 -0
  280. edsl/surveys/InstructionHandler.py +100 -0
  281. edsl/surveys/Memory.py +31 -31
  282. edsl/surveys/MemoryManagement.py +72 -0
  283. edsl/surveys/MemoryPlan.py +244 -244
  284. edsl/surveys/Rule.py +327 -326
  285. edsl/surveys/RuleCollection.py +385 -387
  286. edsl/surveys/RuleManager.py +172 -0
  287. edsl/surveys/Simulator.py +75 -0
  288. edsl/surveys/Survey.py +1280 -1801
  289. edsl/surveys/SurveyCSS.py +273 -261
  290. edsl/surveys/SurveyExportMixin.py +259 -259
  291. edsl/surveys/{SurveyFlowVisualizationMixin.py → SurveyFlowVisualization.py} +181 -179
  292. edsl/surveys/SurveyQualtricsImport.py +284 -284
  293. edsl/surveys/SurveyToApp.py +141 -0
  294. edsl/surveys/__init__.py +5 -3
  295. edsl/surveys/base.py +53 -53
  296. edsl/surveys/descriptors.py +60 -56
  297. edsl/surveys/instructions/ChangeInstruction.py +48 -49
  298. edsl/surveys/instructions/Instruction.py +56 -65
  299. edsl/surveys/instructions/InstructionCollection.py +82 -77
  300. edsl/templates/error_reporting/base.html +23 -23
  301. edsl/templates/error_reporting/exceptions_by_model.html +34 -34
  302. edsl/templates/error_reporting/exceptions_by_question_name.html +16 -16
  303. edsl/templates/error_reporting/exceptions_by_type.html +16 -16
  304. edsl/templates/error_reporting/interview_details.html +115 -115
  305. edsl/templates/error_reporting/interviews.html +19 -19
  306. edsl/templates/error_reporting/overview.html +4 -4
  307. edsl/templates/error_reporting/performance_plot.html +1 -1
  308. edsl/templates/error_reporting/report.css +73 -73
  309. edsl/templates/error_reporting/report.html +117 -117
  310. edsl/templates/error_reporting/report.js +25 -25
  311. edsl/test_h +1 -0
  312. edsl/tools/__init__.py +1 -1
  313. edsl/tools/clusters.py +192 -192
  314. edsl/tools/embeddings.py +27 -27
  315. edsl/tools/embeddings_plotting.py +118 -118
  316. edsl/tools/plotting.py +112 -112
  317. edsl/tools/summarize.py +18 -18
  318. edsl/utilities/PrettyList.py +56 -0
  319. edsl/utilities/SystemInfo.py +28 -28
  320. edsl/utilities/__init__.py +22 -22
  321. edsl/utilities/ast_utilities.py +25 -25
  322. edsl/utilities/data/Registry.py +6 -6
  323. edsl/utilities/data/__init__.py +1 -1
  324. edsl/utilities/data/scooter_results.json +1 -1
  325. edsl/utilities/decorators.py +77 -77
  326. edsl/utilities/gcp_bucket/cloud_storage.py +96 -96
  327. edsl/utilities/gcp_bucket/example.py +50 -0
  328. edsl/utilities/interface.py +627 -627
  329. edsl/utilities/is_notebook.py +18 -0
  330. edsl/utilities/is_valid_variable_name.py +11 -0
  331. edsl/utilities/naming_utilities.py +263 -263
  332. edsl/utilities/remove_edsl_version.py +24 -0
  333. edsl/utilities/repair_functions.py +28 -28
  334. edsl/utilities/restricted_python.py +70 -70
  335. edsl/utilities/utilities.py +436 -424
  336. {edsl-0.1.39.dev3.dist-info → edsl-0.1.39.dev4.dist-info}/LICENSE +21 -21
  337. {edsl-0.1.39.dev3.dist-info → edsl-0.1.39.dev4.dist-info}/METADATA +13 -11
  338. edsl-0.1.39.dev4.dist-info/RECORD +361 -0
  339. edsl/language_models/KeyLookup.py +0 -30
  340. edsl/language_models/registry.py +0 -190
  341. edsl/language_models/unused/ReplicateBase.py +0 -83
  342. edsl/results/ResultsDBMixin.py +0 -238
  343. edsl-0.1.39.dev3.dist-info/RECORD +0 -277
  344. {edsl-0.1.39.dev3.dist-info → edsl-0.1.39.dev4.dist-info}/WHEEL +0 -0
@@ -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