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.
- edsl/Base.py +413 -332
- edsl/BaseDiff.py +260 -260
- edsl/TemplateLoader.py +24 -24
- edsl/__init__.py +57 -49
- edsl/__version__.py +1 -1
- edsl/agents/Agent.py +1071 -867
- edsl/agents/AgentList.py +551 -413
- edsl/agents/Invigilator.py +284 -233
- edsl/agents/InvigilatorBase.py +257 -270
- edsl/agents/PromptConstructor.py +272 -354
- edsl/agents/QuestionInstructionPromptBuilder.py +128 -0
- edsl/agents/QuestionTemplateReplacementsBuilder.py +137 -0
- edsl/agents/__init__.py +2 -3
- edsl/agents/descriptors.py +99 -99
- edsl/agents/prompt_helpers.py +129 -129
- edsl/agents/question_option_processor.py +172 -0
- edsl/auto/AutoStudy.py +130 -117
- edsl/auto/StageBase.py +243 -230
- edsl/auto/StageGenerateSurvey.py +178 -178
- edsl/auto/StageLabelQuestions.py +125 -125
- edsl/auto/StagePersona.py +61 -61
- edsl/auto/StagePersonaDimensionValueRanges.py +88 -88
- edsl/auto/StagePersonaDimensionValues.py +74 -74
- edsl/auto/StagePersonaDimensions.py +69 -69
- edsl/auto/StageQuestions.py +74 -73
- edsl/auto/SurveyCreatorPipeline.py +21 -21
- edsl/auto/utilities.py +218 -224
- edsl/base/Base.py +279 -279
- edsl/config.py +177 -157
- edsl/conversation/Conversation.py +290 -290
- edsl/conversation/car_buying.py +59 -58
- edsl/conversation/chips.py +95 -95
- edsl/conversation/mug_negotiation.py +81 -81
- edsl/conversation/next_speaker_utilities.py +93 -93
- edsl/coop/CoopFunctionsMixin.py +15 -0
- edsl/coop/ExpectedParrotKeyHandler.py +125 -0
- edsl/coop/PriceFetcher.py +54 -54
- edsl/coop/__init__.py +2 -2
- edsl/coop/coop.py +1106 -1028
- edsl/coop/utils.py +131 -131
- edsl/data/Cache.py +573 -555
- edsl/data/CacheEntry.py +230 -233
- edsl/data/CacheHandler.py +168 -149
- edsl/data/RemoteCacheSync.py +186 -78
- edsl/data/SQLiteDict.py +292 -292
- edsl/data/__init__.py +5 -4
- edsl/data/orm.py +10 -10
- edsl/data_transfer_models.py +74 -73
- edsl/enums.py +202 -175
- edsl/exceptions/BaseException.py +21 -21
- edsl/exceptions/__init__.py +54 -54
- edsl/exceptions/agents.py +54 -42
- edsl/exceptions/cache.py +5 -5
- edsl/exceptions/configuration.py +16 -16
- edsl/exceptions/coop.py +10 -10
- edsl/exceptions/data.py +14 -14
- edsl/exceptions/general.py +34 -34
- edsl/exceptions/inference_services.py +5 -0
- edsl/exceptions/jobs.py +33 -33
- edsl/exceptions/language_models.py +63 -63
- edsl/exceptions/prompts.py +15 -15
- edsl/exceptions/questions.py +109 -91
- edsl/exceptions/results.py +29 -29
- edsl/exceptions/scenarios.py +29 -22
- edsl/exceptions/surveys.py +37 -37
- edsl/inference_services/AnthropicService.py +106 -87
- edsl/inference_services/AvailableModelCacheHandler.py +184 -0
- edsl/inference_services/AvailableModelFetcher.py +215 -0
- edsl/inference_services/AwsBedrock.py +118 -120
- edsl/inference_services/AzureAI.py +215 -217
- edsl/inference_services/DeepInfraService.py +18 -18
- edsl/inference_services/GoogleService.py +143 -148
- edsl/inference_services/GroqService.py +20 -20
- edsl/inference_services/InferenceServiceABC.py +80 -147
- edsl/inference_services/InferenceServicesCollection.py +138 -97
- edsl/inference_services/MistralAIService.py +120 -123
- edsl/inference_services/OllamaService.py +18 -18
- edsl/inference_services/OpenAIService.py +236 -224
- edsl/inference_services/PerplexityService.py +160 -163
- edsl/inference_services/ServiceAvailability.py +135 -0
- edsl/inference_services/TestService.py +90 -89
- edsl/inference_services/TogetherAIService.py +172 -170
- edsl/inference_services/data_structures.py +134 -0
- edsl/inference_services/models_available_cache.py +118 -118
- edsl/inference_services/rate_limits_cache.py +25 -25
- edsl/inference_services/registry.py +41 -41
- edsl/inference_services/write_available.py +10 -10
- edsl/jobs/AnswerQuestionFunctionConstructor.py +223 -0
- edsl/jobs/Answers.py +43 -56
- edsl/jobs/FetchInvigilator.py +47 -0
- edsl/jobs/InterviewTaskManager.py +98 -0
- edsl/jobs/InterviewsConstructor.py +50 -0
- edsl/jobs/Jobs.py +823 -898
- edsl/jobs/JobsChecks.py +172 -147
- edsl/jobs/JobsComponentConstructor.py +189 -0
- edsl/jobs/JobsPrompts.py +270 -268
- edsl/jobs/JobsRemoteInferenceHandler.py +311 -239
- edsl/jobs/JobsRemoteInferenceLogger.py +239 -0
- edsl/jobs/RequestTokenEstimator.py +30 -0
- edsl/jobs/__init__.py +1 -1
- edsl/jobs/async_interview_runner.py +138 -0
- edsl/jobs/buckets/BucketCollection.py +104 -63
- edsl/jobs/buckets/ModelBuckets.py +65 -65
- edsl/jobs/buckets/TokenBucket.py +283 -251
- edsl/jobs/buckets/TokenBucketAPI.py +211 -0
- edsl/jobs/buckets/TokenBucketClient.py +191 -0
- edsl/jobs/check_survey_scenario_compatibility.py +85 -0
- edsl/jobs/data_structures.py +120 -0
- edsl/jobs/decorators.py +35 -0
- edsl/jobs/interviews/Interview.py +396 -661
- edsl/jobs/interviews/InterviewExceptionCollection.py +99 -99
- edsl/jobs/interviews/InterviewExceptionEntry.py +186 -186
- edsl/jobs/interviews/InterviewStatistic.py +63 -63
- edsl/jobs/interviews/InterviewStatisticsCollection.py +25 -25
- edsl/jobs/interviews/InterviewStatusDictionary.py +78 -78
- edsl/jobs/interviews/InterviewStatusLog.py +92 -92
- edsl/jobs/interviews/ReportErrors.py +66 -66
- edsl/jobs/interviews/interview_status_enum.py +9 -9
- edsl/jobs/jobs_status_enums.py +9 -0
- edsl/jobs/loggers/HTMLTableJobLogger.py +304 -0
- edsl/jobs/results_exceptions_handler.py +98 -0
- edsl/jobs/runners/JobsRunnerAsyncio.py +151 -466
- edsl/jobs/runners/JobsRunnerStatus.py +297 -330
- edsl/jobs/tasks/QuestionTaskCreator.py +244 -242
- edsl/jobs/tasks/TaskCreators.py +64 -64
- edsl/jobs/tasks/TaskHistory.py +470 -450
- edsl/jobs/tasks/TaskStatusLog.py +23 -23
- edsl/jobs/tasks/task_status_enum.py +161 -163
- edsl/jobs/tokens/InterviewTokenUsage.py +27 -27
- edsl/jobs/tokens/TokenUsage.py +34 -34
- edsl/language_models/ComputeCost.py +63 -0
- edsl/language_models/LanguageModel.py +626 -668
- edsl/language_models/ModelList.py +164 -155
- edsl/language_models/PriceManager.py +127 -0
- edsl/language_models/RawResponseHandler.py +106 -0
- edsl/language_models/RegisterLanguageModelsMeta.py +184 -184
- edsl/language_models/ServiceDataSources.py +0 -0
- edsl/language_models/__init__.py +2 -3
- edsl/language_models/fake_openai_call.py +15 -15
- edsl/language_models/fake_openai_service.py +61 -61
- edsl/language_models/key_management/KeyLookup.py +63 -0
- edsl/language_models/key_management/KeyLookupBuilder.py +273 -0
- edsl/language_models/key_management/KeyLookupCollection.py +38 -0
- edsl/language_models/key_management/__init__.py +0 -0
- edsl/language_models/key_management/models.py +131 -0
- edsl/language_models/model.py +256 -0
- edsl/language_models/repair.py +156 -156
- edsl/language_models/utilities.py +65 -64
- edsl/notebooks/Notebook.py +263 -258
- edsl/notebooks/NotebookToLaTeX.py +142 -0
- edsl/notebooks/__init__.py +1 -1
- edsl/prompts/Prompt.py +352 -362
- edsl/prompts/__init__.py +2 -2
- edsl/questions/ExceptionExplainer.py +77 -0
- edsl/questions/HTMLQuestion.py +103 -0
- edsl/questions/QuestionBase.py +518 -664
- edsl/questions/QuestionBasePromptsMixin.py +221 -217
- edsl/questions/QuestionBudget.py +227 -227
- edsl/questions/QuestionCheckBox.py +359 -359
- edsl/questions/QuestionExtract.py +180 -182
- edsl/questions/QuestionFreeText.py +113 -114
- edsl/questions/QuestionFunctional.py +166 -166
- edsl/questions/QuestionList.py +223 -231
- edsl/questions/QuestionMatrix.py +265 -0
- edsl/questions/QuestionMultipleChoice.py +330 -286
- edsl/questions/QuestionNumerical.py +151 -153
- edsl/questions/QuestionRank.py +314 -324
- edsl/questions/Quick.py +41 -41
- edsl/questions/SimpleAskMixin.py +74 -73
- edsl/questions/__init__.py +27 -26
- edsl/questions/{AnswerValidatorMixin.py → answer_validator_mixin.py} +334 -289
- edsl/questions/compose_questions.py +98 -98
- edsl/questions/data_structures.py +20 -0
- edsl/questions/decorators.py +21 -21
- edsl/questions/derived/QuestionLikertFive.py +76 -76
- edsl/questions/derived/QuestionLinearScale.py +90 -87
- edsl/questions/derived/QuestionTopK.py +93 -93
- edsl/questions/derived/QuestionYesNo.py +82 -82
- edsl/questions/descriptors.py +427 -413
- edsl/questions/loop_processor.py +149 -0
- edsl/questions/prompt_templates/question_budget.jinja +13 -13
- edsl/questions/prompt_templates/question_checkbox.jinja +32 -32
- edsl/questions/prompt_templates/question_extract.jinja +11 -11
- edsl/questions/prompt_templates/question_free_text.jinja +3 -3
- edsl/questions/prompt_templates/question_linear_scale.jinja +11 -11
- edsl/questions/prompt_templates/question_list.jinja +17 -17
- edsl/questions/prompt_templates/question_multiple_choice.jinja +33 -33
- edsl/questions/prompt_templates/question_numerical.jinja +36 -36
- edsl/questions/{QuestionBaseGenMixin.py → question_base_gen_mixin.py} +168 -161
- edsl/questions/question_registry.py +177 -177
- edsl/questions/{RegisterQuestionsMeta.py → register_questions_meta.py} +71 -71
- edsl/questions/{ResponseValidatorABC.py → response_validator_abc.py} +188 -174
- edsl/questions/response_validator_factory.py +34 -0
- edsl/questions/settings.py +12 -12
- edsl/questions/templates/budget/answering_instructions.jinja +7 -7
- edsl/questions/templates/budget/question_presentation.jinja +7 -7
- edsl/questions/templates/checkbox/answering_instructions.jinja +10 -10
- edsl/questions/templates/checkbox/question_presentation.jinja +22 -22
- edsl/questions/templates/extract/answering_instructions.jinja +7 -7
- edsl/questions/templates/likert_five/answering_instructions.jinja +10 -10
- edsl/questions/templates/likert_five/question_presentation.jinja +11 -11
- edsl/questions/templates/linear_scale/answering_instructions.jinja +5 -5
- edsl/questions/templates/linear_scale/question_presentation.jinja +5 -5
- edsl/questions/templates/list/answering_instructions.jinja +3 -3
- edsl/questions/templates/list/question_presentation.jinja +5 -5
- edsl/questions/templates/matrix/__init__.py +1 -0
- edsl/questions/templates/matrix/answering_instructions.jinja +5 -0
- edsl/questions/templates/matrix/question_presentation.jinja +20 -0
- edsl/questions/templates/multiple_choice/answering_instructions.jinja +9 -9
- edsl/questions/templates/multiple_choice/question_presentation.jinja +11 -11
- edsl/questions/templates/numerical/answering_instructions.jinja +6 -6
- edsl/questions/templates/numerical/question_presentation.jinja +6 -6
- edsl/questions/templates/rank/answering_instructions.jinja +11 -11
- edsl/questions/templates/rank/question_presentation.jinja +15 -15
- edsl/questions/templates/top_k/answering_instructions.jinja +8 -8
- edsl/questions/templates/top_k/question_presentation.jinja +22 -22
- edsl/questions/templates/yes_no/answering_instructions.jinja +6 -6
- edsl/questions/templates/yes_no/question_presentation.jinja +11 -11
- edsl/results/CSSParameterizer.py +108 -108
- edsl/results/Dataset.py +587 -424
- edsl/results/DatasetExportMixin.py +594 -731
- edsl/results/DatasetTree.py +295 -275
- edsl/results/MarkdownToDocx.py +122 -0
- edsl/results/MarkdownToPDF.py +111 -0
- edsl/results/Result.py +557 -465
- edsl/results/Results.py +1183 -1165
- edsl/results/ResultsExportMixin.py +45 -43
- edsl/results/ResultsGGMixin.py +121 -121
- edsl/results/TableDisplay.py +125 -198
- edsl/results/TextEditor.py +50 -0
- edsl/results/__init__.py +2 -2
- edsl/results/file_exports.py +252 -0
- edsl/results/{ResultsFetchMixin.py → results_fetch_mixin.py} +33 -33
- edsl/results/{Selector.py → results_selector.py} +145 -135
- edsl/results/{ResultsToolsMixin.py → results_tools_mixin.py} +98 -98
- edsl/results/smart_objects.py +96 -0
- edsl/results/table_data_class.py +12 -0
- edsl/results/table_display.css +77 -77
- edsl/results/table_renderers.py +118 -0
- edsl/results/tree_explore.py +115 -115
- edsl/scenarios/ConstructDownloadLink.py +109 -0
- edsl/scenarios/DocumentChunker.py +102 -0
- edsl/scenarios/DocxScenario.py +16 -0
- edsl/scenarios/FileStore.py +511 -632
- edsl/scenarios/PdfExtractor.py +40 -0
- edsl/scenarios/Scenario.py +498 -601
- edsl/scenarios/ScenarioHtmlMixin.py +65 -64
- edsl/scenarios/ScenarioList.py +1458 -1287
- edsl/scenarios/ScenarioListExportMixin.py +45 -52
- edsl/scenarios/ScenarioListPdfMixin.py +239 -261
- edsl/scenarios/__init__.py +3 -4
- edsl/scenarios/directory_scanner.py +96 -0
- edsl/scenarios/file_methods.py +85 -0
- edsl/scenarios/handlers/__init__.py +13 -0
- edsl/scenarios/handlers/csv.py +38 -0
- edsl/scenarios/handlers/docx.py +76 -0
- edsl/scenarios/handlers/html.py +37 -0
- edsl/scenarios/handlers/json.py +111 -0
- edsl/scenarios/handlers/latex.py +5 -0
- edsl/scenarios/handlers/md.py +51 -0
- edsl/scenarios/handlers/pdf.py +68 -0
- edsl/scenarios/handlers/png.py +39 -0
- edsl/scenarios/handlers/pptx.py +105 -0
- edsl/scenarios/handlers/py.py +294 -0
- edsl/scenarios/handlers/sql.py +313 -0
- edsl/scenarios/handlers/sqlite.py +149 -0
- edsl/scenarios/handlers/txt.py +33 -0
- edsl/scenarios/{ScenarioJoin.py → scenario_join.py} +131 -127
- edsl/scenarios/scenario_selector.py +156 -0
- edsl/shared.py +1 -1
- edsl/study/ObjectEntry.py +173 -173
- edsl/study/ProofOfWork.py +113 -113
- edsl/study/SnapShot.py +80 -80
- edsl/study/Study.py +521 -528
- edsl/study/__init__.py +4 -4
- edsl/surveys/ConstructDAG.py +92 -0
- edsl/surveys/DAG.py +148 -148
- edsl/surveys/EditSurvey.py +221 -0
- edsl/surveys/InstructionHandler.py +100 -0
- edsl/surveys/Memory.py +31 -31
- edsl/surveys/MemoryManagement.py +72 -0
- edsl/surveys/MemoryPlan.py +244 -244
- edsl/surveys/Rule.py +327 -326
- edsl/surveys/RuleCollection.py +385 -387
- edsl/surveys/RuleManager.py +172 -0
- edsl/surveys/Simulator.py +75 -0
- edsl/surveys/Survey.py +1280 -1801
- edsl/surveys/SurveyCSS.py +273 -261
- edsl/surveys/SurveyExportMixin.py +259 -259
- edsl/surveys/{SurveyFlowVisualizationMixin.py → SurveyFlowVisualization.py} +181 -179
- edsl/surveys/SurveyQualtricsImport.py +284 -284
- edsl/surveys/SurveyToApp.py +141 -0
- edsl/surveys/__init__.py +5 -3
- edsl/surveys/base.py +53 -53
- edsl/surveys/descriptors.py +60 -56
- edsl/surveys/instructions/ChangeInstruction.py +48 -49
- edsl/surveys/instructions/Instruction.py +56 -65
- edsl/surveys/instructions/InstructionCollection.py +82 -77
- edsl/templates/error_reporting/base.html +23 -23
- edsl/templates/error_reporting/exceptions_by_model.html +34 -34
- edsl/templates/error_reporting/exceptions_by_question_name.html +16 -16
- edsl/templates/error_reporting/exceptions_by_type.html +16 -16
- edsl/templates/error_reporting/interview_details.html +115 -115
- edsl/templates/error_reporting/interviews.html +19 -19
- edsl/templates/error_reporting/overview.html +4 -4
- edsl/templates/error_reporting/performance_plot.html +1 -1
- edsl/templates/error_reporting/report.css +73 -73
- edsl/templates/error_reporting/report.html +117 -117
- edsl/templates/error_reporting/report.js +25 -25
- edsl/tools/__init__.py +1 -1
- edsl/tools/clusters.py +192 -192
- edsl/tools/embeddings.py +27 -27
- edsl/tools/embeddings_plotting.py +118 -118
- edsl/tools/plotting.py +112 -112
- edsl/tools/summarize.py +18 -18
- edsl/utilities/PrettyList.py +56 -0
- edsl/utilities/SystemInfo.py +28 -28
- edsl/utilities/__init__.py +22 -22
- edsl/utilities/ast_utilities.py +25 -25
- edsl/utilities/data/Registry.py +6 -6
- edsl/utilities/data/__init__.py +1 -1
- edsl/utilities/data/scooter_results.json +1 -1
- edsl/utilities/decorators.py +77 -77
- edsl/utilities/gcp_bucket/cloud_storage.py +96 -96
- edsl/utilities/interface.py +627 -627
- edsl/utilities/is_notebook.py +18 -0
- edsl/utilities/is_valid_variable_name.py +11 -0
- edsl/utilities/naming_utilities.py +263 -263
- edsl/utilities/remove_edsl_version.py +24 -0
- edsl/utilities/repair_functions.py +28 -28
- edsl/utilities/restricted_python.py +70 -70
- edsl/utilities/utilities.py +436 -424
- {edsl-0.1.39.dev3.dist-info → edsl-0.1.39.dev5.dist-info}/LICENSE +21 -21
- {edsl-0.1.39.dev3.dist-info → edsl-0.1.39.dev5.dist-info}/METADATA +13 -11
- edsl-0.1.39.dev5.dist-info/RECORD +358 -0
- {edsl-0.1.39.dev3.dist-info → edsl-0.1.39.dev5.dist-info}/WHEEL +1 -1
- edsl/language_models/KeyLookup.py +0 -30
- edsl/language_models/registry.py +0 -190
- edsl/language_models/unused/ReplicateBase.py +0 -83
- edsl/results/ResultsDBMixin.py +0 -238
- edsl-0.1.39.dev3.dist-info/RECORD +0 -277
edsl/jobs/JobsPrompts.py
CHANGED
@@ -1,268 +1,270 @@
|
|
1
|
-
from typing import List, TYPE_CHECKING
|
2
|
-
|
3
|
-
from edsl.results.Dataset import Dataset
|
4
|
-
|
5
|
-
if TYPE_CHECKING:
|
6
|
-
from edsl.jobs import Jobs
|
7
|
-
|
8
|
-
# from edsl.jobs.interviews.Interview import Interview
|
9
|
-
# from edsl.results.Dataset import Dataset
|
10
|
-
# from edsl.agents.AgentList import AgentList
|
11
|
-
# from edsl.scenarios.ScenarioList import ScenarioList
|
12
|
-
# from edsl.surveys.Survey import Survey
|
13
|
-
|
14
|
-
|
15
|
-
|
16
|
-
|
17
|
-
|
18
|
-
|
19
|
-
self.
|
20
|
-
self.
|
21
|
-
self.
|
22
|
-
|
23
|
-
|
24
|
-
|
25
|
-
|
26
|
-
|
27
|
-
|
28
|
-
|
29
|
-
|
30
|
-
|
31
|
-
|
32
|
-
|
33
|
-
|
34
|
-
|
35
|
-
|
36
|
-
|
37
|
-
|
38
|
-
|
39
|
-
|
40
|
-
|
41
|
-
|
42
|
-
|
43
|
-
|
44
|
-
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
|
54
|
-
|
55
|
-
|
56
|
-
|
57
|
-
|
58
|
-
|
59
|
-
|
60
|
-
|
61
|
-
|
62
|
-
|
63
|
-
|
64
|
-
|
65
|
-
|
66
|
-
|
67
|
-
|
68
|
-
|
69
|
-
|
70
|
-
|
71
|
-
|
72
|
-
|
73
|
-
|
74
|
-
|
75
|
-
|
76
|
-
|
77
|
-
|
78
|
-
|
79
|
-
|
80
|
-
|
81
|
-
{"
|
82
|
-
{"
|
83
|
-
{"
|
84
|
-
{"
|
85
|
-
{"
|
86
|
-
{"
|
87
|
-
|
88
|
-
|
89
|
-
|
90
|
-
|
91
|
-
|
92
|
-
|
93
|
-
|
94
|
-
|
95
|
-
|
96
|
-
|
97
|
-
|
98
|
-
|
99
|
-
|
100
|
-
|
101
|
-
|
102
|
-
|
103
|
-
|
104
|
-
|
105
|
-
|
106
|
-
|
107
|
-
|
108
|
-
|
109
|
-
|
110
|
-
|
111
|
-
|
112
|
-
|
113
|
-
|
114
|
-
|
115
|
-
|
116
|
-
|
117
|
-
|
118
|
-
|
119
|
-
|
120
|
-
|
121
|
-
|
122
|
-
|
123
|
-
|
124
|
-
|
125
|
-
|
126
|
-
|
127
|
-
|
128
|
-
|
129
|
-
|
130
|
-
|
131
|
-
|
132
|
-
|
133
|
-
|
134
|
-
|
135
|
-
|
136
|
-
|
137
|
-
|
138
|
-
|
139
|
-
warnings
|
140
|
-
|
141
|
-
|
142
|
-
|
143
|
-
|
144
|
-
|
145
|
-
|
146
|
-
|
147
|
-
|
148
|
-
)
|
149
|
-
|
150
|
-
|
151
|
-
)
|
152
|
-
|
153
|
-
|
154
|
-
|
155
|
-
|
156
|
-
|
157
|
-
|
158
|
-
|
159
|
-
|
160
|
-
|
161
|
-
|
162
|
-
|
163
|
-
|
164
|
-
|
165
|
-
|
166
|
-
"
|
167
|
-
|
168
|
-
|
169
|
-
|
170
|
-
|
171
|
-
|
172
|
-
|
173
|
-
|
174
|
-
|
175
|
-
|
176
|
-
|
177
|
-
|
178
|
-
|
179
|
-
|
180
|
-
|
181
|
-
|
182
|
-
|
183
|
-
|
184
|
-
|
185
|
-
|
186
|
-
|
187
|
-
|
188
|
-
|
189
|
-
|
190
|
-
|
191
|
-
|
192
|
-
|
193
|
-
|
194
|
-
|
195
|
-
|
196
|
-
|
197
|
-
|
198
|
-
|
199
|
-
|
200
|
-
|
201
|
-
|
202
|
-
|
203
|
-
|
204
|
-
|
205
|
-
|
206
|
-
|
207
|
-
|
208
|
-
|
209
|
-
|
210
|
-
|
211
|
-
"
|
212
|
-
"
|
213
|
-
"
|
214
|
-
"
|
215
|
-
"
|
216
|
-
|
217
|
-
|
218
|
-
|
219
|
-
|
220
|
-
|
221
|
-
df = (
|
222
|
-
|
223
|
-
|
224
|
-
|
225
|
-
|
226
|
-
|
227
|
-
"
|
228
|
-
|
229
|
-
|
230
|
-
|
231
|
-
|
232
|
-
|
233
|
-
|
234
|
-
df["
|
235
|
-
|
236
|
-
|
237
|
-
|
238
|
-
|
239
|
-
|
240
|
-
|
241
|
-
|
242
|
-
|
243
|
-
|
244
|
-
|
245
|
-
|
246
|
-
|
247
|
-
|
248
|
-
|
249
|
-
|
250
|
-
|
251
|
-
"
|
252
|
-
"
|
253
|
-
|
254
|
-
|
255
|
-
|
256
|
-
|
257
|
-
|
258
|
-
|
259
|
-
|
260
|
-
|
261
|
-
|
262
|
-
|
263
|
-
|
264
|
-
|
265
|
-
|
266
|
-
|
267
|
-
|
268
|
-
|
1
|
+
from typing import List, TYPE_CHECKING
|
2
|
+
|
3
|
+
from edsl.results.Dataset import Dataset
|
4
|
+
|
5
|
+
if TYPE_CHECKING:
|
6
|
+
from edsl.jobs import Jobs
|
7
|
+
|
8
|
+
# from edsl.jobs.interviews.Interview import Interview
|
9
|
+
# from edsl.results.Dataset import Dataset
|
10
|
+
# from edsl.agents.AgentList import AgentList
|
11
|
+
# from edsl.scenarios.ScenarioList import ScenarioList
|
12
|
+
# from edsl.surveys.Survey import Survey
|
13
|
+
|
14
|
+
from edsl.jobs.FetchInvigilator import FetchInvigilator
|
15
|
+
|
16
|
+
|
17
|
+
class JobsPrompts:
|
18
|
+
def __init__(self, jobs: "Jobs"):
|
19
|
+
self.interviews = jobs.interviews()
|
20
|
+
self.agents = jobs.agents
|
21
|
+
self.scenarios = jobs.scenarios
|
22
|
+
self.survey = jobs.survey
|
23
|
+
self._price_lookup = None
|
24
|
+
|
25
|
+
@property
|
26
|
+
def price_lookup(self):
|
27
|
+
if self._price_lookup is None:
|
28
|
+
from edsl.coop.coop import Coop
|
29
|
+
|
30
|
+
c = Coop()
|
31
|
+
self._price_lookup = c.fetch_prices()
|
32
|
+
return self._price_lookup
|
33
|
+
|
34
|
+
def prompts(self) -> "Dataset":
|
35
|
+
"""Return a Dataset of prompts that will be used.
|
36
|
+
|
37
|
+
>>> from edsl.jobs import Jobs
|
38
|
+
>>> Jobs.example().prompts()
|
39
|
+
Dataset(...)
|
40
|
+
"""
|
41
|
+
interviews = self.interviews
|
42
|
+
interview_indices = []
|
43
|
+
question_names = []
|
44
|
+
user_prompts = []
|
45
|
+
system_prompts = []
|
46
|
+
scenario_indices = []
|
47
|
+
agent_indices = []
|
48
|
+
models = []
|
49
|
+
costs = []
|
50
|
+
|
51
|
+
for interview_index, interview in enumerate(interviews):
|
52
|
+
invigilators = [
|
53
|
+
FetchInvigilator(interview)(question)
|
54
|
+
for question in interview.survey.questions
|
55
|
+
]
|
56
|
+
for _, invigilator in enumerate(invigilators):
|
57
|
+
prompts = invigilator.get_prompts()
|
58
|
+
user_prompt = prompts["user_prompt"]
|
59
|
+
system_prompt = prompts["system_prompt"]
|
60
|
+
user_prompts.append(user_prompt)
|
61
|
+
system_prompts.append(system_prompt)
|
62
|
+
agent_index = self.agents.index(invigilator.agent)
|
63
|
+
agent_indices.append(agent_index)
|
64
|
+
interview_indices.append(interview_index)
|
65
|
+
scenario_index = self.scenarios.index(invigilator.scenario)
|
66
|
+
scenario_indices.append(scenario_index)
|
67
|
+
models.append(invigilator.model.model)
|
68
|
+
question_names.append(invigilator.question.question_name)
|
69
|
+
|
70
|
+
prompt_cost = self.estimate_prompt_cost(
|
71
|
+
system_prompt=system_prompt,
|
72
|
+
user_prompt=user_prompt,
|
73
|
+
price_lookup=self.price_lookup,
|
74
|
+
inference_service=invigilator.model._inference_service_,
|
75
|
+
model=invigilator.model.model,
|
76
|
+
)
|
77
|
+
costs.append(prompt_cost["cost_usd"])
|
78
|
+
|
79
|
+
d = Dataset(
|
80
|
+
[
|
81
|
+
{"user_prompt": user_prompts},
|
82
|
+
{"system_prompt": system_prompts},
|
83
|
+
{"interview_index": interview_indices},
|
84
|
+
{"question_name": question_names},
|
85
|
+
{"scenario_index": scenario_indices},
|
86
|
+
{"agent_index": agent_indices},
|
87
|
+
{"model": models},
|
88
|
+
{"estimated_cost": costs},
|
89
|
+
]
|
90
|
+
)
|
91
|
+
return d
|
92
|
+
|
93
|
+
@staticmethod
|
94
|
+
def estimate_prompt_cost(
|
95
|
+
system_prompt: str,
|
96
|
+
user_prompt: str,
|
97
|
+
price_lookup: dict,
|
98
|
+
inference_service: str,
|
99
|
+
model: str,
|
100
|
+
) -> dict:
|
101
|
+
"""Estimates the cost of a prompt. Takes piping into account."""
|
102
|
+
import math
|
103
|
+
|
104
|
+
def get_piping_multiplier(prompt: str):
|
105
|
+
"""Returns 2 if a prompt includes Jinja braces, and 1 otherwise."""
|
106
|
+
|
107
|
+
if "{{" in prompt and "}}" in prompt:
|
108
|
+
return 2
|
109
|
+
return 1
|
110
|
+
|
111
|
+
# Look up prices per token
|
112
|
+
key = (inference_service, model)
|
113
|
+
|
114
|
+
try:
|
115
|
+
relevant_prices = price_lookup[key]
|
116
|
+
|
117
|
+
service_input_token_price = float(
|
118
|
+
relevant_prices["input"]["service_stated_token_price"]
|
119
|
+
)
|
120
|
+
service_input_token_qty = float(
|
121
|
+
relevant_prices["input"]["service_stated_token_qty"]
|
122
|
+
)
|
123
|
+
input_price_per_token = service_input_token_price / service_input_token_qty
|
124
|
+
|
125
|
+
service_output_token_price = float(
|
126
|
+
relevant_prices["output"]["service_stated_token_price"]
|
127
|
+
)
|
128
|
+
service_output_token_qty = float(
|
129
|
+
relevant_prices["output"]["service_stated_token_qty"]
|
130
|
+
)
|
131
|
+
output_price_per_token = (
|
132
|
+
service_output_token_price / service_output_token_qty
|
133
|
+
)
|
134
|
+
|
135
|
+
except KeyError:
|
136
|
+
# A KeyError is likely to occur if we cannot retrieve prices (the price_lookup dict is empty)
|
137
|
+
# Use a sensible default
|
138
|
+
|
139
|
+
import warnings
|
140
|
+
|
141
|
+
warnings.warn(
|
142
|
+
"Price data could not be retrieved. Using default estimates for input and output token prices. Input: $0.15 / 1M tokens; Output: $0.60 / 1M tokens"
|
143
|
+
)
|
144
|
+
input_price_per_token = 0.00000015 # $0.15 / 1M tokens
|
145
|
+
output_price_per_token = 0.00000060 # $0.60 / 1M tokens
|
146
|
+
|
147
|
+
# Compute the number of characters (double if the question involves piping)
|
148
|
+
user_prompt_chars = len(str(user_prompt)) * get_piping_multiplier(
|
149
|
+
str(user_prompt)
|
150
|
+
)
|
151
|
+
system_prompt_chars = len(str(system_prompt)) * get_piping_multiplier(
|
152
|
+
str(system_prompt)
|
153
|
+
)
|
154
|
+
|
155
|
+
# Convert into tokens (1 token approx. equals 4 characters)
|
156
|
+
input_tokens = (user_prompt_chars + system_prompt_chars) // 4
|
157
|
+
|
158
|
+
output_tokens = math.ceil(0.75 * input_tokens)
|
159
|
+
|
160
|
+
cost = (
|
161
|
+
input_tokens * input_price_per_token
|
162
|
+
+ output_tokens * output_price_per_token
|
163
|
+
)
|
164
|
+
|
165
|
+
return {
|
166
|
+
"input_tokens": input_tokens,
|
167
|
+
"output_tokens": output_tokens,
|
168
|
+
"cost_usd": cost,
|
169
|
+
}
|
170
|
+
|
171
|
+
def estimate_job_cost_from_external_prices(
|
172
|
+
self, price_lookup: dict, iterations: int = 1
|
173
|
+
) -> dict:
|
174
|
+
"""
|
175
|
+
Estimates the cost of a job according to the following assumptions:
|
176
|
+
|
177
|
+
- 1 token = 4 characters.
|
178
|
+
- For each prompt, output tokens = input tokens * 0.75, rounded up to the nearest integer.
|
179
|
+
|
180
|
+
price_lookup is an external pricing dictionary.
|
181
|
+
"""
|
182
|
+
|
183
|
+
import pandas as pd
|
184
|
+
|
185
|
+
interviews = self.interviews
|
186
|
+
data = []
|
187
|
+
for interview in interviews:
|
188
|
+
invigilators = [
|
189
|
+
FetchInvigilator(interview)(question)
|
190
|
+
for question in self.survey.questions
|
191
|
+
]
|
192
|
+
for invigilator in invigilators:
|
193
|
+
prompts = invigilator.get_prompts()
|
194
|
+
|
195
|
+
# By this point, agent and scenario data has already been added to the prompts
|
196
|
+
user_prompt = prompts["user_prompt"]
|
197
|
+
system_prompt = prompts["system_prompt"]
|
198
|
+
inference_service = invigilator.model._inference_service_
|
199
|
+
model = invigilator.model.model
|
200
|
+
|
201
|
+
prompt_cost = self.estimate_prompt_cost(
|
202
|
+
system_prompt=system_prompt,
|
203
|
+
user_prompt=user_prompt,
|
204
|
+
price_lookup=price_lookup,
|
205
|
+
inference_service=inference_service,
|
206
|
+
model=model,
|
207
|
+
)
|
208
|
+
|
209
|
+
data.append(
|
210
|
+
{
|
211
|
+
"user_prompt": user_prompt,
|
212
|
+
"system_prompt": system_prompt,
|
213
|
+
"estimated_input_tokens": prompt_cost["input_tokens"],
|
214
|
+
"estimated_output_tokens": prompt_cost["output_tokens"],
|
215
|
+
"estimated_cost_usd": prompt_cost["cost_usd"],
|
216
|
+
"inference_service": inference_service,
|
217
|
+
"model": model,
|
218
|
+
}
|
219
|
+
)
|
220
|
+
|
221
|
+
df = pd.DataFrame.from_records(data)
|
222
|
+
|
223
|
+
df = (
|
224
|
+
df.groupby(["inference_service", "model"])
|
225
|
+
.agg(
|
226
|
+
{
|
227
|
+
"estimated_cost_usd": "sum",
|
228
|
+
"estimated_input_tokens": "sum",
|
229
|
+
"estimated_output_tokens": "sum",
|
230
|
+
}
|
231
|
+
)
|
232
|
+
.reset_index()
|
233
|
+
)
|
234
|
+
df["estimated_cost_usd"] = df["estimated_cost_usd"] * iterations
|
235
|
+
df["estimated_input_tokens"] = df["estimated_input_tokens"] * iterations
|
236
|
+
df["estimated_output_tokens"] = df["estimated_output_tokens"] * iterations
|
237
|
+
|
238
|
+
estimated_costs_by_model = df.to_dict("records")
|
239
|
+
|
240
|
+
estimated_total_cost = sum(
|
241
|
+
model["estimated_cost_usd"] for model in estimated_costs_by_model
|
242
|
+
)
|
243
|
+
estimated_total_input_tokens = sum(
|
244
|
+
model["estimated_input_tokens"] for model in estimated_costs_by_model
|
245
|
+
)
|
246
|
+
estimated_total_output_tokens = sum(
|
247
|
+
model["estimated_output_tokens"] for model in estimated_costs_by_model
|
248
|
+
)
|
249
|
+
|
250
|
+
output = {
|
251
|
+
"estimated_total_cost_usd": estimated_total_cost,
|
252
|
+
"estimated_total_input_tokens": estimated_total_input_tokens,
|
253
|
+
"estimated_total_output_tokens": estimated_total_output_tokens,
|
254
|
+
"model_costs": estimated_costs_by_model,
|
255
|
+
}
|
256
|
+
|
257
|
+
return output
|
258
|
+
|
259
|
+
def estimate_job_cost(self, iterations: int = 1) -> dict:
|
260
|
+
"""
|
261
|
+
Estimates the cost of a job according to the following assumptions:
|
262
|
+
|
263
|
+
- 1 token = 4 characters.
|
264
|
+
- For each prompt, output tokens = input tokens * 0.75, rounded up to the nearest integer.
|
265
|
+
|
266
|
+
Fetches prices from Coop.
|
267
|
+
"""
|
268
|
+
return self.estimate_job_cost_from_external_prices(
|
269
|
+
price_lookup=self.price_lookup, iterations=iterations
|
270
|
+
)
|