Deployed 8e69cdc to dev with MkDocs 1.6.1 and mike 2.2.0

Author: github-actions[bot]

dev/changelog/index.html

@@ -2902,16 +2902,16 @@ <h4 id="examples">Examples<a class="headerlink" href="#examples" title="Permanen
 <h4 id="generated-output">Generated Output<a class="headerlink" href="#generated-output" title="Permanent link">&para;</a></h4>
 <div class="language-text highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a>📁 agents/helper_bot
 </span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a>├── 📄 __init__.py
-</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a>├── 📄 graph.py
-</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a>├── 📄 nodes.py
+</span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a>├── 📄 agent.py
+</span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a>├── 📄 llm.py
 </span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a>├── 📄 config.py
 </span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a>├── 📄 prompts.json
 </span><span id="__span-5-7"><a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a>├── 📄 langgraph.json
 </span><span id="__span-5-8"><a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a>├── 📄 .env.example
 </span><span id="__span-5-9"><a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a>└── 📄 README.md
 </span><span id="__span-5-10"><a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a>
 </span><span id="__span-5-11"><a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a>🚀 What&#39;s next?
-</span><span id="__span-5-12"><a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a>  1. Edit helper_bot/nodes.py with your logic
+</span><span id="__span-5-12"><a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a>  1. Edit helper_bot/agent.py with your logic
 </span><span id="__span-5-13"><a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a>  2. agentomatic run to start
 </span><span id="__span-5-14"><a id="__codelineno-5-14" name="__codelineno-5-14" href="#__codelineno-5-14"></a>  3. agentomatic test helper_bot to test
 </span><span id="__span-5-15"><a id="__codelineno-5-15" name="__codelineno-5-15" href="#__codelineno-5-15"></a>  4. Open http://localhost:8000/docs for API docs
@@ -3126,8 +3126,8 @@ <h4 id="example-output_1">Example Output<a class="headerlink" href="#example-out
 </span><span id="__span-23-5"><a id="__codelineno-23-5" name="__codelineno-23-5" href="#__codelineno-23-5"></a>
 </span><span id="__span-23-6"><a id="__codelineno-23-6" name="__codelineno-23-6" href="#__codelineno-23-6"></a>📁 my_chatbot/
 </span><span id="__span-23-7"><a id="__codelineno-23-7" name="__codelineno-23-7" href="#__codelineno-23-7"></a>├── 📄 __init__.py (1,245 bytes)
-</span><span id="__span-23-8"><a id="__codelineno-23-8" name="__codelineno-23-8" href="#__codelineno-23-8"></a>├── 📄 graph.py (2,891 bytes)
-</span><span id="__span-23-9"><a id="__codelineno-23-9" name="__codelineno-23-9" href="#__codelineno-23-9"></a>├── 📄 nodes.py (3,456 bytes)
+</span><span id="__span-23-8"><a id="__codelineno-23-8" name="__codelineno-23-8" href="#__codelineno-23-8"></a>├── 📄 agent.py (2,891 bytes)
+</span><span id="__span-23-9"><a id="__codelineno-23-9" name="__codelineno-23-9" href="#__codelineno-23-9"></a>├── 📄 llm.py (890 bytes)
 </span><span id="__span-23-10"><a id="__codelineno-23-10" name="__codelineno-23-10" href="#__codelineno-23-10"></a>├── 📄 config.py (512 bytes)
 </span><span id="__span-23-11"><a id="__codelineno-23-11" name="__codelineno-23-11" href="#__codelineno-23-11"></a>├── 📄 prompts.json (678 bytes)
 </span><span id="__span-23-12"><a id="__codelineno-23-12" name="__codelineno-23-12" href="#__codelineno-23-12"></a>├── 📄 tools.py (1,024 bytes)
@@ -3136,7 +3136,7 @@ <h4 id="example-output_1">Example Output<a class="headerlink" href="#example-out
 </span><span id="__span-23-15"><a id="__codelineno-23-15" name="__codelineno-23-15" href="#__codelineno-23-15"></a>
 </span><span id="__span-23-16"><a id="__codelineno-23-16" name="__codelineno-23-16" href="#__codelineno-23-16"></a>╭── __init__.py ──────────────────────────────────╮
 </span><span id="__span-23-17"><a id="__codelineno-23-17" name="__codelineno-23-17" href="#__codelineno-23-17"></a>│ from agentomatic import AgentManifest           │
-</span><span id="__span-23-18"><a id="__codelineno-23-18" name="__codelineno-23-18" href="#__codelineno-23-18"></a>│ from .graph import get_graph                    │
+</span><span id="__span-23-18"><a id="__codelineno-23-18" name="__codelineno-23-18" href="#__codelineno-23-18"></a>│ from .agent import MyChatbotAgent               │
 </span><span id="__span-23-19"><a id="__codelineno-23-19" name="__codelineno-23-19" href="#__codelineno-23-19"></a>│                                                 │
 </span><span id="__span-23-20"><a id="__codelineno-23-20" name="__codelineno-23-20" href="#__codelineno-23-20"></a>│ manifest = AgentManifest(                       │
 </span><span id="__span-23-21"><a id="__codelineno-23-21" name="__codelineno-23-21" href="#__codelineno-23-21"></a>│     name=&quot;my_chatbot&quot;,                          │
@@ -3205,12 +3205,13 @@ <h3 id="agentomatic-optimize"><code>agentomatic optimize</code><a class="headerl
 </span><span id="__span-26-12"><a id="__codelineno-26-12" name="__codelineno-26-12" href="#__codelineno-26-12"></a>  --target-score FLOAT     Stop when this avg score is reached  [default: 0.9]
 </span><span id="__span-26-13"><a id="__codelineno-26-13" name="__codelineno-26-13" href="#__codelineno-26-13"></a>  --rewrite-llm TEXT       LLM for prompt rewriting
 </span><span id="__span-26-14"><a id="__codelineno-26-14" name="__codelineno-26-14" href="#__codelineno-26-14"></a>  --eval-llm TEXT          LLM for evaluation grading
-</span><span id="__span-26-15"><a id="__codelineno-26-15" name="__codelineno-26-15" href="#__codelineno-26-15"></a>  --llm TEXT               Default fallback LLM  [default: ollama/mistral:7b]
-</span><span id="__span-26-16"><a id="__codelineno-26-16" name="__codelineno-26-16" href="#__codelineno-26-16"></a>  --patience INT           Early stopping patience  [default: 3]
-</span><span id="__span-26-17"><a id="__codelineno-26-17" name="__codelineno-26-17" href="#__codelineno-26-17"></a>  --prompt TEXT            Initial system prompt (overrides prompts.json)
-</span><span id="__span-26-18"><a id="__codelineno-26-18" name="__codelineno-26-18" href="#__codelineno-26-18"></a>  --no-report              Skip generating HTML report
-</span><span id="__span-26-19"><a id="__codelineno-26-19" name="__codelineno-26-19" href="#__codelineno-26-19"></a>  --apply                  Auto-save the best-performing prompt
-</span><span id="__span-26-20"><a id="__codelineno-26-20" name="__codelineno-26-20" href="#__codelineno-26-20"></a>  --host TEXT              Platform API base URL  [default: http://localhost:8000]
+</span><span id="__span-26-15"><a id="__codelineno-26-15" name="__codelineno-26-15" href="#__codelineno-26-15"></a>  --llm TEXT               Default fallback LLM (env: AGENTOMATIC_TASK_MODEL /
+</span><span id="__span-26-16"><a id="__codelineno-26-16" name="__codelineno-26-16" href="#__codelineno-26-16"></a>                           LLM__MODEL; else ollama/mistral:7b)
+</span><span id="__span-26-17"><a id="__codelineno-26-17" name="__codelineno-26-17" href="#__codelineno-26-17"></a>  --patience INT           Early stopping patience  [default: 3]
+</span><span id="__span-26-18"><a id="__codelineno-26-18" name="__codelineno-26-18" href="#__codelineno-26-18"></a>  --prompt TEXT            Initial system prompt (overrides prompts.json)
+</span><span id="__span-26-19"><a id="__codelineno-26-19" name="__codelineno-26-19" href="#__codelineno-26-19"></a>  --no-report              Skip generating HTML report
+</span><span id="__span-26-20"><a id="__codelineno-26-20" name="__codelineno-26-20" href="#__codelineno-26-20"></a>  --apply                  Auto-save the best-performing prompt
+</span><span id="__span-26-21"><a id="__codelineno-26-21" name="__codelineno-26-21" href="#__codelineno-26-21"></a>  --host TEXT              Platform API base URL  [default: http://localhost:8000]
 </span></code></pre></div>
 <h4 id="optimization-strategies">Optimization Strategies<a class="headerlink" href="#optimization-strategies" title="Permanent link">&para;</a></h4>
 <table>

dev/cli/commands/index.html

@@ -2683,9 +2683,9 @@ <h2 id="2-scaffold-your-first-agent">2. Scaffold Your First Agent<a class="heade
 </span></code></pre></div>
 <p>This creates a self-contained agent package under <code>agents/</code>:</p>
 <div class="language-text highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a>agents/my_chatbot/
-</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a>├── __init__.py      # Optional Python package init
-</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a>├── agent.py         # REQUIRED: Contains your BaseGraphAgent subclass
-</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a>├── config.py        # Pydantic configuration (model, temperature, etc.)
+</span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a>├── __init__.py      # AgentManifest card
+</span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a>├── agent.py         # REQUIRED: BaseGraphAgent subclass
+</span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a>├── llm.py           # Stack-aware LLM helpers
 </span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a>├── prompts.json     # Versioned system and user prompt templates
 </span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a>├── langgraph.json   # LangGraph Studio local settings
 </span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a>├── .env.example     # Environment variables blueprint
@@ -2702,7 +2702,7 @@ <h2 id="2-scaffold-your-first-agent">2. Scaffold Your First Agent<a class="heade
 </thead>
 <tbody>
 <tr>
-<td><code>basic</code></td>
+<td><code>basic</code> / <code>class</code></td>
 <td>Minimal class-based agent (recommended) — quick start</td>
 </tr>
 <tr>
@@ -2715,7 +2715,15 @@ <h2 id="2-scaffold-your-first-agent">2. Scaffold Your First Agent<a class="heade
 </tr>
 <tr>
 <td><code>full</code></td>
-<td>All features: class agent with config, schemas, api, tools, prompts</td>
+<td>All features: class agent with config, schemas, train/eval</td>
+</tr>
+<tr>
+<td><code>coordinator</code></td>
+<td>Orchestrator that routes to specialists</td>
+</tr>
+<tr>
+<td><code>pipeline</code></td>
+<td>Multi-step YAML workflow</td>
 </tr>
 <tr>
 <td><code>deepagent</code></td>
@@ -2727,11 +2735,15 @@ <h2 id="2-scaffold-your-first-agent">2. Scaffold Your First Agent<a class="heade
 </tr>
 <tr>
 <td><code>legacy_dict</code></td>
-<td>Legacy functional agent — <code>__init__.py</code> with <code>manifest</code> + <code>node_fn</code></td>
+<td>Legacy functional agent — <code>manifest</code> + <code>node_fn</code></td>
 </tr>
 <tr>
 <td><code>plugin</code></td>
-<td>ML Model Plugin — wrap classical ML models with REST endpoints</td>
+<td>ML Model Plugin with REST endpoints</td>
+</tr>
+<tr>
+<td><code>endpoint</code> / <code>connection</code> / <code>ingestion</code> / <code>extraction</code></td>
+<td>Ops / RAG building blocks</td>
 </tr>
 </tbody>
 </table>

dev/getting-started/quickstart/index.html

@@ -927,10 +927,10 @@
 </li>
 
           <li class="md-nav__item">
-  <a href="#savepath-load_compiledpath" class="md-nav__link">
+  <a href="#savepath-loadpath-load_compiledpath" class="md-nav__link">
     <span class="md-ellipsis">
 
-        save(path) / load_compiled(path)
+        save(path) / load(path) / load_compiled(path)
 
     </span>
   </a>
@@ -2763,10 +2763,10 @@
 </li>
 
           <li class="md-nav__item">
-  <a href="#savepath-load_compiledpath" class="md-nav__link">
+  <a href="#savepath-loadpath-load_compiledpath" class="md-nav__link">
     <span class="md-ellipsis">
 
-        save(path) / load_compiled(path)
+        save(path) / load(path) / load_compiled(path)
 
     </span>
   </a>
@@ -3752,15 +3752,16 @@ <h3 id="evaluatedataset-metrics"><code>evaluate(dataset, metrics)</code><a class
 </span><span id="__span-16-10"><a id="__codelineno-16-10" name="__codelineno-16-10" href="#__codelineno-16-10"></a><span class="c1">#   Scores:</span>
 </span><span id="__span-16-11"><a id="__codelineno-16-11" name="__codelineno-16-11" href="#__codelineno-16-11"></a><span class="c1">#     exact_key_match: 0.900</span>
 </span></code></pre></div>
-<h3 id="savepath-load_compiledpath"><code>save(path)</code> / <code>load_compiled(path)</code><a class="headerlink" href="#savepath-load_compiledpath" title="Permanent link">&para;</a></h3>
-<p>Persist and restore the compiled state:</p>
-<div class="language-python highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a><span class="c1"># Save</span>
-</span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a><span class="n">agent</span><span class="o">.</span><span class="n">save</span><span class="p">(</span><span class="s2">&quot;compiled/summarizer_v1&quot;</span><span class="p">)</span>
-</span><span id="__span-17-3"><a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a><span class="c1"># Creates: config.json, metadata.json, evaluation_history.json</span>
-</span><span id="__span-17-4"><a id="__codelineno-17-4" name="__codelineno-17-4" href="#__codelineno-17-4"></a>
-</span><span id="__span-17-5"><a id="__codelineno-17-5" name="__codelineno-17-5" href="#__codelineno-17-5"></a><span class="c1"># Load into a fresh instance</span>
-</span><span id="__span-17-6"><a id="__codelineno-17-6" name="__codelineno-17-6" href="#__codelineno-17-6"></a><span class="n">fresh</span> <span class="o">=</span> <span class="n">MyAgent</span><span class="p">(</span><span class="n">llm</span><span class="o">=</span><span class="n">my_llm</span><span class="p">)</span>
-</span><span id="__span-17-7"><a id="__codelineno-17-7" name="__codelineno-17-7" href="#__codelineno-17-7"></a><span class="n">fresh</span><span class="o">.</span><span class="n">load_compiled</span><span class="p">(</span><span class="s2">&quot;compiled/summarizer_v1&quot;</span><span class="p">)</span>
+<h3 id="savepath-loadpath-load_compiledpath"><code>save(path)</code> / <code>load(path)</code> / <code>load_compiled(path)</code><a class="headerlink" href="#savepath-loadpath-load_compiledpath" title="Permanent link">&para;</a></h3>
+<p>Persists compiled config, metadata, evaluation reports, and the Keras-style
+<code>History</code> from the last <code>fit()</code> (<code>fit_history.json</code>). <code>load()</code> is an alias of
+<code>load_compiled()</code>:</p>
+<div class="language-python highlight"><pre><span></span><code><span id="__span-17-1"><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a><span class="n">agent</span><span class="o">.</span><span class="n">save</span><span class="p">(</span><span class="s2">&quot;compiled/summarizer_v1&quot;</span><span class="p">)</span>
+</span><span id="__span-17-2"><a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a><span class="c1"># Creates: config.json, metadata.json, evaluation_history.json, fit_history.json</span>
+</span><span id="__span-17-3"><a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a>
+</span><span id="__span-17-4"><a id="__codelineno-17-4" name="__codelineno-17-4" href="#__codelineno-17-4"></a><span class="n">fresh</span> <span class="o">=</span> <span class="n">MyAgent</span><span class="p">(</span><span class="n">llm</span><span class="o">=</span><span class="n">my_llm</span><span class="p">)</span>
+</span><span id="__span-17-5"><a id="__codelineno-17-5" name="__codelineno-17-5" href="#__codelineno-17-5"></a><span class="n">fresh</span><span class="o">.</span><span class="n">load</span><span class="p">(</span><span class="s2">&quot;compiled/summarizer_v1&quot;</span><span class="p">)</span>  <span class="c1"># or load_compiled(...)</span>
+</span><span id="__span-17-6"><a id="__codelineno-17-6" name="__codelineno-17-6" href="#__codelineno-17-6"></a><span class="k">assert</span> <span class="n">fresh</span><span class="o">.</span><span class="n">history</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
 </span></code></pre></div>
 <details class="example">
 <summary>Full ML Workflow</summary>