Spaces:
Paused
Paused
| <html lang="en"> | |
| <head> | |
| <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> | |
| <title>Coverage for tinytroupe/utils/semantics.py: 100%</title> | |
| <link rel="icon" sizes="32x32" href="favicon_32_cb_c827f16f.png"> | |
| <link rel="stylesheet" href="style_cb_9ff733b0.css" type="text/css"> | |
| <script src="coverage_html_cb_dd2e7eb5.js" defer></script> | |
| </head> | |
| <body class="pyfile"> | |
| <header> | |
| <div class="content"> | |
| <h1> | |
| <span class="text">Coverage for </span><b>tinytroupe / utils / semantics.py</b>: | |
| <span class="pc_cov">100%</span> | |
| </h1> | |
| <aside id="help_panel_wrapper"> | |
| <input id="help_panel_state" type="checkbox"> | |
| <label for="help_panel_state"> | |
| <img id="keyboard_icon" src="keybd_closed_cb_900cfef5.png" alt="Show/hide keyboard shortcuts"> | |
| </label> | |
| <div id="help_panel"> | |
| <p class="legend">Shortcuts on this page</p> | |
| <div class="keyhelp"> | |
| <p> | |
| <kbd>r</kbd> | |
| <kbd>m</kbd> | |
| <kbd>x</kbd> | |
| toggle line displays | |
| </p> | |
| <p> | |
| <kbd>j</kbd> | |
| <kbd>k</kbd> | |
| next/prev highlighted chunk | |
| </p> | |
| <p> | |
| <kbd>0</kbd> (zero) top of page | |
| </p> | |
| <p> | |
| <kbd>1</kbd> (one) first highlighted chunk | |
| </p> | |
| <p> | |
| <kbd>[</kbd> | |
| <kbd>]</kbd> | |
| prev/next file | |
| </p> | |
| <p> | |
| <kbd>u</kbd> up to the index | |
| </p> | |
| <p> | |
| <kbd>?</kbd> show/hide this help | |
| </p> | |
| </div> | |
| </div> | |
| </aside> | |
| <h2> | |
| <span class="text">17 statements </span> | |
| <button type="button" class="run button_toggle_run" value="run" data-shortcut="r" title="Toggle lines run">17<span class="text"> run</span></button> | |
| <button type="button" class="mis show_mis button_toggle_mis" value="mis" data-shortcut="m" title="Toggle lines missing">0<span class="text"> missing</span></button> | |
| <button type="button" class="exc show_exc button_toggle_exc" value="exc" data-shortcut="x" title="Toggle lines excluded">0<span class="text"> excluded</span></button> | |
| </h2> | |
| <p class="text"> | |
| <a id="prevFileLink" class="nav" href="z_4b3d0d3b603de221_rendering_py.html">« prev</a> | |
| <a id="indexLink" class="nav" href="index.html">^ index</a> | |
| <a id="nextFileLink" class="nav" href="z_4b3d0d3b603de221_validation_py.html">» next</a> | |
| | |
| <a class="nav" href="https://coverage.readthedocs.io/en/7.13.4">coverage.py v7.13.4</a>, | |
| created at 2026-02-28 17:48 +0000 | |
| </p> | |
| <aside class="hidden"> | |
| <button type="button" class="button_next_chunk" data-shortcut="j"></button> | |
| <button type="button" class="button_prev_chunk" data-shortcut="k"></button> | |
| <button type="button" class="button_top_of_page" data-shortcut="0"></button> | |
| <button type="button" class="button_first_chunk" data-shortcut="1"></button> | |
| <button type="button" class="button_prev_file" data-shortcut="["></button> | |
| <button type="button" class="button_next_file" data-shortcut="]"></button> | |
| <button type="button" class="button_to_index" data-shortcut="u"></button> | |
| <button type="button" class="button_show_hide_help" data-shortcut="?"></button> | |
| </aside> | |
| </div> | |
| </header> | |
| <main id="source"> | |
| <p class="pln"><span class="n"><a id="t1" href="#t1">1</a></span><span class="t"><span class="str">"""</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t2" href="#t2">2</a></span><span class="t"><span class="str">Semantic-related mechanisms.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t3" href="#t3">3</a></span><span class="t"><span class="str">"""</span> </span><span class="r"></span></p> | |
| <p class="run"><span class="n"><a id="t4" href="#t4">4</a></span><span class="t"><span class="key">from</span> <span class="nam">tinytroupe</span><span class="op">.</span><span class="nam">utils</span> <span class="key">import</span> <span class="nam">llm</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t5" href="#t5">5</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="run"><span class="n"><a id="t6" href="#t6">6</a></span><span class="t"><span class="op">@</span><span class="nam">llm</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> | |
| <p class="run"><span class="n"><a id="t7" href="#t7">7</a></span><span class="t"><span class="key">def</span> <span class="nam">correct_according_to_rule</span><span class="op">(</span><span class="nam">observation</span><span class="op">,</span> <span class="nam">rules</span><span class="op">)</span> <span class="op">-></span> <span class="nam">str</span><span class="op">:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t8" href="#t8">8</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t9" href="#t9">9</a></span><span class="t"><span class="str"> Given an observation and a one or more rules, this function rephrases or completely changes the observation in accordance with what the rules</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t10" href="#t10">10</a></span><span class="t"><span class="str"> specify. Some guidelines:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t11" href="#t11">11</a></span><span class="t"><span class="str"> - Rules might require changes either to style or to content.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t12" href="#t12">12</a></span><span class="t"><span class="str"> - The rephrased observation should be coherent and consistent with the original observation, unless the rules require otherwise.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t13" href="#t13">13</a></span><span class="t"><span class="str"> - If the rules require, the corrected observation can contradict the original observation.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t14" href="#t14">14</a></span><span class="t"><span class="str"> - Enforce the rules very strictly, even if the original observation seems correct or acceptable.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t15" href="#t15">15</a></span><span class="t"><span class="str"> - Rules might contain additional information or suggestions that you may use to improve your output.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t16" href="#t16">16</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t17" href="#t17">17</a></span><span class="t"><span class="str"> ## Examples</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t18" href="#t18">18</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t19" href="#t19">19</a></span><span class="t"><span class="str"> Observation: "You know, I am so sad these days."</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t20" href="#t20">20</a></span><span class="t"><span class="str"> Rule: "I am always happy and depression is unknown to me"</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t21" href="#t21">21</a></span><span class="t"><span class="str"> Modified observation: "You know, I am so happy these days."</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t22" href="#t22">22</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t23" href="#t23">23</a></span><span class="t"><span class="str"> Args:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t24" href="#t24">24</a></span><span class="t"><span class="str"> observation: The observation that should be rephrased or changed. Something that is said or done, or a description of events or facts.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t25" href="#t25">25</a></span><span class="t"><span class="str"> rules: The rules that specifies what the modidfied observation should comply with. </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t26" href="#t26">26</a></span><span class="t"><span class="str"> </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t27" href="#t27">27</a></span><span class="t"><span class="str"> Returns:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t28" href="#t28">28</a></span><span class="t"><span class="str"> str: The rephrased or corrected observation.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t29" href="#t29">29</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t30" href="#t30">30</a></span><span class="t"> <span class="com"># llm decorator will handle the body of this function</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t31" href="#t31">31</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="run"><span class="n"><a id="t32" href="#t32">32</a></span><span class="t"><span class="op">@</span><span class="nam">llm</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> | |
| <p class="run"><span class="n"><a id="t33" href="#t33">33</a></span><span class="t"><span class="key">def</span> <span class="nam">restructure_as_observed_vs_expected</span><span class="op">(</span><span class="nam">description</span><span class="op">)</span> <span class="op">-></span> <span class="nam">str</span><span class="op">:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t34" href="#t34">34</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t35" href="#t35">35</a></span><span class="t"><span class="str"> Given the description of something (either a real event or abstract concept), but that violates an expectation, this function </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t36" href="#t36">36</a></span><span class="t"><span class="str"> extracts the following elements from it:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t37" href="#t37">37</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t38" href="#t38">38</a></span><span class="t"><span class="str"> - OBSERVED: The observed event or statement.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t39" href="#t39">39</a></span><span class="t"><span class="str"> - BROKEN EXPECTATION: The expectation that was broken by the observed event.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t40" href="#t40">40</a></span><span class="t"><span class="str"> - REASONING: The reasoning behind the expectation that was broken.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t41" href="#t41">41</a></span><span class="t"><span class="str"> </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t42" href="#t42">42</a></span><span class="t"><span class="str"> If in reality the description does not mention any expectation violation, then the function should instead extract</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t43" href="#t43">43</a></span><span class="t"><span class="str"> the following elements:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t44" href="#t44">44</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t45" href="#t45">45</a></span><span class="t"><span class="str"> - OBSERVED: The observed event.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t46" href="#t46">46</a></span><span class="t"><span class="str"> - MET EXPECTATION: The expectation that was met by the observed event.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t47" href="#t47">47</a></span><span class="t"><span class="str"> - REASONING: The reasoning behind the expectation that was met.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t48" href="#t48">48</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t49" href="#t49">49</a></span><span class="t"><span class="str"> This way of restructuring the description can be useful for downstream processing, making it easier to analyze or</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t50" href="#t50">50</a></span><span class="t"><span class="str"> modify system outputs, for example.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t51" href="#t51">51</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t52" href="#t52">52</a></span><span class="t"><span class="str"> ## Examples</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t53" href="#t53">53</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t54" href="#t54">54</a></span><span class="t"><span class="str"> Input: "Ana mentions she loved the proposed new food, a spicier flavor of gazpacho. However, this goes agains her known dislike</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t55" href="#t55">55</a></span><span class="t"><span class="str"> of spicy food."</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t56" href="#t56">56</a></span><span class="t"><span class="str"> Output: </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t57" href="#t57">57</a></span><span class="t"><span class="str"> "OBSERVED: Ana mentions she loved the proposed new food, a spicier flavor of gazpacho.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t58" href="#t58">58</a></span><span class="t"><span class="str"> BROKEN EXPECTATION: Ana should have mentioned that she disliked the proposed spicier gazpacho.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t59" href="#t59">59</a></span><span class="t"><span class="str"> REASONING: Ana has a known dislike of spicy food."</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t60" href="#t60">60</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t61" href="#t61">61</a></span><span class="t"><span class="str"> </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t62" href="#t62">62</a></span><span class="t"><span class="str"> Input: "Carlos traveled to Firenzi and was amazed by the beauty of the city. This was in line with his love for art and architecture."</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t63" href="#t63">63</a></span><span class="t"><span class="str"> Output: </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t64" href="#t64">64</a></span><span class="t"><span class="str"> "OBSERVED: Carlos traveled to Firenzi and was amazed by the beauty of the city.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t65" href="#t65">65</a></span><span class="t"><span class="str"> MET EXPECTATION: Carlos should have been amazed by the beauty of the city.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t66" href="#t66">66</a></span><span class="t"><span class="str"> REASONING: Carlos loves art and architecture."</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t67" href="#t67">67</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t68" href="#t68">68</a></span><span class="t"><span class="str"> Args:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t69" href="#t69">69</a></span><span class="t"><span class="str"> description (str): A description of an event or concept that either violates or meets an expectation.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t70" href="#t70">70</a></span><span class="t"><span class="str"> </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t71" href="#t71">71</a></span><span class="t"><span class="str"> Returns:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t72" href="#t72">72</a></span><span class="t"><span class="str"> str: The restructured description.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t73" href="#t73">73</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t74" href="#t74">74</a></span><span class="t"> <span class="com"># llm decorator will handle the body of this function</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t75" href="#t75">75</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="run"><span class="n"><a id="t76" href="#t76">76</a></span><span class="t"><span class="op">@</span><span class="nam">llm</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> | |
| <p class="run"><span class="n"><a id="t77" href="#t77">77</a></span><span class="t"><span class="key">def</span> <span class="nam">extract_observed_vs_expected_rules</span><span class="op">(</span><span class="nam">description</span><span class="op">)</span><span class="op">:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t78" href="#t78">78</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t79" href="#t79">79</a></span><span class="t"><span class="str"> Given the description of something (either a real event or abstract concept), extract:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t80" href="#t80">80</a></span><span class="t"><span class="str"> - The object or person about whom something is said.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t81" href="#t81">81</a></span><span class="t"><span class="str"> - A list where each element contains:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t82" href="#t82">82</a></span><span class="t"><span class="str"> * The name of a behavior or property that is expected to be observed.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t83" href="#t83">83</a></span><span class="t"><span class="str"> * The typical or expected observation.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t84" href="#t84">84</a></span><span class="t"><span class="str"> * The actual observation. If this does not match the expected observation, this should be made very clear.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t85" href="#t85">85</a></span><span class="t"><span class="str"> * A proposed correction to the observation, if possible.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t86" href="#t86">86</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t87" href="#t87">87</a></span><span class="t"><span class="str"> </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t88" href="#t88">88</a></span><span class="t"><span class="str"> # Example:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t89" href="#t89">89</a></span><span class="t"><span class="str"> **Description:**</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t90" href="#t90">90</a></span><span class="t"><span class="str"> ```</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t91" href="#t91">91</a></span><span class="t"><span class="str"> Quality feedback</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t92" href="#t92">92</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t93" href="#t93">93</a></span><span class="t"><span class="str"> This is the action that was generated by the agent:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t94" href="#t94">94</a></span><span class="t"><span class="str"> {'type': 'TALK', 'content': "I might consider buying bottled gazpacho, although I prefer making it fresh at home, and I find that most pre-packaged products don't meet my expectations in terms of quality. ", 'target': 'Michael Thompson'}</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t95" href="#t95">95</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t96" href="#t96">96</a></span><span class="t"><span class="str"> Unfortunately, the action failed to pass the quality checks. The following problems were detected.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t97" href="#t97">97</a></span><span class="t"><span class="str"> </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t98" href="#t98">98</a></span><span class="t"><span class="str"> Problem: The action does not adhere to the persona specification.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t99" href="#t99">99</a></span><span class="t"><span class="str"> Score = 5 (out of 9). Justification = The next action of Emily Carter, which involves expressing her opinion on bottled gazpacho, aligns with her persona specification of being critical and having high standards for products. She articulates her preferences and concerns about quality, which is consistent with her persona traits of being overly critical and rarely satisfied. However, she seems too ready to consider it, going against her strong rejection of new products and services. Therefore, it deviates substantially from her persona, leading to a score of 5.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t100" href="#t100">100</a></span><span class="t"><span class="str"> </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t101" href="#t101">101</a></span><span class="t"><span class="str"> Problem: The action is not suitable to the situation or task.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t102" href="#t102">102</a></span><span class="t"><span class="str"> Score = 5 (out of 9). Justification = The next action, where Emily expresses her consideration about buying bottled gazpacho, aligns with the task of discussing her opinion on the product. However, it fails to give a clear "yes" or "no" answer, that was requested by her interviewer.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t103" href="#t103">103</a></span><span class="t"><span class="str"> ```</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t104" href="#t104">104</a></span><span class="t"><span class="str"> </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t105" href="#t105">105</a></span><span class="t"><span class="str"> **Output:**</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t106" href="#t106">106</a></span><span class="t"><span class="str"> ```</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t107" href="#t107">107</a></span><span class="t"><span class="str"> {</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t108" href="#t108">108</a></span><span class="t"><span class="str"> "object": "Emily Carter",</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t109" href="#t109">109</a></span><span class="t"><span class="str"> "behavior": [</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t110" href="#t110">110</a></span><span class="t"><span class="str"> {</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t111" href="#t111">111</a></span><span class="t"><span class="str"> "name:": "Persona Adherence",</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t112" href="#t112">112</a></span><span class="t"><span class="str"> "expected": "She is very critical and have high standards for products. Would never adopt a new product unless it meets her expectations.",</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t113" href="#t113">113</a></span><span class="t"><span class="str"> "actual": "She seems more inclined than expected to try the product.",</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t114" href="#t114">114</a></span><span class="t"><span class="str"> "correction": "She should say she won't consider buying bottled gazpacho, and give reasons for that."</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t115" href="#t115">115</a></span><span class="t"><span class="str"> },</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t116" href="#t116">116</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t117" href="#t117">117</a></span><span class="t"><span class="str"> {</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t118" href="#t118">118</a></span><span class="t"><span class="str"> "name:": "Task Suitability",</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t119" href="#t119">119</a></span><span class="t"><span class="str"> "expected": "She should give a clear 'yes' or 'no' answer to the question.",</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t120" href="#t120">120</a></span><span class="t"><span class="str"> "actual": "She doesn't give a clear 'yes' or 'no' answer to the question, but instead providing more nuanced feedback.",</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t121" href="#t121">121</a></span><span class="t"><span class="str"> "correction": "She should give a clear 'yes' or 'no' answer to the question, and optionally provide additional nuanced feedback."</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t122" href="#t122">122</a></span><span class="t"><span class="str"> }</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t123" href="#t123">123</a></span><span class="t"><span class="str"> ]</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t124" href="#t124">124</a></span><span class="t"><span class="str"> }</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t125" href="#t125">125</a></span><span class="t"><span class="str"> ```</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t126" href="#t126">126</a></span><span class="t"><span class="str"> </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t127" href="#t127">127</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t128" href="#t128">128</a></span><span class="t"> <span class="com"># llm decorator will handle the body of this function</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t129" href="#t129">129</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="run"><span class="n"><a id="t130" href="#t130">130</a></span><span class="t"><span class="op">@</span><span class="nam">llm</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> | |
| <p class="run"><span class="n"><a id="t131" href="#t131">131</a></span><span class="t"><span class="key">def</span> <span class="nam">formulate_corrective_rule</span><span class="op">(</span><span class="nam">feedback</span><span class="op">)</span> <span class="op">-></span> <span class="nam">str</span><span class="op">:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t132" href="#t132">132</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t133" href="#t133">133</a></span><span class="t"><span class="str"> Given the feedback about something (either a real event or abstract concept) that violated an expectation, </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t134" href="#t134">134</a></span><span class="t"><span class="str"> this function transforms it into a general rule that must be followed in the future to avoid breaking the expectation again.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t135" href="#t135">135</a></span><span class="t"><span class="str"> </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t136" href="#t136">136</a></span><span class="t"><span class="str"> The feedback always refers to some actual behavior, fact or event, and some broken expectation. The abstracted rule should</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t137" href="#t137">137</a></span><span class="t"><span class="str"> specify that this expectation should not be violated in the future, and the behavior, fact or event not repeated. The idea is</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t138" href="#t138">138</a></span><span class="t"><span class="str"> to learn from past mistakes, so that the rule is a way to avoid them in the future.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t139" href="#t139">139</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t140" href="#t140">140</a></span><span class="t"><span class="str"> The rule is meant to CHANGE the actual behavior, facts or events, so that it CONFORMS to the expectation, regardless of whether the</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t141" href="#t141">141</a></span><span class="t"><span class="str"> expectation is a good or bad one. This is critical, because the rule will be refered in the future as a guideline</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t142" href="#t142">142</a></span><span class="t"><span class="str"> about what must happen or be done.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t143" href="#t143">143</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t144" href="#t144">144</a></span><span class="t"><span class="str"> For instance, if the feedback is of the form (modulo grammatical adjustments): </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t145" href="#t145">145</a></span><span class="t"><span class="str"> OBSERVED BEHAVIOR, but EXPECTED BEHAVIOR, because REASONING.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t146" href="#t146">146</a></span><span class="t"><span class="str"> then the rule would be of the form:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t147" href="#t147">147</a></span><span class="t"><span class="str"> "I should have EXPECTED BEHAVIOR, because REASONING, and never OBSERVED BEHAVIOR."</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t148" href="#t148">148</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t149" href="#t149">149</a></span><span class="t"><span class="str"> DO NOT make moral judgements about the expectation or the behavior, fact or event. Even if the expectation is bad, </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t150" href="#t150">150</a></span><span class="t"><span class="str"> the correct rule remains important, since there are legitimate cases where this is necessary (e.g., a simulation of </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t151" href="#t151">151</a></span><span class="t"><span class="str"> a person with a negative behavior, in the context of psychological research; or an evil character in a movie script).</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t152" href="#t152">152</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t153" href="#t153">153</a></span><span class="t"><span class="str"> ## Examples</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t154" href="#t154">154</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t155" href="#t155">155</a></span><span class="t"><span class="str"> Feedback: "Ana mentions she loved the proposed new food, a spicier flavor of gazpacho. However, this goes agains her known dislike</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t156" href="#t156">156</a></span><span class="t"><span class="str"> of spicy food."</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t157" href="#t157">157</a></span><span class="t"><span class="str"> Rule: "Whenever I'm proposed spicy foods, I should reject the proposal, because I don't like spicy foods."</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t158" href="#t158">158</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t159" href="#t159">159</a></span><span class="t"> <span class="com"># llm decorator will handle the body of this function</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t160" href="#t160">160</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t161" href="#t161">161</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="run"><span class="n"><a id="t162" href="#t162">162</a></span><span class="t"><span class="op">@</span><span class="nam">llm</span><span class="op">(</span><span class="nam">enable_json_output_format</span><span class="op">=</span><span class="key">False</span><span class="op">)</span> </span><span class="r"></span></p> | |
| <p class="run"><span class="n"><a id="t163" href="#t163">163</a></span><span class="t"><span class="key">def</span> <span class="nam">combine_texts</span><span class="op">(</span><span class="op">*</span><span class="nam">texts</span><span class="op">)</span> <span class="op">-></span> <span class="nam">str</span><span class="op">:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t164" href="#t164">164</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t165" href="#t165">165</a></span><span class="t"><span class="str"> Given a list of input texts, this function combines them into a single text, ensuring that the</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t166" href="#t166">166</a></span><span class="t"><span class="str"> output is coherent, consistent, and logically structured. In particular, the resulting combination</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t167" href="#t167">167</a></span><span class="t"><span class="str"> must follow these rules:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t168" href="#t168">168</a></span><span class="t"><span class="str"> - The combination consolidates the information from the inputs. It **does not** just concatenate them.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t169" href="#t169">169</a></span><span class="t"><span class="str"> - Information that was repeated across the inputs is not repeated in the output, but rather unified and consolidated there.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t170" href="#t170">170</a></span><span class="t"><span class="str"> - The combination preserves all the essential information from the inputs, but it is not a simple copy of them.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t171" href="#t171">171</a></span><span class="t"><span class="str"> - If information from some inputs can be combined in a more concise formulation, this new formulation should be used in the output.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t172" href="#t172">172</a></span><span class="t"><span class="str"> This allows to reduce redundancy and improve clarity.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t173" href="#t173">173</a></span><span class="t"><span class="str"> - The combination might be larger than the sum of the inputs, since it preserves the information from the inputs.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t174" href="#t174">174</a></span><span class="t"><span class="str"> - If the various inputs seem to follow some common format or style, the output must follow that format or style too.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t175" href="#t175">175</a></span><span class="t"><span class="str"> - The combination can contain inconsistencies or contradictions, in case the inputs do.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t176" href="#t176">176</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t177" href="#t177">177</a></span><span class="t"><span class="str"> Args:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t178" href="#t178">178</a></span><span class="t"><span class="str"> *texts: A list of input texts to be combined.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t179" href="#t179">179</a></span><span class="t"><span class="str"> </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t180" href="#t180">180</a></span><span class="t"><span class="str"> Returns:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t181" href="#t181">181</a></span><span class="t"><span class="str"> str: The combined text.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t182" href="#t182">182</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t183" href="#t183">183</a></span><span class="t"> <span class="com"># llm decorator will handle the body of this function</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t184" href="#t184">184</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="run"><span class="n"><a id="t185" href="#t185">185</a></span><span class="t"><span class="op">@</span><span class="nam">llm</span><span class="op">(</span><span class="nam">enable_json_output_format</span><span class="op">=</span><span class="key">False</span><span class="op">)</span> </span><span class="r"></span></p> | |
| <p class="run"><span class="n"><a id="t186" href="#t186">186</a></span><span class="t"><span class="key">def</span> <span class="nam">extract_information_from_text</span><span class="op">(</span><span class="nam">query</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span> <span class="nam">text</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span> <span class="nam">context</span><span class="op">:</span><span class="nam">str</span><span class="op">=</span><span class="key">None</span><span class="op">)</span> <span class="op">-></span> <span class="nam">str</span><span class="op">:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t187" href="#t187">187</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t188" href="#t188">188</a></span><span class="t"><span class="str"> Given a text and a query, this function extracts the information from the text that either answers the query directly or</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t189" href="#t189">189</a></span><span class="t"><span class="str"> provides relevant information related to it. The query can be a question, a request for specific information, or a general</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t190" href="#t190">190</a></span><span class="t"><span class="str"> request for details about the text. If the desired information is not present in the text, the function should return an empty string.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t191" href="#t191">191</a></span><span class="t"><span class="str"> If a context is provided, it is used to help in understanding the query or the text, and to provide additional background</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t192" href="#t192">192</a></span><span class="t"><span class="str"> information or expectations about the input/output. Any requests in the context are respected and enforced in the output.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t193" href="#t193">193</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t194" href="#t194">194</a></span><span class="t"><span class="str"> Args:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t195" href="#t195">195</a></span><span class="t"><span class="str"> query (str): The query that specifies what information to extract.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t196" href="#t196">196</a></span><span class="t"><span class="str"> text (str): The text from which to extract information.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t197" href="#t197">197</a></span><span class="t"><span class="str"> context (str, optional): Additional context that might help in extracting the information. This can be used to provide </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t198" href="#t198">198</a></span><span class="t"><span class="str"> background information or specify expectations about the input/output.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t199" href="#t199">199</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t200" href="#t200">200</a></span><span class="t"><span class="str"> Returns:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t201" href="#t201">201</a></span><span class="t"><span class="str"> str: The extracted information that answers the query. If no information is found, an empty string is returned.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t202" href="#t202">202</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t203" href="#t203">203</a></span><span class="t"> <span class="com"># llm decorator will handle the body of this function</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t204" href="#t204">204</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="run"><span class="n"><a id="t205" href="#t205">205</a></span><span class="t"><span class="op">@</span><span class="nam">llm</span><span class="op">(</span><span class="nam">enable_json_output_format</span><span class="op">=</span><span class="key">False</span><span class="op">)</span> </span><span class="r"></span></p> | |
| <p class="run"><span class="n"><a id="t206" href="#t206">206</a></span><span class="t"><span class="key">def</span> <span class="nam">accumulate_based_on_query</span><span class="op">(</span><span class="nam">query</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span> <span class="nam">new_entry</span><span class="op">:</span><span class="nam">str</span><span class="op">,</span> <span class="nam">current_accumulation</span><span class="op">:</span><span class="nam">str</span><span class="op">,</span> <span class="nam">context</span><span class="op">=</span><span class="key">None</span><span class="op">)</span> <span class="op">-></span> <span class="nam">str</span><span class="op">:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t207" href="#t207">207</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t208" href="#t208">208</a></span><span class="t"><span class="str"> This function accumulates information that is relevant to a given query. It takes a new entry and updates the current accumulation of information</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t209" href="#t209">209</a></span><span class="t"><span class="str"> such that the final accumulation preserves its original information and in addition integrates the new entry in a way that addresses the query or provides related information. </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t210" href="#t210">210</a></span><span class="t"><span class="str"> Details are **never** suppressed, but rather expanded upon, while mantaining the coherence and structure of the overall accumulation.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t211" href="#t211">211</a></span><span class="t"><span class="str"> In other words, it is a monotonic accumulation process that builds on the current accumulation, **minimally** adjusts it to maintain coherence,</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t212" href="#t212">212</a></span><span class="t"><span class="str"> while ensuring that the new entry is integrated in a way that is relevant to the query.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t213" href="#t213">213</a></span><span class="t"><span class="str"> The query itself specifies the problem that the accumulation is trying to address, and the new entry is a piece of information that might be relevant to that problem.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t214" href="#t214">214</a></span><span class="t"><span class="str"> </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t215" href="#t215">215</a></span><span class="t"><span class="str"> The function should ensure that the accumulation is coherent, well-written, and that it does not contain redundant information. More precisely:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t216" href="#t216">216</a></span><span class="t"><span class="str"> - INTEGRATES NEW ENTRIES: The accumulation process is not a simple concatenation of the new entry and the current accumulation. Rather, it should intelligently integrate </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t217" href="#t217">217</a></span><span class="t"><span class="str"> the new entry into the current accumulation, even if this requires rephrasing, restructuring or rewriting the resulting accumulation.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t218" href="#t218">218</a></span><span class="t"><span class="str"> - EXPAND ON DETAILS: When integrating the new entry, always try to expand the level of detail rather than reduce it.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t219" href="#t219">219</a></span><span class="t"><span class="str"> - AVOID OBVIOUS REDUNDANCY: The integration of the new entry should be done in a way to avoid obvious redundancy and ensure that the resulting accumulation is coherent and well-structured. However,</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t220" href="#t220">220</a></span><span class="t"><span class="str"> it **must** preserve nuances that might be somewhat redundant.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t221" href="#t221">221</a></span><span class="t"><span class="str"> - ALWAYS PRESERVE INFORMATION: Previous information should **never** be lost. Previous emphasis or details are **never** lost. Rather, the accumulation is suitably expanded to include the new entry, </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t222" href="#t222">222</a></span><span class="t"><span class="str"> while preserving the previous information and maintaining the coherence of the overall accumulation.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t223" href="#t223">223</a></span><span class="t"><span class="str"> - INTEGRATE ONLY IF RELEVANT: The new entry should be integrated into the current accumulation only if it is relevant to the query. Otherwise, the accumulation should remain unchanged.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t224" href="#t224">224</a></span><span class="t"><span class="str"> - TOLERATE CONTRADICTIONS: If the new entry contradicts the current accumulation, it should be integrated in a way that mentions the fact that there are </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t225" href="#t225">225</a></span><span class="t"><span class="str"> divergent pieces of information, and that the accumulation reflects this divergence. That is to say, the contradiction is not discarded, but rather acknowledged and preserved.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t226" href="#t226">226</a></span><span class="t"><span class="str"> - MAINTAIN COHERENCE: The resulting accumulation should be coherent and well-structured, with a clear flow of information.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t227" href="#t227">227</a></span><span class="t"><span class="str"> - CONSIDER CONTEXT: If a context is provided, it should be used to help in understanding the query or the new entry, and to provide additional background </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t228" href="#t228">228</a></span><span class="t"><span class="str"> information or expectations about the input/output. Make sure any requests in the context are respected and enforced in the output.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t229" href="#t229">229</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t230" href="#t230">230</a></span><span class="t"><span class="str"> Args:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t231" href="#t231">231</a></span><span class="t"><span class="str"> query (str): The query that specifies the problem that the accumulation is trying to address.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t232" href="#t232">232</a></span><span class="t"><span class="str"> new_entry (str): The new entry of information to be considered for accumulation.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t233" href="#t233">233</a></span><span class="t"><span class="str"> current_accumulation (str): The current accumulation of information.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t234" href="#t234">234</a></span><span class="t"><span class="str"> context (str, optional): Additional context that might help in understanding the query or the new entry. This can be used to provide </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t235" href="#t235">235</a></span><span class="t"><span class="str"> background information or specify expectations about the input/output.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t236" href="#t236">236</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t237" href="#t237">237</a></span><span class="t"><span class="str"> Returns:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t238" href="#t238">238</a></span><span class="t"><span class="str"> str: The updated accumulation of information that includes the new entry if it is relevant to the query.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t239" href="#t239">239</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t240" href="#t240">240</a></span><span class="t"> <span class="com"># llm decorator will handle the body of this function</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t241" href="#t241">241</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="run"><span class="n"><a id="t242" href="#t242">242</a></span><span class="t"><span class="op">@</span><span class="nam">llm</span><span class="op">(</span><span class="op">)</span> </span><span class="r"></span></p> | |
| <p class="run"><span class="n"><a id="t243" href="#t243">243</a></span><span class="t"><span class="key">def</span> <span class="nam">compute_semantic_proximity</span><span class="op">(</span><span class="nam">text1</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span> <span class="nam">text2</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span> <span class="nam">context</span><span class="op">:</span> <span class="nam">str</span> <span class="op">=</span> <span class="key">None</span><span class="op">)</span> <span class="op">-></span> <span class="nam">float</span><span class="op">:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t244" href="#t244">244</a></span><span class="t"> <span class="str">"""</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t245" href="#t245">245</a></span><span class="t"><span class="str"> Computes the semantic proximity between two texts and returns a proximity score.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t246" href="#t246">246</a></span><span class="t"><span class="str"> This function is particularly useful for comparing agent justifications, explanations, or reasoning</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t247" href="#t247">247</a></span><span class="t"><span class="str"> to assess how similar they are in meaning and content.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t248" href="#t248">248</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t249" href="#t249">249</a></span><span class="t"><span class="str"> Args:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t250" href="#t250">250</a></span><span class="t"><span class="str"> text1 (str): The first text to compare.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t251" href="#t251">251</a></span><span class="t"><span class="str"> text2 (str): The second text to compare.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t252" href="#t252">252</a></span><span class="t"><span class="str"> context (str, optional): Additional context that might help in understanding the comparison.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t253" href="#t253">253</a></span><span class="t"><span class="str"> This can provide background information about what the texts represent</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t254" href="#t254">254</a></span><span class="t"><span class="str"> or the purpose of the comparison.</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t255" href="#t255">255</a></span><span class="t"> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t256" href="#t256">256</a></span><span class="t"><span class="str"> Returns:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t257" href="#t257">257</a></span><span class="t"><span class="str"> float</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t258" href="#t258">258</a></span><span class="t"><span class="str"> </span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t259" href="#t259">259</a></span><span class="t"><span class="str"> Example:</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t260" href="#t260">260</a></span><span class="t"><span class="str"> >>> result = compute_semantic_proximity(</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t261" href="#t261">261</a></span><span class="t"><span class="str"> ... "I prefer luxury travel because I enjoy comfort and high-quality service",</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t262" href="#t262">262</a></span><span class="t"><span class="str"> ... "I like premium vacations since I value convenience and excellent amenities"</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t263" href="#t263">263</a></span><span class="t"><span class="str"> ... )</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t264" href="#t264">264</a></span><span class="t"><span class="str"> >>> print(result) # Expected: ~0.85</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t265" href="#t265">265</a></span><span class="t"><span class="str"> """</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t266" href="#t266">266</a></span><span class="t"> <span class="com"># llm decorator will handle the body of this function</span> </span><span class="r"></span></p> | |
| <p class="pln"><span class="n"><a id="t267" href="#t267">267</a></span><span class="t"> </span><span class="r"></span></p> | |
| </main> | |
| <footer> | |
| <div class="content"> | |
| <p> | |
| <a class="nav" href="z_4b3d0d3b603de221_rendering_py.html">« prev</a> | |
| <a class="nav" href="index.html">^ index</a> | |
| <a class="nav" href="z_4b3d0d3b603de221_validation_py.html">» next</a> | |
| | |
| <a class="nav" href="https://coverage.readthedocs.io/en/7.13.4">coverage.py v7.13.4</a>, | |
| created at 2026-02-28 17:48 +0000 | |
| </p> | |
| </div> | |
| </footer> | |
| </body> | |
| </html> | |