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,290 +1,290 @@
1
- from collections import UserList
2
- import asyncio
3
- import inspect
4
- from typing import Optional, Callable
5
- from edsl import Agent, QuestionFreeText, Results, AgentList, ScenarioList, Scenario
6
- from edsl.questions import QuestionBase
7
- from edsl.results.Result import Result
8
- from jinja2 import Template
9
- from edsl.data import Cache
10
-
11
- from edsl.conversation.next_speaker_utilities import (
12
- default_turn_taking_generator,
13
- speaker_closure,
14
- )
15
-
16
-
17
- class AgentStatement:
18
- def __init__(self, statement: Result):
19
- self.statement = statement
20
-
21
- @property
22
- def agent_name(self):
23
- return self.statement["agent"]["name"]
24
-
25
- def to_dict(self):
26
- return self.statement.to_dict()
27
-
28
- @classmethod
29
- def from_dict(cls, data):
30
- return cls(Result.from_dict(data))
31
-
32
- @property
33
- def text(self):
34
- return self.statement["answer"]["dialogue"]
35
-
36
-
37
- class AgentStatements(UserList):
38
- def __init__(self, data=None):
39
- super().__init__(data)
40
-
41
- @property
42
- def transcript(self):
43
- return [{s.agent_name: s.text} for s in self.data]
44
-
45
- def to_dict(self):
46
- return [d.to_dict() for d in self.data]
47
-
48
- @classmethod
49
- def from_dict(cls, data):
50
- return cls([AgentStatement.from_dict(d) for d in data])
51
-
52
-
53
- class Conversation:
54
- """A conversation between a list of agents. The first agent in the list is the first speaker.
55
- After that, order is determined by the next_speaker function.
56
- The question asked to each agent is determined by the next_statement_question.
57
-
58
- If the user has passed in a "per_round_message_template", this will be displayed at the beginning of each round.
59
- {{ round_message }} must be in the question_text.
60
- """
61
-
62
- def __init__(
63
- self,
64
- agent_list: AgentList,
65
- max_turns: int = 20,
66
- stopping_function: Optional[Callable] = None,
67
- next_statement_question: Optional[QuestionBase] = None,
68
- next_speaker_generator: Optional[Callable] = None,
69
- verbose: bool = False,
70
- per_round_message_template: Optional[str] = None,
71
- conversation_index: Optional[int] = None,
72
- cache=None,
73
- disable_remote_inference=False,
74
- default_model: Optional["LanguageModel"] = None,
75
- ):
76
- self.disable_remote_inference = disable_remote_inference
77
- self.per_round_message_template = per_round_message_template
78
-
79
- if cache is None:
80
- self.cache = Cache()
81
- else:
82
- self.cache = cache
83
-
84
- self.agent_list = agent_list
85
-
86
- from edsl import Model
87
-
88
- for agent in self.agent_list:
89
- if not hasattr(agent, "model"):
90
- if default_model is not None:
91
- agent.model = default_model
92
- else:
93
- agent.model = Model()
94
-
95
- self.verbose = verbose
96
- self.agent_statements = []
97
- self._conversation_index = conversation_index
98
- self.agent_statements = AgentStatements()
99
-
100
- self.max_turns = max_turns
101
-
102
- if next_statement_question is None:
103
- import textwrap
104
-
105
- base_question = textwrap.dedent(
106
- """\
107
- You are {{ agent_name }}. This is the conversation so far: {{ conversation }}
108
- {% if round_message is not none %}
109
- {{ round_message }}
110
- {% endif %}
111
- What do you say next?"""
112
- )
113
- self.next_statement_question = QuestionFreeText(
114
- question_text=base_question,
115
- question_name="dialogue",
116
- )
117
- else:
118
- self.next_statement_question = next_statement_question
119
- if (
120
- per_round_message_template
121
- and "{{ round_message }}" not in next_statement_question.question_text
122
- ):
123
- raise ValueError(
124
- "If you pass in a per_round_message_template, you must include {{ round_message }} in the question_text."
125
- )
126
-
127
- # Determine how the next speaker is chosen
128
- if next_speaker_generator is None:
129
- func = default_turn_taking_generator
130
- else:
131
- func = next_speaker_generator
132
-
133
- # Choose the next speaker
134
- self.next_speaker = speaker_closure(
135
- agent_list=self.agent_list, generator_function=func
136
- )
137
-
138
- # Determine when the conversation ends
139
- if stopping_function is None:
140
- self.stopping_function = lambda agent_statements: False
141
- else:
142
- self.stopping_function = stopping_function
143
-
144
- async def continue_conversation(self, **kwargs) -> bool:
145
- if len(self.agent_statements) >= self.max_turns:
146
- return False
147
-
148
- if inspect.iscoroutinefunction(self.stopping_function):
149
- should_stop = await self.stopping_function(self.agent_statements, **kwargs)
150
- else:
151
- should_stop = self.stopping_function(self.agent_statements, **kwargs)
152
-
153
- return not should_stop
154
-
155
- def add_index(self, index) -> None:
156
- self._conversation_index = index
157
-
158
- @property
159
- def conversation_index(self):
160
- return self._conversation_index
161
-
162
- def to_dict(self):
163
- return {
164
- "agent_list": self.agent_list.to_dict(),
165
- "max_turns": self.max_turns,
166
- "verbose": self.verbose,
167
- "agent_statements": [d.to_dict() for d in self.agent_statements],
168
- "conversation_index": self.conversation_index,
169
- }
170
-
171
- @classmethod
172
- def from_dict(cls, data):
173
- agent_list = AgentList.from_dict(data["agent_list"])
174
- max_turns = data["max_turns"]
175
- verbose = data["verbose"]
176
- agent_statements = (AgentStatements.from_dict(data["agent_statements"]),)
177
- conversation_index = data["conversation_index"]
178
- return cls(
179
- agent_list=agent_list,
180
- max_turns=max_turns,
181
- verbose=verbose,
182
- results_data=agent_statements,
183
- conversation_index=conversation_index,
184
- )
185
-
186
- def to_results(self):
187
- return Results(data=[s.statement for s in self.agent_statements])
188
-
189
- def summarize(self):
190
- d = {
191
- "num_agents": len(self.agent_list),
192
- "max_turns": self.max_turns,
193
- "conversation_index": self.conversation_index,
194
- "transcript": self.to_results().select("agent_name", "dialogue").to_list(),
195
- "number_of_agent_statements": len(self.agent_statements),
196
- }
197
- return Scenario(d)
198
-
199
- async def get_next_statement(self, *, index, speaker, conversation) -> "Result":
200
- """Get the next statement from the speaker."""
201
- q = self.next_statement_question
202
- # assert q.parameters == {"agent_name", "conversation"}, q.parameters
203
- from edsl import Scenario
204
-
205
- if self.per_round_message_template is None:
206
- round_message = None
207
- else:
208
- round_message = Template(self.per_round_message_template).render(
209
- {"max_turns": self.max_turns, "current_turn": index}
210
- )
211
-
212
- s = Scenario(
213
- {
214
- "agent_name": speaker.name,
215
- "conversation": conversation,
216
- "conversation_index": self.conversation_index,
217
- "index": index,
218
- "round_message": round_message,
219
- }
220
- )
221
- jobs = q.by(s).by(speaker).by(speaker.model)
222
- jobs.show_prompts()
223
- results = await jobs.run_async(
224
- cache=self.cache, disable_remote_inference=self.disable_remote_inference
225
- )
226
- return results[0]
227
-
228
- def converse(self):
229
- return asyncio.run(self._converse())
230
-
231
- async def _converse(self):
232
- i = 0
233
- while await self.continue_conversation():
234
- speaker = self.next_speaker()
235
-
236
- next_statement = AgentStatement(
237
- statement=await self.get_next_statement(
238
- index=i,
239
- speaker=speaker,
240
- conversation=self.agent_statements.transcript,
241
- )
242
- )
243
- self.agent_statements.append(next_statement)
244
- if self.verbose:
245
- print(f"'{speaker.name}':{next_statement.text}")
246
- print("\n")
247
- i += 1
248
-
249
-
250
- class ConversationList:
251
- """A collection of conversations to be run in parallel."""
252
-
253
- def __init__(self, conversations: list[Conversation], cache=None):
254
- self.conversations = conversations
255
- for i, conversation in enumerate(self.conversations):
256
- conversation.add_index(i)
257
-
258
- if cache is None:
259
- self.cache = Cache()
260
- else:
261
- self.cache = cache
262
-
263
- for c in self.conversations:
264
- c.cache = self.cache
265
-
266
- async def run_conversations(self):
267
- await asyncio.gather(*[c._converse() for c in self.conversations])
268
-
269
- def run(self) -> None:
270
- """Run all conversations in parallel"""
271
- asyncio.run(self.run_conversations())
272
-
273
- def to_dict(self) -> dict:
274
- return {"conversations": c.to_dict() for c in self.conversations}
275
-
276
- @classmethod
277
- def from_dict(cls, data):
278
- conversations = [Conversation.from_dict(d) for d in data["conversations"]]
279
- return cls(conversations)
280
-
281
- def to_results(self) -> Results:
282
- """Return the results of all conversations as a single Results"""
283
- first_convo = self.conversations[0]
284
- results = first_convo.to_results()
285
- for conv in self.conversations[1:]:
286
- results += conv.to_results()
287
- return results
288
-
289
- def summarize(self) -> ScenarioList:
290
- return ScenarioList([c.summarize() for c in self.conversations])
1
+ from collections import UserList
2
+ import asyncio
3
+ import inspect
4
+ from typing import Optional, Callable
5
+ from edsl import Agent, QuestionFreeText, Results, AgentList, ScenarioList, Scenario
6
+ from edsl.questions import QuestionBase
7
+ from edsl.results.Result import Result
8
+ from jinja2 import Template
9
+ from edsl.data import Cache
10
+
11
+ from edsl.conversation.next_speaker_utilities import (
12
+ default_turn_taking_generator,
13
+ speaker_closure,
14
+ )
15
+
16
+
17
+ class AgentStatement:
18
+ def __init__(self, statement: Result):
19
+ self.statement = statement
20
+
21
+ @property
22
+ def agent_name(self):
23
+ return self.statement["agent"]["name"]
24
+
25
+ def to_dict(self):
26
+ return self.statement.to_dict()
27
+
28
+ @classmethod
29
+ def from_dict(cls, data):
30
+ return cls(Result.from_dict(data))
31
+
32
+ @property
33
+ def text(self):
34
+ return self.statement["answer"]["dialogue"]
35
+
36
+
37
+ class AgentStatements(UserList):
38
+ def __init__(self, data=None):
39
+ super().__init__(data)
40
+
41
+ @property
42
+ def transcript(self):
43
+ return [{s.agent_name: s.text} for s in self.data]
44
+
45
+ def to_dict(self):
46
+ return [d.to_dict() for d in self.data]
47
+
48
+ @classmethod
49
+ def from_dict(cls, data):
50
+ return cls([AgentStatement.from_dict(d) for d in data])
51
+
52
+
53
+ class Conversation:
54
+ """A conversation between a list of agents. The first agent in the list is the first speaker.
55
+ After that, order is determined by the next_speaker function.
56
+ The question asked to each agent is determined by the next_statement_question.
57
+
58
+ If the user has passed in a "per_round_message_template", this will be displayed at the beginning of each round.
59
+ {{ round_message }} must be in the question_text.
60
+ """
61
+
62
+ def __init__(
63
+ self,
64
+ agent_list: AgentList,
65
+ max_turns: int = 20,
66
+ stopping_function: Optional[Callable] = None,
67
+ next_statement_question: Optional[QuestionBase] = None,
68
+ next_speaker_generator: Optional[Callable] = None,
69
+ verbose: bool = False,
70
+ per_round_message_template: Optional[str] = None,
71
+ conversation_index: Optional[int] = None,
72
+ cache=None,
73
+ disable_remote_inference=False,
74
+ default_model: Optional["LanguageModel"] = None,
75
+ ):
76
+ self.disable_remote_inference = disable_remote_inference
77
+ self.per_round_message_template = per_round_message_template
78
+
79
+ if cache is None:
80
+ self.cache = Cache()
81
+ else:
82
+ self.cache = cache
83
+
84
+ self.agent_list = agent_list
85
+
86
+ from edsl import Model
87
+
88
+ for agent in self.agent_list:
89
+ if not hasattr(agent, "model"):
90
+ if default_model is not None:
91
+ agent.model = default_model
92
+ else:
93
+ agent.model = Model()
94
+
95
+ self.verbose = verbose
96
+ self.agent_statements = []
97
+ self._conversation_index = conversation_index
98
+ self.agent_statements = AgentStatements()
99
+
100
+ self.max_turns = max_turns
101
+
102
+ if next_statement_question is None:
103
+ import textwrap
104
+
105
+ base_question = textwrap.dedent(
106
+ """\
107
+ You are {{ agent_name }}. This is the conversation so far: {{ conversation }}
108
+ {% if round_message is not none %}
109
+ {{ round_message }}
110
+ {% endif %}
111
+ What do you say next?"""
112
+ )
113
+ self.next_statement_question = QuestionFreeText(
114
+ question_text=base_question,
115
+ question_name="dialogue",
116
+ )
117
+ else:
118
+ self.next_statement_question = next_statement_question
119
+ if (
120
+ per_round_message_template
121
+ and "{{ round_message }}" not in next_statement_question.question_text
122
+ ):
123
+ raise ValueError(
124
+ "If you pass in a per_round_message_template, you must include {{ round_message }} in the question_text."
125
+ )
126
+
127
+ # Determine how the next speaker is chosen
128
+ if next_speaker_generator is None:
129
+ func = default_turn_taking_generator
130
+ else:
131
+ func = next_speaker_generator
132
+
133
+ # Choose the next speaker
134
+ self.next_speaker = speaker_closure(
135
+ agent_list=self.agent_list, generator_function=func
136
+ )
137
+
138
+ # Determine when the conversation ends
139
+ if stopping_function is None:
140
+ self.stopping_function = lambda agent_statements: False
141
+ else:
142
+ self.stopping_function = stopping_function
143
+
144
+ async def continue_conversation(self, **kwargs) -> bool:
145
+ if len(self.agent_statements) >= self.max_turns:
146
+ return False
147
+
148
+ if inspect.iscoroutinefunction(self.stopping_function):
149
+ should_stop = await self.stopping_function(self.agent_statements, **kwargs)
150
+ else:
151
+ should_stop = self.stopping_function(self.agent_statements, **kwargs)
152
+
153
+ return not should_stop
154
+
155
+ def add_index(self, index) -> None:
156
+ self._conversation_index = index
157
+
158
+ @property
159
+ def conversation_index(self):
160
+ return self._conversation_index
161
+
162
+ def to_dict(self):
163
+ return {
164
+ "agent_list": self.agent_list.to_dict(),
165
+ "max_turns": self.max_turns,
166
+ "verbose": self.verbose,
167
+ "agent_statements": [d.to_dict() for d in self.agent_statements],
168
+ "conversation_index": self.conversation_index,
169
+ }
170
+
171
+ @classmethod
172
+ def from_dict(cls, data):
173
+ agent_list = AgentList.from_dict(data["agent_list"])
174
+ max_turns = data["max_turns"]
175
+ verbose = data["verbose"]
176
+ agent_statements = (AgentStatements.from_dict(data["agent_statements"]),)
177
+ conversation_index = data["conversation_index"]
178
+ return cls(
179
+ agent_list=agent_list,
180
+ max_turns=max_turns,
181
+ verbose=verbose,
182
+ results_data=agent_statements,
183
+ conversation_index=conversation_index,
184
+ )
185
+
186
+ def to_results(self):
187
+ return Results(data=[s.statement for s in self.agent_statements])
188
+
189
+ def summarize(self):
190
+ d = {
191
+ "num_agents": len(self.agent_list),
192
+ "max_turns": self.max_turns,
193
+ "conversation_index": self.conversation_index,
194
+ "transcript": self.to_results().select("agent_name", "dialogue").to_list(),
195
+ "number_of_agent_statements": len(self.agent_statements),
196
+ }
197
+ return Scenario(d)
198
+
199
+ async def get_next_statement(self, *, index, speaker, conversation) -> "Result":
200
+ """Get the next statement from the speaker."""
201
+ q = self.next_statement_question
202
+ # assert q.parameters == {"agent_name", "conversation"}, q.parameters
203
+ from edsl import Scenario
204
+
205
+ if self.per_round_message_template is None:
206
+ round_message = None
207
+ else:
208
+ round_message = Template(self.per_round_message_template).render(
209
+ {"max_turns": self.max_turns, "current_turn": index}
210
+ )
211
+
212
+ s = Scenario(
213
+ {
214
+ "agent_name": speaker.name,
215
+ "conversation": conversation,
216
+ "conversation_index": self.conversation_index,
217
+ "index": index,
218
+ "round_message": round_message,
219
+ }
220
+ )
221
+ jobs = q.by(s).by(speaker).by(speaker.model)
222
+ jobs.show_prompts()
223
+ results = await jobs.run_async(
224
+ cache=self.cache, disable_remote_inference=self.disable_remote_inference
225
+ )
226
+ return results[0]
227
+
228
+ def converse(self):
229
+ return asyncio.run(self._converse())
230
+
231
+ async def _converse(self):
232
+ i = 0
233
+ while await self.continue_conversation():
234
+ speaker = self.next_speaker()
235
+
236
+ next_statement = AgentStatement(
237
+ statement=await self.get_next_statement(
238
+ index=i,
239
+ speaker=speaker,
240
+ conversation=self.agent_statements.transcript,
241
+ )
242
+ )
243
+ self.agent_statements.append(next_statement)
244
+ if self.verbose:
245
+ print(f"'{speaker.name}':{next_statement.text}")
246
+ print("\n")
247
+ i += 1
248
+
249
+
250
+ class ConversationList:
251
+ """A collection of conversations to be run in parallel."""
252
+
253
+ def __init__(self, conversations: list[Conversation], cache=None):
254
+ self.conversations = conversations
255
+ for i, conversation in enumerate(self.conversations):
256
+ conversation.add_index(i)
257
+
258
+ if cache is None:
259
+ self.cache = Cache()
260
+ else:
261
+ self.cache = cache
262
+
263
+ for c in self.conversations:
264
+ c.cache = self.cache
265
+
266
+ async def run_conversations(self):
267
+ await asyncio.gather(*[c._converse() for c in self.conversations])
268
+
269
+ def run(self) -> None:
270
+ """Run all conversations in parallel"""
271
+ asyncio.run(self.run_conversations())
272
+
273
+ def to_dict(self) -> dict:
274
+ return {"conversations": c.to_dict() for c in self.conversations}
275
+
276
+ @classmethod
277
+ def from_dict(cls, data):
278
+ conversations = [Conversation.from_dict(d) for d in data["conversations"]]
279
+ return cls(conversations)
280
+
281
+ def to_results(self) -> Results:
282
+ """Return the results of all conversations as a single Results"""
283
+ first_convo = self.conversations[0]
284
+ results = first_convo.to_results()
285
+ for conv in self.conversations[1:]:
286
+ results += conv.to_results()
287
+ return results
288
+
289
+ def summarize(self) -> ScenarioList:
290
+ return ScenarioList([c.summarize() for c in self.conversations])