robot_lab 0.1.0 → 0.2.1

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 (242) hide show
  1. checksums.yaml +4 -4
  2. data/.architecture/AGENTS.md +32 -0
  3. data/.architecture/config.yml +8 -0
  4. data/.architecture/members.yml +60 -0
  5. data/.architecture/reviews/feature-free-will.md +490 -0
  6. data/.architecture/reviews/overall-codebase.md +427 -0
  7. data/.claude/settings.local.json +57 -0
  8. data/.codex/config.toml +2 -0
  9. data/.irbrc +2 -2
  10. data/.rubocop.yml +172 -0
  11. data/CHANGELOG.md +72 -0
  12. data/CLAUDE.md +139 -0
  13. data/README.md +91 -95
  14. data/Rakefile +109 -3
  15. data/agent2agent_review.md +192 -0
  16. data/agentf_improvements.md +253 -0
  17. data/agents.md +14 -0
  18. data/docs/examples/index.md +37 -2
  19. data/docs/getting-started/configuration.md +20 -7
  20. data/docs/guides/index.md +16 -16
  21. data/docs/guides/knowledge.md +7 -1
  22. data/docs/guides/observability.md +132 -0
  23. data/docs/index.md +30 -3
  24. data/docs/superpowers/plans/2026-05-06-agentskills.md +1303 -0
  25. data/docs/superpowers/specs/2026-05-06-agentskills-design.md +247 -0
  26. data/examples/.envrc +1 -0
  27. data/examples/01_simple_robot.rb +5 -9
  28. data/examples/02_tools.rb +5 -9
  29. data/examples/03_network.rb +8 -9
  30. data/examples/04_mcp.rb +21 -29
  31. data/examples/05_streaming.rb +12 -18
  32. data/examples/06_prompt_templates.rb +11 -19
  33. data/examples/07_network_memory.rb +16 -31
  34. data/examples/08_llm_config.rb +10 -22
  35. data/examples/09_chaining.rb +16 -27
  36. data/examples/10_memory.rb +12 -28
  37. data/examples/11_network_introspection.rb +15 -29
  38. data/examples/12_message_bus.rb +5 -12
  39. data/examples/13_spawn.rb +5 -10
  40. data/examples/14_rusty_circuit/.envrc +1 -0
  41. data/examples/14_rusty_circuit/comic.rb +2 -0
  42. data/examples/14_rusty_circuit/heckler.rb +1 -1
  43. data/examples/14_rusty_circuit/open_mic.rb +1 -3
  44. data/examples/14_rusty_circuit/scout.rb +2 -0
  45. data/examples/15_memory_network_and_bus/.envrc +1 -0
  46. data/examples/15_memory_network_and_bus/editorial_pipeline.rb +6 -3
  47. data/examples/15_memory_network_and_bus/linux_writer.rb +1 -1
  48. data/examples/15_memory_network_and_bus/output/combined_article.md +6 -6
  49. data/examples/15_memory_network_and_bus/output/final_article.md +6 -8
  50. data/examples/15_memory_network_and_bus/output/linux_draft.md +4 -2
  51. data/examples/15_memory_network_and_bus/output/mac_draft.md +3 -3
  52. data/examples/15_memory_network_and_bus/output/memory.json +6 -6
  53. data/examples/15_memory_network_and_bus/output/revision_1.md +10 -11
  54. data/examples/15_memory_network_and_bus/output/revision_2.md +6 -8
  55. data/examples/15_memory_network_and_bus/output/windows_draft.md +3 -3
  56. data/examples/16_writers_room/.envrc +1 -0
  57. data/examples/16_writers_room/writers_room.rb +2 -4
  58. data/examples/17_skills.rb +8 -17
  59. data/examples/18_rails/Gemfile +1 -0
  60. data/examples/19_token_tracking.rb +9 -15
  61. data/examples/20_circuit_breaker.rb +10 -19
  62. data/examples/21_learning_loop.rb +11 -20
  63. data/examples/22_context_compression.rb +6 -13
  64. data/examples/23_convergence.rb +6 -17
  65. data/examples/24_structured_delegation.rb +11 -15
  66. data/examples/25_history_search.rb +5 -12
  67. data/examples/26_document_store.rb +6 -13
  68. data/examples/27_incident_response/incident_response.rb +4 -5
  69. data/examples/28_mcp_discovery.rb +8 -11
  70. data/examples/29_ractor_tools.rb +4 -9
  71. data/examples/30_ractor_network.rb +10 -19
  72. data/examples/31_launch_assessment.rb +10 -23
  73. data/examples/32_newsletter_reader.rb +188 -0
  74. data/examples/33_stock_generator.rb +80 -0
  75. data/examples/33_stock_predictor.rb +306 -0
  76. data/examples/34_agentskills.rb +72 -0
  77. data/examples/README.md +1 -1
  78. data/examples/common.rb +76 -0
  79. data/examples/ruboruby.md +423 -0
  80. data/examples/temp.md +51 -0
  81. data/lib/robot_lab/agent_skill.rb +63 -0
  82. data/lib/robot_lab/agent_skill_catalog.rb +74 -0
  83. data/lib/robot_lab/ask_user.rb +2 -2
  84. data/lib/robot_lab/bus_poller.rb +12 -5
  85. data/lib/robot_lab/config.rb +1 -12
  86. data/lib/robot_lab/delegation_future.rb +1 -1
  87. data/lib/robot_lab/doom_loop_detector.rb +98 -0
  88. data/lib/robot_lab/history_compressor.rb +4 -10
  89. data/lib/robot_lab/mcp/client.rb +1 -2
  90. data/lib/robot_lab/mcp/connection_poller.rb +3 -3
  91. data/lib/robot_lab/mcp/server.rb +1 -1
  92. data/lib/robot_lab/mcp/server_discovery.rb +0 -2
  93. data/lib/robot_lab/memory.rb +32 -27
  94. data/lib/robot_lab/memory_change.rb +2 -2
  95. data/lib/robot_lab/message.rb +4 -4
  96. data/lib/robot_lab/network.rb +11 -6
  97. data/lib/robot_lab/robot/agent_skill_matching.rb +99 -0
  98. data/lib/robot_lab/robot/bus_messaging.rb +9 -27
  99. data/lib/robot_lab/robot/history_search.rb +4 -1
  100. data/lib/robot_lab/robot/mcp_management.rb +5 -11
  101. data/lib/robot_lab/robot/template_rendering.rb +60 -40
  102. data/lib/robot_lab/robot.rb +323 -206
  103. data/lib/robot_lab/robot_result.rb +6 -5
  104. data/lib/robot_lab/run_config.rb +5 -11
  105. data/lib/robot_lab/script_tool.rb +76 -0
  106. data/lib/robot_lab/state_proxy.rb +7 -5
  107. data/lib/robot_lab/tool.rb +3 -3
  108. data/lib/robot_lab/tool_config.rb +1 -1
  109. data/lib/robot_lab/tool_manifest.rb +5 -7
  110. data/lib/robot_lab/user_message.rb +2 -2
  111. data/lib/robot_lab/version.rb +1 -1
  112. data/lib/robot_lab/waiter.rb +1 -1
  113. data/lib/robot_lab.rb +41 -52
  114. data/logfile +8 -0
  115. data/mkdocs.yml +2 -3
  116. data/robot_concurrency.md +38 -0
  117. data/simple_acp_review.md +298 -0
  118. data/site/404.html +2300 -0
  119. data/site/api/core/index.html +2706 -0
  120. data/site/api/core/memory/index.html +3793 -0
  121. data/site/api/core/network/index.html +3500 -0
  122. data/site/api/core/robot/index.html +4566 -0
  123. data/site/api/core/state/index.html +3390 -0
  124. data/site/api/core/tool/index.html +3843 -0
  125. data/site/api/index.html +2635 -0
  126. data/site/api/mcp/client/index.html +3435 -0
  127. data/site/api/mcp/index.html +2783 -0
  128. data/site/api/mcp/server/index.html +3252 -0
  129. data/site/api/mcp/transports/index.html +3352 -0
  130. data/site/api/messages/index.html +2641 -0
  131. data/site/api/messages/text-message/index.html +3087 -0
  132. data/site/api/messages/tool-call-message/index.html +3159 -0
  133. data/site/api/messages/tool-result-message/index.html +3252 -0
  134. data/site/api/messages/user-message/index.html +3212 -0
  135. data/site/api/streaming/context/index.html +3282 -0
  136. data/site/api/streaming/events/index.html +3347 -0
  137. data/site/api/streaming/index.html +2738 -0
  138. data/site/architecture/core-concepts/index.html +3757 -0
  139. data/site/architecture/index.html +2797 -0
  140. data/site/architecture/message-flow/index.html +3238 -0
  141. data/site/architecture/network-orchestration/index.html +3433 -0
  142. data/site/architecture/robot-execution/index.html +3140 -0
  143. data/site/architecture/state-management/index.html +3498 -0
  144. data/site/assets/css/custom.css +56 -0
  145. data/site/assets/images/favicon.png +0 -0
  146. data/site/assets/images/robot_lab.jpg +0 -0
  147. data/site/assets/javascripts/bundle.79ae519e.min.js +16 -0
  148. data/site/assets/javascripts/bundle.79ae519e.min.js.map +7 -0
  149. data/site/assets/javascripts/lunr/min/lunr.ar.min.js +1 -0
  150. data/site/assets/javascripts/lunr/min/lunr.da.min.js +18 -0
  151. data/site/assets/javascripts/lunr/min/lunr.de.min.js +18 -0
  152. data/site/assets/javascripts/lunr/min/lunr.du.min.js +18 -0
  153. data/site/assets/javascripts/lunr/min/lunr.el.min.js +1 -0
  154. data/site/assets/javascripts/lunr/min/lunr.es.min.js +18 -0
  155. data/site/assets/javascripts/lunr/min/lunr.fi.min.js +18 -0
  156. data/site/assets/javascripts/lunr/min/lunr.fr.min.js +18 -0
  157. data/site/assets/javascripts/lunr/min/lunr.he.min.js +1 -0
  158. data/site/assets/javascripts/lunr/min/lunr.hi.min.js +1 -0
  159. data/site/assets/javascripts/lunr/min/lunr.hu.min.js +18 -0
  160. data/site/assets/javascripts/lunr/min/lunr.hy.min.js +1 -0
  161. data/site/assets/javascripts/lunr/min/lunr.it.min.js +18 -0
  162. data/site/assets/javascripts/lunr/min/lunr.ja.min.js +1 -0
  163. data/site/assets/javascripts/lunr/min/lunr.jp.min.js +1 -0
  164. data/site/assets/javascripts/lunr/min/lunr.kn.min.js +1 -0
  165. data/site/assets/javascripts/lunr/min/lunr.ko.min.js +1 -0
  166. data/site/assets/javascripts/lunr/min/lunr.multi.min.js +1 -0
  167. data/site/assets/javascripts/lunr/min/lunr.nl.min.js +18 -0
  168. data/site/assets/javascripts/lunr/min/lunr.no.min.js +18 -0
  169. data/site/assets/javascripts/lunr/min/lunr.pt.min.js +18 -0
  170. data/site/assets/javascripts/lunr/min/lunr.ro.min.js +18 -0
  171. data/site/assets/javascripts/lunr/min/lunr.ru.min.js +18 -0
  172. data/site/assets/javascripts/lunr/min/lunr.sa.min.js +1 -0
  173. data/site/assets/javascripts/lunr/min/lunr.stemmer.support.min.js +1 -0
  174. data/site/assets/javascripts/lunr/min/lunr.sv.min.js +18 -0
  175. data/site/assets/javascripts/lunr/min/lunr.ta.min.js +1 -0
  176. data/site/assets/javascripts/lunr/min/lunr.te.min.js +1 -0
  177. data/site/assets/javascripts/lunr/min/lunr.th.min.js +1 -0
  178. data/site/assets/javascripts/lunr/min/lunr.tr.min.js +18 -0
  179. data/site/assets/javascripts/lunr/min/lunr.vi.min.js +1 -0
  180. data/site/assets/javascripts/lunr/min/lunr.zh.min.js +1 -0
  181. data/site/assets/javascripts/lunr/tinyseg.js +206 -0
  182. data/site/assets/javascripts/lunr/wordcut.js +6708 -0
  183. data/site/assets/javascripts/workers/search.2c215733.min.js +42 -0
  184. data/site/assets/javascripts/workers/search.2c215733.min.js.map +7 -0
  185. data/site/assets/stylesheets/main.484c7ddc.min.css +1 -0
  186. data/site/assets/stylesheets/main.484c7ddc.min.css.map +1 -0
  187. data/site/assets/stylesheets/palette.ab4e12ef.min.css +1 -0
  188. data/site/assets/stylesheets/palette.ab4e12ef.min.css.map +1 -0
  189. data/site/concepts/index.html +3455 -0
  190. data/site/examples/basic-chat/index.html +2880 -0
  191. data/site/examples/index.html +2907 -0
  192. data/site/examples/mcp-server/index.html +3018 -0
  193. data/site/examples/multi-robot-network/index.html +3131 -0
  194. data/site/examples/rails-application/index.html +3329 -0
  195. data/site/examples/tool-usage/index.html +3085 -0
  196. data/site/getting-started/configuration/index.html +3745 -0
  197. data/site/getting-started/index.html +2572 -0
  198. data/site/getting-started/installation/index.html +2981 -0
  199. data/site/getting-started/quick-start/index.html +2942 -0
  200. data/site/guides/building-robots/index.html +4290 -0
  201. data/site/guides/creating-networks/index.html +3858 -0
  202. data/site/guides/index.html +2586 -0
  203. data/site/guides/mcp-integration/index.html +3581 -0
  204. data/site/guides/memory/index.html +3586 -0
  205. data/site/guides/rails-integration/index.html +4019 -0
  206. data/site/guides/streaming/index.html +3157 -0
  207. data/site/guides/using-tools/index.html +3802 -0
  208. data/site/index.html +2671 -0
  209. data/site/search/search_index.json +1 -0
  210. data/site/sitemap.xml +183 -0
  211. data/site/sitemap.xml.gz +0 -0
  212. data/site/tags.json +1 -0
  213. data/temp.md +6 -0
  214. data/tool_manifest_plan.md +155 -0
  215. metadata +154 -92
  216. data/docs/examples/rails-application.md +0 -419
  217. data/docs/guides/ractor-parallelism.md +0 -364
  218. data/docs/guides/rails-integration.md +0 -681
  219. data/docs/superpowers/plans/2026-04-14-ractor-integration.md +0 -1538
  220. data/docs/superpowers/specs/2026-04-14-ractor-integration-design.md +0 -258
  221. data/lib/generators/robot_lab/install_generator.rb +0 -90
  222. data/lib/generators/robot_lab/job_generator.rb +0 -40
  223. data/lib/generators/robot_lab/robot_generator.rb +0 -55
  224. data/lib/generators/robot_lab/templates/initializer.rb.tt +0 -42
  225. data/lib/generators/robot_lab/templates/job.rb.tt +0 -21
  226. data/lib/generators/robot_lab/templates/migration.rb.tt +0 -32
  227. data/lib/generators/robot_lab/templates/result_model.rb.tt +0 -52
  228. data/lib/generators/robot_lab/templates/robot.rb.tt +0 -31
  229. data/lib/generators/robot_lab/templates/robot_job.rb.tt +0 -18
  230. data/lib/generators/robot_lab/templates/robot_test.rb.tt +0 -34
  231. data/lib/generators/robot_lab/templates/routing_robot.rb.tt +0 -59
  232. data/lib/generators/robot_lab/templates/thread_model.rb.tt +0 -40
  233. data/lib/robot_lab/document_store.rb +0 -155
  234. data/lib/robot_lab/ractor_boundary.rb +0 -42
  235. data/lib/robot_lab/ractor_job.rb +0 -37
  236. data/lib/robot_lab/ractor_memory_proxy.rb +0 -85
  237. data/lib/robot_lab/ractor_network_scheduler.rb +0 -154
  238. data/lib/robot_lab/ractor_worker_pool.rb +0 -117
  239. data/lib/robot_lab/rails_integration/engine.rb +0 -29
  240. data/lib/robot_lab/rails_integration/job.rb +0 -158
  241. data/lib/robot_lab/rails_integration/railtie.rb +0 -51
  242. data/lib/robot_lab/rails_integration/turbo_stream_callbacks.rb +0 -72
@@ -0,0 +1,3329 @@
1
+
2
+ <!doctype html>
3
+ <html lang="en" class="no-js">
4
+ <head>
5
+
6
+ <meta charset="utf-8">
7
+ <meta name="viewport" content="width=device-width,initial-scale=1">
8
+
9
+ <meta name="description" content="Multi-robot LLM workflow orchestration for Ruby">
10
+
11
+
12
+ <meta name="author" content="Dewayne VanHoozer">
13
+
14
+
15
+ <link rel="canonical" href="https://madbomber.github.io/robot_lab/examples/rails-application/">
16
+
17
+
18
+ <link rel="prev" href="../mcp-server/">
19
+
20
+
21
+
22
+
23
+
24
+
25
+ <link rel="icon" href="../../assets/images/favicon.png">
26
+ <meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.1">
27
+
28
+
29
+
30
+ <title>Rails Application - RobotLab</title>
31
+
32
+
33
+
34
+ <link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">
35
+
36
+
37
+ <link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">
38
+
39
+
40
+
41
+
42
+
43
+
44
+
45
+
46
+
47
+
48
+
49
+
50
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
51
+ <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
52
+ <style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>
53
+
54
+
55
+
56
+ <link rel="stylesheet" href="../../assets/css/custom.css">
57
+
58
+ <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
59
+
60
+
61
+
62
+
63
+
64
+
65
+
66
+ </head>
67
+
68
+
69
+
70
+
71
+
72
+
73
+
74
+
75
+
76
+ <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-purple" data-md-color-accent="amber">
77
+
78
+
79
+ <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
80
+ <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
81
+ <label class="md-overlay" for="__drawer"></label>
82
+ <div data-md-component="skip">
83
+
84
+
85
+ <a href="#rails-application" class="md-skip">
86
+ Skip to content
87
+ </a>
88
+
89
+ </div>
90
+ <div data-md-component="announce">
91
+
92
+ </div>
93
+
94
+
95
+
96
+
97
+
98
+
99
+ <header class="md-header md-header--shadow md-header--lifted" data-md-component="header">
100
+ <nav class="md-header__inner md-grid" aria-label="Header">
101
+ <a href="../.." title="RobotLab" class="md-header__button md-logo" aria-label="RobotLab" data-md-component="logo">
102
+
103
+
104
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2a2 2 0 0 1 2 2c0 .74-.4 1.39-1 1.73V7h1a7 7 0 0 1 7 7h1a1 1 0 0 1 1 1v3a1 1 0 0 1-1 1h-1v1a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-1H2a1 1 0 0 1-1-1v-3a1 1 0 0 1 1-1h1a7 7 0 0 1 7-7h1V5.73c-.6-.34-1-.99-1-1.73a2 2 0 0 1 2-2M7.5 13A2.5 2.5 0 0 0 5 15.5 2.5 2.5 0 0 0 7.5 18a2.5 2.5 0 0 0 2.5-2.5A2.5 2.5 0 0 0 7.5 13m9 0a2.5 2.5 0 0 0-2.5 2.5 2.5 2.5 0 0 0 2.5 2.5 2.5 2.5 0 0 0 2.5-2.5 2.5 2.5 0 0 0-2.5-2.5"/></svg>
105
+
106
+ </a>
107
+ <label class="md-header__button md-icon" for="__drawer">
108
+
109
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>
110
+ </label>
111
+ <div class="md-header__title" data-md-component="header-title">
112
+ <div class="md-header__ellipsis">
113
+ <div class="md-header__topic">
114
+ <span class="md-ellipsis">
115
+ RobotLab
116
+ </span>
117
+ </div>
118
+ <div class="md-header__topic" data-md-component="header-topic">
119
+ <span class="md-ellipsis">
120
+
121
+ Rails Application
122
+
123
+ </span>
124
+ </div>
125
+ </div>
126
+ </div>
127
+
128
+
129
+ <form class="md-header__option" data-md-component="palette">
130
+
131
+
132
+
133
+
134
+ <input class="md-option" data-md-color-media="" data-md-color-scheme="default" data-md-color-primary="deep-purple" data-md-color-accent="amber" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_0">
135
+
136
+ <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
137
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
138
+ </label>
139
+
140
+
141
+
142
+
143
+
144
+ <input class="md-option" data-md-color-media="" data-md-color-scheme="slate" data-md-color-primary="deep-purple" data-md-color-accent="amber" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_1">
145
+
146
+ <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
147
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>
148
+ </label>
149
+
150
+
151
+ </form>
152
+
153
+
154
+
155
+ <script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
156
+
157
+
158
+
159
+
160
+
161
+ <label class="md-header__button md-icon" for="__search">
162
+
163
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
164
+ </label>
165
+ <div class="md-search" data-md-component="search" role="dialog">
166
+ <label class="md-search__overlay" for="__search"></label>
167
+ <div class="md-search__inner" role="search">
168
+ <form class="md-search__form" name="search">
169
+ <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
170
+ <label class="md-search__icon md-icon" for="__search">
171
+
172
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>
173
+
174
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
175
+ </label>
176
+ <nav class="md-search__options" aria-label="Search">
177
+
178
+ <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
179
+
180
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
181
+ </a>
182
+
183
+ <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
184
+
185
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
186
+ </button>
187
+ </nav>
188
+
189
+ <div class="md-search__suggest" data-md-component="search-suggest"></div>
190
+
191
+ </form>
192
+ <div class="md-search__output">
193
+ <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
194
+ <div class="md-search-result" data-md-component="search-result">
195
+ <div class="md-search-result__meta">
196
+ Initializing search
197
+ </div>
198
+ <ol class="md-search-result__list" role="presentation"></ol>
199
+ </div>
200
+ </div>
201
+ </div>
202
+ </div>
203
+ </div>
204
+
205
+
206
+
207
+ <div class="md-header__source">
208
+ <a href="https://github.com/madbomber/robot_lab" title="Go to repository" class="md-source" data-md-component="source">
209
+ <div class="md-source__icon md-icon">
210
+
211
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
212
+ </div>
213
+ <div class="md-source__repository">
214
+ madbomber/robot_lab
215
+ </div>
216
+ </a>
217
+ </div>
218
+
219
+ </nav>
220
+
221
+
222
+
223
+ <nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
224
+ <div class="md-grid">
225
+ <ul class="md-tabs__list">
226
+
227
+
228
+
229
+
230
+
231
+
232
+
233
+
234
+ <li class="md-tabs__item">
235
+ <a href="../.." class="md-tabs__link">
236
+
237
+
238
+
239
+
240
+
241
+ Home
242
+
243
+ </a>
244
+ </li>
245
+
246
+
247
+
248
+
249
+
250
+
251
+
252
+
253
+
254
+
255
+
256
+ <li class="md-tabs__item">
257
+ <a href="../../getting-started/" class="md-tabs__link">
258
+
259
+
260
+
261
+
262
+
263
+ Getting Started
264
+
265
+ </a>
266
+ </li>
267
+
268
+
269
+
270
+
271
+
272
+
273
+
274
+
275
+
276
+
277
+
278
+ <li class="md-tabs__item">
279
+ <a href="../../architecture/" class="md-tabs__link">
280
+
281
+
282
+
283
+
284
+
285
+ Architecture
286
+
287
+ </a>
288
+ </li>
289
+
290
+
291
+
292
+
293
+
294
+
295
+
296
+
297
+
298
+
299
+
300
+ <li class="md-tabs__item">
301
+ <a href="../../guides/" class="md-tabs__link">
302
+
303
+
304
+
305
+
306
+
307
+ Guides
308
+
309
+ </a>
310
+ </li>
311
+
312
+
313
+
314
+
315
+
316
+
317
+
318
+
319
+
320
+
321
+
322
+ <li class="md-tabs__item">
323
+ <a href="../../api/" class="md-tabs__link">
324
+
325
+
326
+
327
+
328
+
329
+ API Reference
330
+
331
+ </a>
332
+ </li>
333
+
334
+
335
+
336
+
337
+
338
+
339
+
340
+
341
+
342
+
343
+
344
+
345
+
346
+ <li class="md-tabs__item md-tabs__item--active">
347
+ <a href="../" class="md-tabs__link">
348
+
349
+
350
+
351
+
352
+
353
+ Examples
354
+
355
+ </a>
356
+ </li>
357
+
358
+
359
+
360
+
361
+ </ul>
362
+ </div>
363
+ </nav>
364
+
365
+
366
+ </header>
367
+
368
+ <div class="md-container" data-md-component="container">
369
+
370
+
371
+
372
+
373
+ <main class="md-main" data-md-component="main">
374
+ <div class="md-main__inner md-grid">
375
+
376
+
377
+
378
+ <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
379
+ <div class="md-sidebar__scrollwrap">
380
+ <div class="md-sidebar__inner">
381
+
382
+
383
+
384
+
385
+
386
+
387
+ <nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
388
+ <label class="md-nav__title" for="__drawer">
389
+ <a href="../.." title="RobotLab" class="md-nav__button md-logo" aria-label="RobotLab" data-md-component="logo">
390
+
391
+
392
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 2a2 2 0 0 1 2 2c0 .74-.4 1.39-1 1.73V7h1a7 7 0 0 1 7 7h1a1 1 0 0 1 1 1v3a1 1 0 0 1-1 1h-1v1a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2v-1H2a1 1 0 0 1-1-1v-3a1 1 0 0 1 1-1h1a7 7 0 0 1 7-7h1V5.73c-.6-.34-1-.99-1-1.73a2 2 0 0 1 2-2M7.5 13A2.5 2.5 0 0 0 5 15.5 2.5 2.5 0 0 0 7.5 18a2.5 2.5 0 0 0 2.5-2.5A2.5 2.5 0 0 0 7.5 13m9 0a2.5 2.5 0 0 0-2.5 2.5 2.5 2.5 0 0 0 2.5 2.5 2.5 2.5 0 0 0 2.5-2.5 2.5 2.5 0 0 0-2.5-2.5"/></svg>
393
+
394
+ </a>
395
+ RobotLab
396
+ </label>
397
+
398
+ <div class="md-nav__source">
399
+ <a href="https://github.com/madbomber/robot_lab" title="Go to repository" class="md-source" data-md-component="source">
400
+ <div class="md-source__icon md-icon">
401
+
402
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
403
+ </div>
404
+ <div class="md-source__repository">
405
+ madbomber/robot_lab
406
+ </div>
407
+ </a>
408
+ </div>
409
+
410
+ <ul class="md-nav__list" data-md-scrollfix>
411
+
412
+
413
+
414
+
415
+
416
+
417
+
418
+
419
+
420
+
421
+
422
+
423
+
424
+
425
+
426
+
427
+
428
+
429
+
430
+
431
+
432
+
433
+
434
+ <li class="md-nav__item md-nav__item--nested">
435
+
436
+
437
+
438
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_1" >
439
+
440
+
441
+ <div class="md-nav__link md-nav__container">
442
+ <a href="../.." class="md-nav__link ">
443
+
444
+
445
+
446
+ <span class="md-ellipsis">
447
+
448
+
449
+ Home
450
+
451
+
452
+
453
+ </span>
454
+
455
+
456
+
457
+ </a>
458
+
459
+
460
+ <label class="md-nav__link " for="__nav_1" id="__nav_1_label" tabindex="0">
461
+ <span class="md-nav__icon md-icon"></span>
462
+ </label>
463
+
464
+ </div>
465
+
466
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_1_label" aria-expanded="false">
467
+ <label class="md-nav__title" for="__nav_1">
468
+ <span class="md-nav__icon md-icon"></span>
469
+
470
+
471
+ Home
472
+
473
+
474
+ </label>
475
+ <ul class="md-nav__list" data-md-scrollfix>
476
+
477
+
478
+
479
+
480
+
481
+
482
+
483
+
484
+
485
+ <li class="md-nav__item">
486
+ <a href="../../concepts/" class="md-nav__link">
487
+
488
+
489
+
490
+ <span class="md-ellipsis">
491
+
492
+
493
+ Concepts
494
+
495
+
496
+
497
+ </span>
498
+
499
+
500
+
501
+ </a>
502
+ </li>
503
+
504
+
505
+
506
+
507
+ </ul>
508
+ </nav>
509
+
510
+ </li>
511
+
512
+
513
+
514
+
515
+
516
+
517
+
518
+
519
+
520
+
521
+
522
+
523
+
524
+
525
+
526
+
527
+
528
+
529
+
530
+
531
+
532
+
533
+
534
+
535
+
536
+
537
+
538
+
539
+
540
+ <li class="md-nav__item md-nav__item--nested">
541
+
542
+
543
+
544
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" >
545
+
546
+
547
+ <div class="md-nav__link md-nav__container">
548
+ <a href="../../getting-started/" class="md-nav__link ">
549
+
550
+
551
+
552
+ <span class="md-ellipsis">
553
+
554
+
555
+ Getting Started
556
+
557
+
558
+
559
+ </span>
560
+
561
+
562
+
563
+ </a>
564
+
565
+
566
+ <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="0">
567
+ <span class="md-nav__icon md-icon"></span>
568
+ </label>
569
+
570
+ </div>
571
+
572
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
573
+ <label class="md-nav__title" for="__nav_2">
574
+ <span class="md-nav__icon md-icon"></span>
575
+
576
+
577
+ Getting Started
578
+
579
+
580
+ </label>
581
+ <ul class="md-nav__list" data-md-scrollfix>
582
+
583
+
584
+
585
+
586
+
587
+
588
+
589
+
590
+
591
+ <li class="md-nav__item">
592
+ <a href="../../getting-started/installation/" class="md-nav__link">
593
+
594
+
595
+
596
+ <span class="md-ellipsis">
597
+
598
+
599
+ Installation
600
+
601
+
602
+
603
+ </span>
604
+
605
+
606
+
607
+ </a>
608
+ </li>
609
+
610
+
611
+
612
+
613
+
614
+
615
+
616
+
617
+
618
+
619
+ <li class="md-nav__item">
620
+ <a href="../../getting-started/quick-start/" class="md-nav__link">
621
+
622
+
623
+
624
+ <span class="md-ellipsis">
625
+
626
+
627
+ Quick Start
628
+
629
+
630
+
631
+ </span>
632
+
633
+
634
+
635
+ </a>
636
+ </li>
637
+
638
+
639
+
640
+
641
+
642
+
643
+
644
+
645
+
646
+
647
+ <li class="md-nav__item">
648
+ <a href="../../getting-started/configuration/" class="md-nav__link">
649
+
650
+
651
+
652
+ <span class="md-ellipsis">
653
+
654
+
655
+ Configuration
656
+
657
+
658
+
659
+ </span>
660
+
661
+
662
+
663
+ </a>
664
+ </li>
665
+
666
+
667
+
668
+
669
+ </ul>
670
+ </nav>
671
+
672
+ </li>
673
+
674
+
675
+
676
+
677
+
678
+
679
+
680
+
681
+
682
+
683
+
684
+
685
+
686
+
687
+
688
+
689
+
690
+
691
+
692
+
693
+
694
+
695
+
696
+
697
+
698
+
699
+
700
+
701
+
702
+
703
+
704
+
705
+
706
+ <li class="md-nav__item md-nav__item--nested">
707
+
708
+
709
+
710
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" >
711
+
712
+
713
+ <div class="md-nav__link md-nav__container">
714
+ <a href="../../architecture/" class="md-nav__link ">
715
+
716
+
717
+
718
+ <span class="md-ellipsis">
719
+
720
+
721
+ Architecture
722
+
723
+
724
+
725
+ </span>
726
+
727
+
728
+
729
+ </a>
730
+
731
+
732
+ <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="0">
733
+ <span class="md-nav__icon md-icon"></span>
734
+ </label>
735
+
736
+ </div>
737
+
738
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
739
+ <label class="md-nav__title" for="__nav_3">
740
+ <span class="md-nav__icon md-icon"></span>
741
+
742
+
743
+ Architecture
744
+
745
+
746
+ </label>
747
+ <ul class="md-nav__list" data-md-scrollfix>
748
+
749
+
750
+
751
+
752
+
753
+
754
+
755
+
756
+
757
+ <li class="md-nav__item">
758
+ <a href="../../architecture/core-concepts/" class="md-nav__link">
759
+
760
+
761
+
762
+ <span class="md-ellipsis">
763
+
764
+
765
+ Core Concepts
766
+
767
+
768
+
769
+ </span>
770
+
771
+
772
+
773
+ </a>
774
+ </li>
775
+
776
+
777
+
778
+
779
+
780
+
781
+
782
+
783
+
784
+
785
+ <li class="md-nav__item">
786
+ <a href="../../architecture/robot-execution/" class="md-nav__link">
787
+
788
+
789
+
790
+ <span class="md-ellipsis">
791
+
792
+
793
+ Robot Execution
794
+
795
+
796
+
797
+ </span>
798
+
799
+
800
+
801
+ </a>
802
+ </li>
803
+
804
+
805
+
806
+
807
+
808
+
809
+
810
+
811
+
812
+
813
+ <li class="md-nav__item">
814
+ <a href="../../architecture/network-orchestration/" class="md-nav__link">
815
+
816
+
817
+
818
+ <span class="md-ellipsis">
819
+
820
+
821
+ Network Orchestration
822
+
823
+
824
+
825
+ </span>
826
+
827
+
828
+
829
+ </a>
830
+ </li>
831
+
832
+
833
+
834
+
835
+
836
+
837
+
838
+
839
+
840
+
841
+ <li class="md-nav__item">
842
+ <a href="../../architecture/state-management/" class="md-nav__link">
843
+
844
+
845
+
846
+ <span class="md-ellipsis">
847
+
848
+
849
+ State Management
850
+
851
+
852
+
853
+ </span>
854
+
855
+
856
+
857
+ </a>
858
+ </li>
859
+
860
+
861
+
862
+
863
+
864
+
865
+
866
+
867
+
868
+
869
+ <li class="md-nav__item">
870
+ <a href="../../architecture/message-flow/" class="md-nav__link">
871
+
872
+
873
+
874
+ <span class="md-ellipsis">
875
+
876
+
877
+ Message Flow
878
+
879
+
880
+
881
+ </span>
882
+
883
+
884
+
885
+ </a>
886
+ </li>
887
+
888
+
889
+
890
+
891
+ </ul>
892
+ </nav>
893
+
894
+ </li>
895
+
896
+
897
+
898
+
899
+
900
+
901
+
902
+
903
+
904
+
905
+
906
+
907
+
908
+
909
+
910
+
911
+
912
+
913
+
914
+
915
+
916
+
917
+
918
+
919
+
920
+
921
+
922
+
923
+
924
+
925
+
926
+
927
+
928
+
929
+
930
+
931
+
932
+ <li class="md-nav__item md-nav__item--nested">
933
+
934
+
935
+
936
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" >
937
+
938
+
939
+ <div class="md-nav__link md-nav__container">
940
+ <a href="../../guides/" class="md-nav__link ">
941
+
942
+
943
+
944
+ <span class="md-ellipsis">
945
+
946
+
947
+ Guides
948
+
949
+
950
+
951
+ </span>
952
+
953
+
954
+
955
+ </a>
956
+
957
+
958
+ <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="0">
959
+ <span class="md-nav__icon md-icon"></span>
960
+ </label>
961
+
962
+ </div>
963
+
964
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
965
+ <label class="md-nav__title" for="__nav_4">
966
+ <span class="md-nav__icon md-icon"></span>
967
+
968
+
969
+ Guides
970
+
971
+
972
+ </label>
973
+ <ul class="md-nav__list" data-md-scrollfix>
974
+
975
+
976
+
977
+
978
+
979
+
980
+
981
+
982
+
983
+ <li class="md-nav__item">
984
+ <a href="../../guides/building-robots/" class="md-nav__link">
985
+
986
+
987
+
988
+ <span class="md-ellipsis">
989
+
990
+
991
+ Building Robots
992
+
993
+
994
+
995
+ </span>
996
+
997
+
998
+
999
+ </a>
1000
+ </li>
1001
+
1002
+
1003
+
1004
+
1005
+
1006
+
1007
+
1008
+
1009
+
1010
+
1011
+ <li class="md-nav__item">
1012
+ <a href="../../guides/creating-networks/" class="md-nav__link">
1013
+
1014
+
1015
+
1016
+ <span class="md-ellipsis">
1017
+
1018
+
1019
+ Creating Networks
1020
+
1021
+
1022
+
1023
+ </span>
1024
+
1025
+
1026
+
1027
+ </a>
1028
+ </li>
1029
+
1030
+
1031
+
1032
+
1033
+
1034
+
1035
+
1036
+
1037
+
1038
+
1039
+ <li class="md-nav__item">
1040
+ <a href="../../guides/using-tools/" class="md-nav__link">
1041
+
1042
+
1043
+
1044
+ <span class="md-ellipsis">
1045
+
1046
+
1047
+ Using Tools
1048
+
1049
+
1050
+
1051
+ </span>
1052
+
1053
+
1054
+
1055
+ </a>
1056
+ </li>
1057
+
1058
+
1059
+
1060
+
1061
+
1062
+
1063
+
1064
+
1065
+
1066
+
1067
+ <li class="md-nav__item">
1068
+ <a href="../../guides/mcp-integration/" class="md-nav__link">
1069
+
1070
+
1071
+
1072
+ <span class="md-ellipsis">
1073
+
1074
+
1075
+ MCP Integration
1076
+
1077
+
1078
+
1079
+ </span>
1080
+
1081
+
1082
+
1083
+ </a>
1084
+ </li>
1085
+
1086
+
1087
+
1088
+
1089
+
1090
+
1091
+
1092
+
1093
+
1094
+
1095
+ <li class="md-nav__item">
1096
+ <a href="../../guides/streaming/" class="md-nav__link">
1097
+
1098
+
1099
+
1100
+ <span class="md-ellipsis">
1101
+
1102
+
1103
+ Streaming Responses
1104
+
1105
+
1106
+
1107
+ </span>
1108
+
1109
+
1110
+
1111
+ </a>
1112
+ </li>
1113
+
1114
+
1115
+
1116
+
1117
+
1118
+
1119
+
1120
+
1121
+
1122
+
1123
+ <li class="md-nav__item">
1124
+ <a href="../../guides/memory/" class="md-nav__link">
1125
+
1126
+
1127
+
1128
+ <span class="md-ellipsis">
1129
+
1130
+
1131
+ Memory System
1132
+
1133
+
1134
+
1135
+ </span>
1136
+
1137
+
1138
+
1139
+ </a>
1140
+ </li>
1141
+
1142
+
1143
+
1144
+
1145
+
1146
+
1147
+
1148
+
1149
+
1150
+
1151
+ <li class="md-nav__item">
1152
+ <a href="../../guides/rails-integration/" class="md-nav__link">
1153
+
1154
+
1155
+
1156
+ <span class="md-ellipsis">
1157
+
1158
+
1159
+ Rails Integration
1160
+
1161
+
1162
+
1163
+ </span>
1164
+
1165
+
1166
+
1167
+ </a>
1168
+ </li>
1169
+
1170
+
1171
+
1172
+
1173
+ </ul>
1174
+ </nav>
1175
+
1176
+ </li>
1177
+
1178
+
1179
+
1180
+
1181
+
1182
+
1183
+
1184
+
1185
+
1186
+
1187
+
1188
+
1189
+
1190
+
1191
+
1192
+
1193
+
1194
+
1195
+
1196
+
1197
+
1198
+
1199
+
1200
+
1201
+
1202
+
1203
+
1204
+
1205
+
1206
+
1207
+
1208
+ <li class="md-nav__item md-nav__item--nested">
1209
+
1210
+
1211
+
1212
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
1213
+
1214
+
1215
+ <div class="md-nav__link md-nav__container">
1216
+ <a href="../../api/" class="md-nav__link ">
1217
+
1218
+
1219
+
1220
+ <span class="md-ellipsis">
1221
+
1222
+
1223
+ API Reference
1224
+
1225
+
1226
+
1227
+ </span>
1228
+
1229
+
1230
+
1231
+ </a>
1232
+
1233
+
1234
+ <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="0">
1235
+ <span class="md-nav__icon md-icon"></span>
1236
+ </label>
1237
+
1238
+ </div>
1239
+
1240
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
1241
+ <label class="md-nav__title" for="__nav_5">
1242
+ <span class="md-nav__icon md-icon"></span>
1243
+
1244
+
1245
+ API Reference
1246
+
1247
+
1248
+ </label>
1249
+ <ul class="md-nav__list" data-md-scrollfix>
1250
+
1251
+
1252
+
1253
+
1254
+
1255
+
1256
+
1257
+
1258
+
1259
+
1260
+
1261
+
1262
+
1263
+
1264
+
1265
+
1266
+
1267
+
1268
+
1269
+
1270
+
1271
+
1272
+
1273
+
1274
+
1275
+
1276
+
1277
+
1278
+
1279
+
1280
+
1281
+
1282
+
1283
+ <li class="md-nav__item md-nav__item--nested">
1284
+
1285
+
1286
+
1287
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_2" >
1288
+
1289
+
1290
+ <div class="md-nav__link md-nav__container">
1291
+ <a href="../../api/core/" class="md-nav__link ">
1292
+
1293
+
1294
+
1295
+ <span class="md-ellipsis">
1296
+
1297
+
1298
+ Core Classes
1299
+
1300
+
1301
+
1302
+ </span>
1303
+
1304
+
1305
+
1306
+ </a>
1307
+
1308
+
1309
+ <label class="md-nav__link " for="__nav_5_2" id="__nav_5_2_label" tabindex="0">
1310
+ <span class="md-nav__icon md-icon"></span>
1311
+ </label>
1312
+
1313
+ </div>
1314
+
1315
+ <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_2_label" aria-expanded="false">
1316
+ <label class="md-nav__title" for="__nav_5_2">
1317
+ <span class="md-nav__icon md-icon"></span>
1318
+
1319
+
1320
+ Core Classes
1321
+
1322
+
1323
+ </label>
1324
+ <ul class="md-nav__list" data-md-scrollfix>
1325
+
1326
+
1327
+
1328
+
1329
+
1330
+
1331
+
1332
+
1333
+
1334
+ <li class="md-nav__item">
1335
+ <a href="../../api/core/robot/" class="md-nav__link">
1336
+
1337
+
1338
+
1339
+ <span class="md-ellipsis">
1340
+
1341
+
1342
+ Robot
1343
+
1344
+
1345
+
1346
+ </span>
1347
+
1348
+
1349
+
1350
+ </a>
1351
+ </li>
1352
+
1353
+
1354
+
1355
+
1356
+
1357
+
1358
+
1359
+
1360
+
1361
+
1362
+ <li class="md-nav__item">
1363
+ <a href="../../api/core/network/" class="md-nav__link">
1364
+
1365
+
1366
+
1367
+ <span class="md-ellipsis">
1368
+
1369
+
1370
+ Network
1371
+
1372
+
1373
+
1374
+ </span>
1375
+
1376
+
1377
+
1378
+ </a>
1379
+ </li>
1380
+
1381
+
1382
+
1383
+
1384
+
1385
+
1386
+
1387
+
1388
+
1389
+
1390
+ <li class="md-nav__item">
1391
+ <a href="../../api/core/state/" class="md-nav__link">
1392
+
1393
+
1394
+
1395
+ <span class="md-ellipsis">
1396
+
1397
+
1398
+ State
1399
+
1400
+
1401
+
1402
+ </span>
1403
+
1404
+
1405
+
1406
+ </a>
1407
+ </li>
1408
+
1409
+
1410
+
1411
+
1412
+
1413
+
1414
+
1415
+
1416
+
1417
+
1418
+ <li class="md-nav__item">
1419
+ <a href="../../api/core/tool/" class="md-nav__link">
1420
+
1421
+
1422
+
1423
+ <span class="md-ellipsis">
1424
+
1425
+
1426
+ Tool
1427
+
1428
+
1429
+
1430
+ </span>
1431
+
1432
+
1433
+
1434
+ </a>
1435
+ </li>
1436
+
1437
+
1438
+
1439
+
1440
+
1441
+
1442
+
1443
+
1444
+
1445
+
1446
+ <li class="md-nav__item">
1447
+ <a href="../../api/core/memory/" class="md-nav__link">
1448
+
1449
+
1450
+
1451
+ <span class="md-ellipsis">
1452
+
1453
+
1454
+ Memory
1455
+
1456
+
1457
+
1458
+ </span>
1459
+
1460
+
1461
+
1462
+ </a>
1463
+ </li>
1464
+
1465
+
1466
+
1467
+
1468
+ </ul>
1469
+ </nav>
1470
+
1471
+ </li>
1472
+
1473
+
1474
+
1475
+
1476
+
1477
+
1478
+
1479
+
1480
+
1481
+
1482
+
1483
+
1484
+
1485
+
1486
+
1487
+
1488
+
1489
+
1490
+
1491
+
1492
+
1493
+
1494
+
1495
+
1496
+
1497
+
1498
+
1499
+
1500
+
1501
+
1502
+
1503
+
1504
+ <li class="md-nav__item md-nav__item--nested">
1505
+
1506
+
1507
+
1508
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_3" >
1509
+
1510
+
1511
+ <div class="md-nav__link md-nav__container">
1512
+ <a href="../../api/messages/" class="md-nav__link ">
1513
+
1514
+
1515
+
1516
+ <span class="md-ellipsis">
1517
+
1518
+
1519
+ Messages
1520
+
1521
+
1522
+
1523
+ </span>
1524
+
1525
+
1526
+
1527
+ </a>
1528
+
1529
+
1530
+ <label class="md-nav__link " for="__nav_5_3" id="__nav_5_3_label" tabindex="0">
1531
+ <span class="md-nav__icon md-icon"></span>
1532
+ </label>
1533
+
1534
+ </div>
1535
+
1536
+ <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_3_label" aria-expanded="false">
1537
+ <label class="md-nav__title" for="__nav_5_3">
1538
+ <span class="md-nav__icon md-icon"></span>
1539
+
1540
+
1541
+ Messages
1542
+
1543
+
1544
+ </label>
1545
+ <ul class="md-nav__list" data-md-scrollfix>
1546
+
1547
+
1548
+
1549
+
1550
+
1551
+
1552
+
1553
+
1554
+
1555
+ <li class="md-nav__item">
1556
+ <a href="../../api/messages/user-message/" class="md-nav__link">
1557
+
1558
+
1559
+
1560
+ <span class="md-ellipsis">
1561
+
1562
+
1563
+ UserMessage
1564
+
1565
+
1566
+
1567
+ </span>
1568
+
1569
+
1570
+
1571
+ </a>
1572
+ </li>
1573
+
1574
+
1575
+
1576
+
1577
+
1578
+
1579
+
1580
+
1581
+
1582
+
1583
+ <li class="md-nav__item">
1584
+ <a href="../../api/messages/text-message/" class="md-nav__link">
1585
+
1586
+
1587
+
1588
+ <span class="md-ellipsis">
1589
+
1590
+
1591
+ TextMessage
1592
+
1593
+
1594
+
1595
+ </span>
1596
+
1597
+
1598
+
1599
+ </a>
1600
+ </li>
1601
+
1602
+
1603
+
1604
+
1605
+
1606
+
1607
+
1608
+
1609
+
1610
+
1611
+ <li class="md-nav__item">
1612
+ <a href="../../api/messages/tool-call-message/" class="md-nav__link">
1613
+
1614
+
1615
+
1616
+ <span class="md-ellipsis">
1617
+
1618
+
1619
+ ToolCallMessage
1620
+
1621
+
1622
+
1623
+ </span>
1624
+
1625
+
1626
+
1627
+ </a>
1628
+ </li>
1629
+
1630
+
1631
+
1632
+
1633
+
1634
+
1635
+
1636
+
1637
+
1638
+
1639
+ <li class="md-nav__item">
1640
+ <a href="../../api/messages/tool-result-message/" class="md-nav__link">
1641
+
1642
+
1643
+
1644
+ <span class="md-ellipsis">
1645
+
1646
+
1647
+ ToolResultMessage
1648
+
1649
+
1650
+
1651
+ </span>
1652
+
1653
+
1654
+
1655
+ </a>
1656
+ </li>
1657
+
1658
+
1659
+
1660
+
1661
+ </ul>
1662
+ </nav>
1663
+
1664
+ </li>
1665
+
1666
+
1667
+
1668
+
1669
+
1670
+
1671
+
1672
+
1673
+
1674
+
1675
+
1676
+
1677
+
1678
+
1679
+
1680
+
1681
+
1682
+
1683
+
1684
+
1685
+
1686
+
1687
+
1688
+
1689
+
1690
+
1691
+
1692
+
1693
+
1694
+
1695
+ <li class="md-nav__item md-nav__item--nested">
1696
+
1697
+
1698
+
1699
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_4" >
1700
+
1701
+
1702
+ <div class="md-nav__link md-nav__container">
1703
+ <a href="../../api/mcp/" class="md-nav__link ">
1704
+
1705
+
1706
+
1707
+ <span class="md-ellipsis">
1708
+
1709
+
1710
+ MCP
1711
+
1712
+
1713
+
1714
+ </span>
1715
+
1716
+
1717
+
1718
+ </a>
1719
+
1720
+
1721
+ <label class="md-nav__link " for="__nav_5_4" id="__nav_5_4_label" tabindex="0">
1722
+ <span class="md-nav__icon md-icon"></span>
1723
+ </label>
1724
+
1725
+ </div>
1726
+
1727
+ <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_4_label" aria-expanded="false">
1728
+ <label class="md-nav__title" for="__nav_5_4">
1729
+ <span class="md-nav__icon md-icon"></span>
1730
+
1731
+
1732
+ MCP
1733
+
1734
+
1735
+ </label>
1736
+ <ul class="md-nav__list" data-md-scrollfix>
1737
+
1738
+
1739
+
1740
+
1741
+
1742
+
1743
+
1744
+
1745
+
1746
+ <li class="md-nav__item">
1747
+ <a href="../../api/mcp/client/" class="md-nav__link">
1748
+
1749
+
1750
+
1751
+ <span class="md-ellipsis">
1752
+
1753
+
1754
+ Client
1755
+
1756
+
1757
+
1758
+ </span>
1759
+
1760
+
1761
+
1762
+ </a>
1763
+ </li>
1764
+
1765
+
1766
+
1767
+
1768
+
1769
+
1770
+
1771
+
1772
+
1773
+
1774
+ <li class="md-nav__item">
1775
+ <a href="../../api/mcp/server/" class="md-nav__link">
1776
+
1777
+
1778
+
1779
+ <span class="md-ellipsis">
1780
+
1781
+
1782
+ Server
1783
+
1784
+
1785
+
1786
+ </span>
1787
+
1788
+
1789
+
1790
+ </a>
1791
+ </li>
1792
+
1793
+
1794
+
1795
+
1796
+
1797
+
1798
+
1799
+
1800
+
1801
+
1802
+ <li class="md-nav__item">
1803
+ <a href="../../api/mcp/transports/" class="md-nav__link">
1804
+
1805
+
1806
+
1807
+ <span class="md-ellipsis">
1808
+
1809
+
1810
+ Transports
1811
+
1812
+
1813
+
1814
+ </span>
1815
+
1816
+
1817
+
1818
+ </a>
1819
+ </li>
1820
+
1821
+
1822
+
1823
+
1824
+ </ul>
1825
+ </nav>
1826
+
1827
+ </li>
1828
+
1829
+
1830
+
1831
+
1832
+
1833
+
1834
+
1835
+
1836
+
1837
+
1838
+
1839
+
1840
+
1841
+
1842
+
1843
+
1844
+
1845
+
1846
+
1847
+
1848
+
1849
+
1850
+
1851
+
1852
+
1853
+
1854
+
1855
+
1856
+ <li class="md-nav__item md-nav__item--nested">
1857
+
1858
+
1859
+
1860
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5_5" >
1861
+
1862
+
1863
+ <div class="md-nav__link md-nav__container">
1864
+ <a href="../../api/streaming/" class="md-nav__link ">
1865
+
1866
+
1867
+
1868
+ <span class="md-ellipsis">
1869
+
1870
+
1871
+ Streaming
1872
+
1873
+
1874
+
1875
+ </span>
1876
+
1877
+
1878
+
1879
+ </a>
1880
+
1881
+
1882
+ <label class="md-nav__link " for="__nav_5_5" id="__nav_5_5_label" tabindex="0">
1883
+ <span class="md-nav__icon md-icon"></span>
1884
+ </label>
1885
+
1886
+ </div>
1887
+
1888
+ <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_5_5_label" aria-expanded="false">
1889
+ <label class="md-nav__title" for="__nav_5_5">
1890
+ <span class="md-nav__icon md-icon"></span>
1891
+
1892
+
1893
+ Streaming
1894
+
1895
+
1896
+ </label>
1897
+ <ul class="md-nav__list" data-md-scrollfix>
1898
+
1899
+
1900
+
1901
+
1902
+
1903
+
1904
+
1905
+
1906
+
1907
+ <li class="md-nav__item">
1908
+ <a href="../../api/streaming/context/" class="md-nav__link">
1909
+
1910
+
1911
+
1912
+ <span class="md-ellipsis">
1913
+
1914
+
1915
+ Context
1916
+
1917
+
1918
+
1919
+ </span>
1920
+
1921
+
1922
+
1923
+ </a>
1924
+ </li>
1925
+
1926
+
1927
+
1928
+
1929
+
1930
+
1931
+
1932
+
1933
+
1934
+
1935
+ <li class="md-nav__item">
1936
+ <a href="../../api/streaming/events/" class="md-nav__link">
1937
+
1938
+
1939
+
1940
+ <span class="md-ellipsis">
1941
+
1942
+
1943
+ Events
1944
+
1945
+
1946
+
1947
+ </span>
1948
+
1949
+
1950
+
1951
+ </a>
1952
+ </li>
1953
+
1954
+
1955
+
1956
+
1957
+ </ul>
1958
+ </nav>
1959
+
1960
+ </li>
1961
+
1962
+
1963
+
1964
+
1965
+ </ul>
1966
+ </nav>
1967
+
1968
+ </li>
1969
+
1970
+
1971
+
1972
+
1973
+
1974
+
1975
+
1976
+
1977
+
1978
+
1979
+
1980
+
1981
+
1982
+
1983
+
1984
+
1985
+
1986
+
1987
+
1988
+
1989
+
1990
+
1991
+
1992
+
1993
+
1994
+
1995
+
1996
+
1997
+
1998
+
1999
+
2000
+
2001
+
2002
+
2003
+
2004
+
2005
+
2006
+
2007
+ <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
2008
+
2009
+
2010
+
2011
+ <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
2012
+
2013
+
2014
+ <div class="md-nav__link md-nav__container">
2015
+ <a href="../" class="md-nav__link ">
2016
+
2017
+
2018
+
2019
+ <span class="md-ellipsis">
2020
+
2021
+
2022
+ Examples
2023
+
2024
+
2025
+
2026
+ </span>
2027
+
2028
+
2029
+
2030
+ </a>
2031
+
2032
+
2033
+ <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
2034
+ <span class="md-nav__icon md-icon"></span>
2035
+ </label>
2036
+
2037
+ </div>
2038
+
2039
+ <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
2040
+ <label class="md-nav__title" for="__nav_6">
2041
+ <span class="md-nav__icon md-icon"></span>
2042
+
2043
+
2044
+ Examples
2045
+
2046
+
2047
+ </label>
2048
+ <ul class="md-nav__list" data-md-scrollfix>
2049
+
2050
+
2051
+
2052
+
2053
+
2054
+
2055
+
2056
+
2057
+
2058
+ <li class="md-nav__item">
2059
+ <a href="../basic-chat/" class="md-nav__link">
2060
+
2061
+
2062
+
2063
+ <span class="md-ellipsis">
2064
+
2065
+
2066
+ Basic Chat
2067
+
2068
+
2069
+
2070
+ </span>
2071
+
2072
+
2073
+
2074
+ </a>
2075
+ </li>
2076
+
2077
+
2078
+
2079
+
2080
+
2081
+
2082
+
2083
+
2084
+
2085
+
2086
+ <li class="md-nav__item">
2087
+ <a href="../multi-robot-network/" class="md-nav__link">
2088
+
2089
+
2090
+
2091
+ <span class="md-ellipsis">
2092
+
2093
+
2094
+ Multi-Robot Network
2095
+
2096
+
2097
+
2098
+ </span>
2099
+
2100
+
2101
+
2102
+ </a>
2103
+ </li>
2104
+
2105
+
2106
+
2107
+
2108
+
2109
+
2110
+
2111
+
2112
+
2113
+
2114
+ <li class="md-nav__item">
2115
+ <a href="../tool-usage/" class="md-nav__link">
2116
+
2117
+
2118
+
2119
+ <span class="md-ellipsis">
2120
+
2121
+
2122
+ Tool Usage
2123
+
2124
+
2125
+
2126
+ </span>
2127
+
2128
+
2129
+
2130
+ </a>
2131
+ </li>
2132
+
2133
+
2134
+
2135
+
2136
+
2137
+
2138
+
2139
+
2140
+
2141
+
2142
+ <li class="md-nav__item">
2143
+ <a href="../mcp-server/" class="md-nav__link">
2144
+
2145
+
2146
+
2147
+ <span class="md-ellipsis">
2148
+
2149
+
2150
+ MCP Server
2151
+
2152
+
2153
+
2154
+ </span>
2155
+
2156
+
2157
+
2158
+ </a>
2159
+ </li>
2160
+
2161
+
2162
+
2163
+
2164
+
2165
+
2166
+
2167
+
2168
+
2169
+
2170
+
2171
+
2172
+ <li class="md-nav__item md-nav__item--active">
2173
+
2174
+ <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
2175
+
2176
+
2177
+
2178
+
2179
+
2180
+ <label class="md-nav__link md-nav__link--active" for="__toc">
2181
+
2182
+
2183
+
2184
+ <span class="md-ellipsis">
2185
+
2186
+
2187
+ Rails Application
2188
+
2189
+
2190
+
2191
+ </span>
2192
+
2193
+
2194
+
2195
+ <span class="md-nav__icon md-icon"></span>
2196
+ </label>
2197
+
2198
+ <a href="./" class="md-nav__link md-nav__link--active">
2199
+
2200
+
2201
+
2202
+ <span class="md-ellipsis">
2203
+
2204
+
2205
+ Rails Application
2206
+
2207
+
2208
+
2209
+ </span>
2210
+
2211
+
2212
+
2213
+ </a>
2214
+
2215
+
2216
+
2217
+
2218
+
2219
+ <nav class="md-nav md-nav--secondary" aria-label="On this page">
2220
+
2221
+
2222
+
2223
+
2224
+
2225
+
2226
+ <label class="md-nav__title" for="__toc">
2227
+ <span class="md-nav__icon md-icon"></span>
2228
+ On this page
2229
+ </label>
2230
+ <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
2231
+
2232
+ <li class="md-nav__item">
2233
+ <a href="#overview" class="md-nav__link">
2234
+ <span class="md-ellipsis">
2235
+
2236
+ Overview
2237
+
2238
+ </span>
2239
+ </a>
2240
+
2241
+ </li>
2242
+
2243
+ <li class="md-nav__item">
2244
+ <a href="#setup" class="md-nav__link">
2245
+ <span class="md-ellipsis">
2246
+
2247
+ Setup
2248
+
2249
+ </span>
2250
+ </a>
2251
+
2252
+ <nav class="md-nav" aria-label="Setup">
2253
+ <ul class="md-nav__list">
2254
+
2255
+ <li class="md-nav__item">
2256
+ <a href="#1-add-to-gemfile" class="md-nav__link">
2257
+ <span class="md-ellipsis">
2258
+
2259
+ 1. Add to Gemfile
2260
+
2261
+ </span>
2262
+ </a>
2263
+
2264
+ </li>
2265
+
2266
+ <li class="md-nav__item">
2267
+ <a href="#2-run-generator" class="md-nav__link">
2268
+ <span class="md-ellipsis">
2269
+
2270
+ 2. Run Generator
2271
+
2272
+ </span>
2273
+ </a>
2274
+
2275
+ </li>
2276
+
2277
+ <li class="md-nav__item">
2278
+ <a href="#3-run-migrations" class="md-nav__link">
2279
+ <span class="md-ellipsis">
2280
+
2281
+ 3. Run Migrations
2282
+
2283
+ </span>
2284
+ </a>
2285
+
2286
+ </li>
2287
+
2288
+ </ul>
2289
+ </nav>
2290
+
2291
+ </li>
2292
+
2293
+ <li class="md-nav__item">
2294
+ <a href="#configuration" class="md-nav__link">
2295
+ <span class="md-ellipsis">
2296
+
2297
+ Configuration
2298
+
2299
+ </span>
2300
+ </a>
2301
+
2302
+ <nav class="md-nav" aria-label="Configuration">
2303
+ <ul class="md-nav__list">
2304
+
2305
+ <li class="md-nav__item">
2306
+ <a href="#config-file" class="md-nav__link">
2307
+ <span class="md-ellipsis">
2308
+
2309
+ Config File
2310
+
2311
+ </span>
2312
+ </a>
2313
+
2314
+ </li>
2315
+
2316
+ <li class="md-nav__item">
2317
+ <a href="#environment-variables" class="md-nav__link">
2318
+ <span class="md-ellipsis">
2319
+
2320
+ Environment Variables
2321
+
2322
+ </span>
2323
+ </a>
2324
+
2325
+ </li>
2326
+
2327
+ <li class="md-nav__item">
2328
+ <a href="#accessing-configuration" class="md-nav__link">
2329
+ <span class="md-ellipsis">
2330
+
2331
+ Accessing Configuration
2332
+
2333
+ </span>
2334
+ </a>
2335
+
2336
+ </li>
2337
+
2338
+ <li class="md-nav__item">
2339
+ <a href="#rails-engine-and-railtie" class="md-nav__link">
2340
+ <span class="md-ellipsis">
2341
+
2342
+ Rails Engine and Railtie
2343
+
2344
+ </span>
2345
+ </a>
2346
+
2347
+ </li>
2348
+
2349
+ </ul>
2350
+ </nav>
2351
+
2352
+ </li>
2353
+
2354
+ <li class="md-nav__item">
2355
+ <a href="#models" class="md-nav__link">
2356
+ <span class="md-ellipsis">
2357
+
2358
+ Models
2359
+
2360
+ </span>
2361
+ </a>
2362
+
2363
+ </li>
2364
+
2365
+ <li class="md-nav__item">
2366
+ <a href="#robot-definitions" class="md-nav__link">
2367
+ <span class="md-ellipsis">
2368
+
2369
+ Robot Definitions
2370
+
2371
+ </span>
2372
+ </a>
2373
+
2374
+ </li>
2375
+
2376
+ <li class="md-nav__item">
2377
+ <a href="#network-configuration" class="md-nav__link">
2378
+ <span class="md-ellipsis">
2379
+
2380
+ Network Configuration
2381
+
2382
+ </span>
2383
+ </a>
2384
+
2385
+ </li>
2386
+
2387
+ <li class="md-nav__item">
2388
+ <a href="#service-object" class="md-nav__link">
2389
+ <span class="md-ellipsis">
2390
+
2391
+ Service Object
2392
+
2393
+ </span>
2394
+ </a>
2395
+
2396
+ </li>
2397
+
2398
+ <li class="md-nav__item">
2399
+ <a href="#controller" class="md-nav__link">
2400
+ <span class="md-ellipsis">
2401
+
2402
+ Controller
2403
+
2404
+ </span>
2405
+ </a>
2406
+
2407
+ </li>
2408
+
2409
+ <li class="md-nav__item">
2410
+ <a href="#action-cable-integration" class="md-nav__link">
2411
+ <span class="md-ellipsis">
2412
+
2413
+ Action Cable Integration
2414
+
2415
+ </span>
2416
+ </a>
2417
+
2418
+ </li>
2419
+
2420
+ <li class="md-nav__item">
2421
+ <a href="#frontend-stimulus" class="md-nav__link">
2422
+ <span class="md-ellipsis">
2423
+
2424
+ Frontend (Stimulus)
2425
+
2426
+ </span>
2427
+ </a>
2428
+
2429
+ </li>
2430
+
2431
+ <li class="md-nav__item">
2432
+ <a href="#view" class="md-nav__link">
2433
+ <span class="md-ellipsis">
2434
+
2435
+ View
2436
+
2437
+ </span>
2438
+ </a>
2439
+
2440
+ </li>
2441
+
2442
+ <li class="md-nav__item">
2443
+ <a href="#running" class="md-nav__link">
2444
+ <span class="md-ellipsis">
2445
+
2446
+ Running
2447
+
2448
+ </span>
2449
+ </a>
2450
+
2451
+ </li>
2452
+
2453
+ <li class="md-nav__item">
2454
+ <a href="#key-concepts" class="md-nav__link">
2455
+ <span class="md-ellipsis">
2456
+
2457
+ Key Concepts
2458
+
2459
+ </span>
2460
+ </a>
2461
+
2462
+ </li>
2463
+
2464
+ <li class="md-nav__item">
2465
+ <a href="#see-also" class="md-nav__link">
2466
+ <span class="md-ellipsis">
2467
+
2468
+ See Also
2469
+
2470
+ </span>
2471
+ </a>
2472
+
2473
+ </li>
2474
+
2475
+ </ul>
2476
+
2477
+ </nav>
2478
+
2479
+ </li>
2480
+
2481
+
2482
+
2483
+
2484
+ </ul>
2485
+ </nav>
2486
+
2487
+ </li>
2488
+
2489
+
2490
+
2491
+ </ul>
2492
+ </nav>
2493
+ </div>
2494
+ </div>
2495
+ </div>
2496
+
2497
+
2498
+
2499
+ <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
2500
+ <div class="md-sidebar__scrollwrap">
2501
+ <div class="md-sidebar__inner">
2502
+
2503
+
2504
+
2505
+
2506
+ <nav class="md-nav md-nav--secondary" aria-label="On this page">
2507
+
2508
+
2509
+
2510
+
2511
+
2512
+
2513
+ <label class="md-nav__title" for="__toc">
2514
+ <span class="md-nav__icon md-icon"></span>
2515
+ On this page
2516
+ </label>
2517
+ <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
2518
+
2519
+ <li class="md-nav__item">
2520
+ <a href="#overview" class="md-nav__link">
2521
+ <span class="md-ellipsis">
2522
+
2523
+ Overview
2524
+
2525
+ </span>
2526
+ </a>
2527
+
2528
+ </li>
2529
+
2530
+ <li class="md-nav__item">
2531
+ <a href="#setup" class="md-nav__link">
2532
+ <span class="md-ellipsis">
2533
+
2534
+ Setup
2535
+
2536
+ </span>
2537
+ </a>
2538
+
2539
+ <nav class="md-nav" aria-label="Setup">
2540
+ <ul class="md-nav__list">
2541
+
2542
+ <li class="md-nav__item">
2543
+ <a href="#1-add-to-gemfile" class="md-nav__link">
2544
+ <span class="md-ellipsis">
2545
+
2546
+ 1. Add to Gemfile
2547
+
2548
+ </span>
2549
+ </a>
2550
+
2551
+ </li>
2552
+
2553
+ <li class="md-nav__item">
2554
+ <a href="#2-run-generator" class="md-nav__link">
2555
+ <span class="md-ellipsis">
2556
+
2557
+ 2. Run Generator
2558
+
2559
+ </span>
2560
+ </a>
2561
+
2562
+ </li>
2563
+
2564
+ <li class="md-nav__item">
2565
+ <a href="#3-run-migrations" class="md-nav__link">
2566
+ <span class="md-ellipsis">
2567
+
2568
+ 3. Run Migrations
2569
+
2570
+ </span>
2571
+ </a>
2572
+
2573
+ </li>
2574
+
2575
+ </ul>
2576
+ </nav>
2577
+
2578
+ </li>
2579
+
2580
+ <li class="md-nav__item">
2581
+ <a href="#configuration" class="md-nav__link">
2582
+ <span class="md-ellipsis">
2583
+
2584
+ Configuration
2585
+
2586
+ </span>
2587
+ </a>
2588
+
2589
+ <nav class="md-nav" aria-label="Configuration">
2590
+ <ul class="md-nav__list">
2591
+
2592
+ <li class="md-nav__item">
2593
+ <a href="#config-file" class="md-nav__link">
2594
+ <span class="md-ellipsis">
2595
+
2596
+ Config File
2597
+
2598
+ </span>
2599
+ </a>
2600
+
2601
+ </li>
2602
+
2603
+ <li class="md-nav__item">
2604
+ <a href="#environment-variables" class="md-nav__link">
2605
+ <span class="md-ellipsis">
2606
+
2607
+ Environment Variables
2608
+
2609
+ </span>
2610
+ </a>
2611
+
2612
+ </li>
2613
+
2614
+ <li class="md-nav__item">
2615
+ <a href="#accessing-configuration" class="md-nav__link">
2616
+ <span class="md-ellipsis">
2617
+
2618
+ Accessing Configuration
2619
+
2620
+ </span>
2621
+ </a>
2622
+
2623
+ </li>
2624
+
2625
+ <li class="md-nav__item">
2626
+ <a href="#rails-engine-and-railtie" class="md-nav__link">
2627
+ <span class="md-ellipsis">
2628
+
2629
+ Rails Engine and Railtie
2630
+
2631
+ </span>
2632
+ </a>
2633
+
2634
+ </li>
2635
+
2636
+ </ul>
2637
+ </nav>
2638
+
2639
+ </li>
2640
+
2641
+ <li class="md-nav__item">
2642
+ <a href="#models" class="md-nav__link">
2643
+ <span class="md-ellipsis">
2644
+
2645
+ Models
2646
+
2647
+ </span>
2648
+ </a>
2649
+
2650
+ </li>
2651
+
2652
+ <li class="md-nav__item">
2653
+ <a href="#robot-definitions" class="md-nav__link">
2654
+ <span class="md-ellipsis">
2655
+
2656
+ Robot Definitions
2657
+
2658
+ </span>
2659
+ </a>
2660
+
2661
+ </li>
2662
+
2663
+ <li class="md-nav__item">
2664
+ <a href="#network-configuration" class="md-nav__link">
2665
+ <span class="md-ellipsis">
2666
+
2667
+ Network Configuration
2668
+
2669
+ </span>
2670
+ </a>
2671
+
2672
+ </li>
2673
+
2674
+ <li class="md-nav__item">
2675
+ <a href="#service-object" class="md-nav__link">
2676
+ <span class="md-ellipsis">
2677
+
2678
+ Service Object
2679
+
2680
+ </span>
2681
+ </a>
2682
+
2683
+ </li>
2684
+
2685
+ <li class="md-nav__item">
2686
+ <a href="#controller" class="md-nav__link">
2687
+ <span class="md-ellipsis">
2688
+
2689
+ Controller
2690
+
2691
+ </span>
2692
+ </a>
2693
+
2694
+ </li>
2695
+
2696
+ <li class="md-nav__item">
2697
+ <a href="#action-cable-integration" class="md-nav__link">
2698
+ <span class="md-ellipsis">
2699
+
2700
+ Action Cable Integration
2701
+
2702
+ </span>
2703
+ </a>
2704
+
2705
+ </li>
2706
+
2707
+ <li class="md-nav__item">
2708
+ <a href="#frontend-stimulus" class="md-nav__link">
2709
+ <span class="md-ellipsis">
2710
+
2711
+ Frontend (Stimulus)
2712
+
2713
+ </span>
2714
+ </a>
2715
+
2716
+ </li>
2717
+
2718
+ <li class="md-nav__item">
2719
+ <a href="#view" class="md-nav__link">
2720
+ <span class="md-ellipsis">
2721
+
2722
+ View
2723
+
2724
+ </span>
2725
+ </a>
2726
+
2727
+ </li>
2728
+
2729
+ <li class="md-nav__item">
2730
+ <a href="#running" class="md-nav__link">
2731
+ <span class="md-ellipsis">
2732
+
2733
+ Running
2734
+
2735
+ </span>
2736
+ </a>
2737
+
2738
+ </li>
2739
+
2740
+ <li class="md-nav__item">
2741
+ <a href="#key-concepts" class="md-nav__link">
2742
+ <span class="md-ellipsis">
2743
+
2744
+ Key Concepts
2745
+
2746
+ </span>
2747
+ </a>
2748
+
2749
+ </li>
2750
+
2751
+ <li class="md-nav__item">
2752
+ <a href="#see-also" class="md-nav__link">
2753
+ <span class="md-ellipsis">
2754
+
2755
+ See Also
2756
+
2757
+ </span>
2758
+ </a>
2759
+
2760
+ </li>
2761
+
2762
+ </ul>
2763
+
2764
+ </nav>
2765
+ </div>
2766
+ </div>
2767
+ </div>
2768
+
2769
+
2770
+
2771
+ <div class="md-content" data-md-component="content">
2772
+
2773
+
2774
+
2775
+
2776
+
2777
+
2778
+
2779
+ <article class="md-content__inner md-typeset">
2780
+
2781
+
2782
+
2783
+
2784
+
2785
+ <a href="https://github.com/madbomber/robot_lab/edit/main/docs/examples/rails-application.md" title="Edit this page" class="md-content__button md-icon" rel="edit">
2786
+
2787
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M10 20H6V4h7v5h5v3.1l2-2V8l-6-6H6c-1.1 0-2 .9-2 2v16c0 1.1.9 2 2 2h4zm10.2-7c.1 0 .3.1.4.2l1.3 1.3c.2.2.2.6 0 .8l-1 1-2.1-2.1 1-1c.1-.1.2-.2.4-.2m0 3.9L14.1 23H12v-2.1l6.1-6.1z"/></svg>
2788
+ </a>
2789
+
2790
+
2791
+
2792
+
2793
+
2794
+ <a href="https://github.com/madbomber/robot_lab/raw/main/docs/examples/rails-application.md" title="View source of this page" class="md-content__button md-icon">
2795
+
2796
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M17 18c.56 0 1 .44 1 1s-.44 1-1 1-1-.44-1-1 .44-1 1-1m0-3c-2.73 0-5.06 1.66-6 4 .94 2.34 3.27 4 6 4s5.06-1.66 6-4c-.94-2.34-3.27-4-6-4m0 6.5a2.5 2.5 0 0 1-2.5-2.5 2.5 2.5 0 0 1 2.5-2.5 2.5 2.5 0 0 1 2.5 2.5 2.5 2.5 0 0 1-2.5 2.5M9.27 20H6V4h7v5h5v4.07c.7.08 1.36.25 2 .49V8l-6-6H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h4.5a8.2 8.2 0 0 1-1.23-2"/></svg>
2797
+ </a>
2798
+
2799
+
2800
+
2801
+ <h1 id="rails-application">Rails Application<a class="headerlink" href="#rails-application" title="Permanent link">&para;</a></h1>
2802
+ <p>Full Rails integration with Action Cable and background jobs.</p>
2803
+ <h2 id="overview">Overview<a class="headerlink" href="#overview" title="Permanent link">&para;</a></h2>
2804
+ <p>This example demonstrates integrating RobotLab into a Rails application with real-time streaming via Action Cable, background job processing, and persistent conversation history.</p>
2805
+ <h2 id="setup">Setup<a class="headerlink" href="#setup" title="Permanent link">&para;</a></h2>
2806
+ <h3 id="1-add-to-gemfile">1. Add to Gemfile<a class="headerlink" href="#1-add-to-gemfile" title="Permanent link">&para;</a></h3>
2807
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="c1"># Gemfile</span>
2808
+ </span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="n">gem</span><span class="w"> </span><span class="s2">&quot;robot_lab&quot;</span>
2809
+ </span></code></pre></div>
2810
+ <h3 id="2-run-generator">2. Run Generator<a class="headerlink" href="#2-run-generator" title="Permanent link">&para;</a></h3>
2811
+ <div class="language-bash highlight"><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>rails<span class="w"> </span>generate<span class="w"> </span>robot_lab:install
2812
+ </span></code></pre></div>
2813
+ <p>This creates:</p>
2814
+ <ul>
2815
+ <li><code>config/initializers/robot_lab.rb</code></li>
2816
+ <li><code>app/robots/</code> directory</li>
2817
+ <li><code>app/tools/</code> directory</li>
2818
+ <li>Database migrations for conversation history</li>
2819
+ </ul>
2820
+ <h3 id="3-run-migrations">3. Run Migrations<a class="headerlink" href="#3-run-migrations" title="Permanent link">&para;</a></h3>
2821
+ <div class="language-bash highlight"><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>rails<span class="w"> </span>db:migrate
2822
+ </span></code></pre></div>
2823
+ <h2 id="configuration">Configuration<a class="headerlink" href="#configuration" title="Permanent link">&para;</a></h2>
2824
+ <p>RobotLab uses MywayConfig for configuration. There is no <code>RobotLab.configure</code> block. Instead, configuration is loaded automatically from multiple sources in priority order:</p>
2825
+ <ol>
2826
+ <li>Bundled defaults (<code>lib/robot_lab/config/defaults.yml</code>)</li>
2827
+ <li>Environment-specific overrides (development, test, production)</li>
2828
+ <li>XDG user config (<code>~/.config/robot_lab/config.yml</code>)</li>
2829
+ <li>Project config (<code>./config/robot_lab.yml</code>)</li>
2830
+ <li>Environment variables (<code>ROBOT_LAB_*</code> prefix)</li>
2831
+ </ol>
2832
+ <h3 id="config-file">Config File<a class="headerlink" href="#config-file" title="Permanent link">&para;</a></h3>
2833
+ <div class="language-yaml highlight"><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="c1"># config/robot_lab.yml</span>
2834
+ </span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="nt">defaults</span><span class="p">:</span>
2835
+ </span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="w"> </span><span class="nt">ruby_llm</span><span class="p">:</span>
2836
+ </span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="w"> </span><span class="nt">model</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">claude-sonnet-4</span>
2837
+ </span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="w"> </span><span class="nt">anthropic_api_key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">&lt;%= ENV[&#39;ANTHROPIC_API_KEY&#39;] %&gt;</span>
2838
+ </span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a>
2839
+ </span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="nt">development</span><span class="p">:</span>
2840
+ </span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="w"> </span><span class="nt">ruby_llm</span><span class="p">:</span>
2841
+ </span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="w"> </span><span class="nt">log_level</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">:debug</span>
2842
+ </span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a>
2843
+ </span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="nt">production</span><span class="p">:</span>
2844
+ </span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a><span class="w"> </span><span class="nt">ruby_llm</span><span class="p">:</span>
2845
+ </span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a><span class="w"> </span><span class="nt">request_timeout</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">180</span>
2846
+ </span><span id="__span-3-14"><a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a><span class="w"> </span><span class="nt">max_retries</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">5</span>
2847
+ </span></code></pre></div>
2848
+ <h3 id="environment-variables">Environment Variables<a class="headerlink" href="#environment-variables" title="Permanent link">&para;</a></h3>
2849
+ <div class="language-bash highlight"><pre><span></span><code><span id="__span-4-1"><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="c1"># Provider API keys</span>
2850
+ </span><span id="__span-4-2"><a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a><span class="nv">ROBOT_LAB_RUBY_LLM__ANTHROPIC_API_KEY</span><span class="o">=</span>sk-ant-...
2851
+ </span><span id="__span-4-3"><a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a><span class="nv">ROBOT_LAB_RUBY_LLM__OPENAI_API_KEY</span><span class="o">=</span>sk-...
2852
+ </span><span id="__span-4-4"><a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></a>
2853
+ </span><span id="__span-4-5"><a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a><span class="c1"># Model configuration</span>
2854
+ </span><span id="__span-4-6"><a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a><span class="nv">ROBOT_LAB_RUBY_LLM__MODEL</span><span class="o">=</span>claude-sonnet-4
2855
+ </span><span id="__span-4-7"><a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a><span class="nv">ROBOT_LAB_RUBY_LLM__REQUEST_TIMEOUT</span><span class="o">=</span><span class="m">120</span>
2856
+ </span></code></pre></div>
2857
+ <h3 id="accessing-configuration">Accessing Configuration<a class="headerlink" href="#accessing-configuration" title="Permanent link">&para;</a></h3>
2858
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-5-1"><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="c1"># Read configuration values at runtime</span>
2859
+ </span><span id="__span-5-2"><a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="no">RobotLab</span><span class="o">.</span><span class="n">config</span><span class="o">.</span><span class="n">ruby_llm</span><span class="o">.</span><span class="n">model</span><span class="w"> </span><span class="c1">#=&gt; &quot;claude-sonnet-4&quot;</span>
2860
+ </span><span id="__span-5-3"><a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="no">RobotLab</span><span class="o">.</span><span class="n">config</span><span class="o">.</span><span class="n">ruby_llm</span><span class="o">.</span><span class="n">request_timeout</span><span class="w"> </span><span class="c1">#=&gt; 120</span>
2861
+ </span><span id="__span-5-4"><a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a>
2862
+ </span><span id="__span-5-5"><a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="c1"># The logger defaults to Rails.logger when running in Rails</span>
2863
+ </span><span id="__span-5-6"><a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="no">RobotLab</span><span class="o">.</span><span class="n">config</span><span class="o">.</span><span class="n">logger</span><span class="w"> </span><span class="c1">#=&gt; Rails.logger</span>
2864
+ </span></code></pre></div>
2865
+ <h3 id="rails-engine-and-railtie">Rails Engine and Railtie<a class="headerlink" href="#rails-engine-and-railtie" title="Permanent link">&para;</a></h3>
2866
+ <p>RobotLab provides both a Rails Engine (<code>RobotLab::Rails::Engine</code>) and a Railtie (<code>RobotLab::Rails::Railtie</code>). These are loaded automatically when Rails is detected. The Engine isolates the RobotLab namespace and adds <code>app/robots</code> and <code>app/tools</code> to the autoload paths. The Railtie loads rake tasks and generators.</p>
2867
+ <h2 id="models">Models<a class="headerlink" href="#models" title="Permanent link">&para;</a></h2>
2868
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-6-1"><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="c1"># app/models/conversation_thread.rb</span>
2869
+ </span><span id="__span-6-2"><a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="k">class</span><span class="w"> </span><span class="nc">ConversationThread</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="no">ApplicationRecord</span>
2870
+ </span><span id="__span-6-3"><a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a><span class="w"> </span><span class="n">belongs_to</span><span class="w"> </span><span class="ss">:user</span>
2871
+ </span><span id="__span-6-4"><a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a><span class="w"> </span><span class="n">has_many</span><span class="w"> </span><span class="ss">:messages</span><span class="p">,</span><span class="w"> </span><span class="ss">class_name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;ConversationMessage&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">dependent</span><span class="p">:</span><span class="w"> </span><span class="ss">:destroy</span>
2872
+ </span><span id="__span-6-5"><a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a>
2873
+ </span><span id="__span-6-6"><a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="w"> </span><span class="n">validates</span><span class="w"> </span><span class="ss">:external_id</span><span class="p">,</span><span class="w"> </span><span class="ss">presence</span><span class="p">:</span><span class="w"> </span><span class="kp">true</span><span class="p">,</span><span class="w"> </span><span class="ss">uniqueness</span><span class="p">:</span><span class="w"> </span><span class="kp">true</span>
2874
+ </span><span id="__span-6-7"><a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a>
2875
+ </span><span id="__span-6-8"><a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></a><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nc">self</span><span class="o">.</span><span class="nf">find_or_create_for</span><span class="p">(</span><span class="ss">user</span><span class="p">:,</span><span class="w"> </span><span class="ss">external_id</span><span class="p">:</span><span class="w"> </span><span class="kp">nil</span><span class="p">)</span>
2876
+ </span><span id="__span-6-9"><a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></a><span class="w"> </span><span class="n">external_id</span><span class="w"> </span><span class="o">||=</span><span class="w"> </span><span class="no">SecureRandom</span><span class="o">.</span><span class="n">uuid</span>
2877
+ </span><span id="__span-6-10"><a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></a><span class="w"> </span><span class="n">find_or_create_by!</span><span class="p">(</span><span class="ss">user</span><span class="p">:</span><span class="w"> </span><span class="n">user</span><span class="p">,</span><span class="w"> </span><span class="ss">external_id</span><span class="p">:</span><span class="w"> </span><span class="n">external_id</span><span class="p">)</span>
2878
+ </span><span id="__span-6-11"><a id="__codelineno-6-11" name="__codelineno-6-11" href="#__codelineno-6-11"></a><span class="w"> </span><span class="k">end</span>
2879
+ </span><span id="__span-6-12"><a id="__codelineno-6-12" name="__codelineno-6-12" href="#__codelineno-6-12"></a><span class="k">end</span>
2880
+ </span><span id="__span-6-13"><a id="__codelineno-6-13" name="__codelineno-6-13" href="#__codelineno-6-13"></a>
2881
+ </span><span id="__span-6-14"><a id="__codelineno-6-14" name="__codelineno-6-14" href="#__codelineno-6-14"></a><span class="c1"># app/models/conversation_message.rb</span>
2882
+ </span><span id="__span-6-15"><a id="__codelineno-6-15" name="__codelineno-6-15" href="#__codelineno-6-15"></a><span class="k">class</span><span class="w"> </span><span class="nc">ConversationMessage</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="no">ApplicationRecord</span>
2883
+ </span><span id="__span-6-16"><a id="__codelineno-6-16" name="__codelineno-6-16" href="#__codelineno-6-16"></a><span class="w"> </span><span class="n">belongs_to</span><span class="w"> </span><span class="ss">:thread</span><span class="p">,</span><span class="w"> </span><span class="ss">class_name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;ConversationThread&quot;</span>
2884
+ </span><span id="__span-6-17"><a id="__codelineno-6-17" name="__codelineno-6-17" href="#__codelineno-6-17"></a>
2885
+ </span><span id="__span-6-18"><a id="__codelineno-6-18" name="__codelineno-6-18" href="#__codelineno-6-18"></a><span class="w"> </span><span class="n">validates</span><span class="w"> </span><span class="ss">:role</span><span class="p">,</span><span class="w"> </span><span class="ss">presence</span><span class="p">:</span><span class="w"> </span><span class="kp">true</span>
2886
+ </span><span id="__span-6-19"><a id="__codelineno-6-19" name="__codelineno-6-19" href="#__codelineno-6-19"></a><span class="w"> </span><span class="n">validates</span><span class="w"> </span><span class="ss">:content</span><span class="p">,</span><span class="w"> </span><span class="ss">presence</span><span class="p">:</span><span class="w"> </span><span class="kp">true</span>
2887
+ </span><span id="__span-6-20"><a id="__codelineno-6-20" name="__codelineno-6-20" href="#__codelineno-6-20"></a>
2888
+ </span><span id="__span-6-21"><a id="__codelineno-6-21" name="__codelineno-6-21" href="#__codelineno-6-21"></a><span class="w"> </span><span class="n">scope</span><span class="w"> </span><span class="ss">:ordered</span><span class="p">,</span><span class="w"> </span><span class="o">-&gt;</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="n">order</span><span class="p">(</span><span class="ss">:position</span><span class="p">)</span><span class="w"> </span><span class="p">}</span>
2889
+ </span><span id="__span-6-22"><a id="__codelineno-6-22" name="__codelineno-6-22" href="#__codelineno-6-22"></a><span class="k">end</span>
2890
+ </span></code></pre></div>
2891
+ <h2 id="robot-definitions">Robot Definitions<a class="headerlink" href="#robot-definitions" title="Permanent link">&para;</a></h2>
2892
+ <p>Robots are built using <code>RobotLab.build</code> with named parameters. Tools are Ruby classes that inherit from <code>RubyLLM::Tool</code>.</p>
2893
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-7-1"><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="c1"># app/tools/get_user_info_tool.rb</span>
2894
+ </span><span id="__span-7-2"><a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="k">class</span><span class="w"> </span><span class="nc">GetUserInfoTool</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="no">RubyLLM</span><span class="o">::</span><span class="no">Tool</span>
2895
+ </span><span id="__span-7-3"><a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a><span class="w"> </span><span class="n">description</span><span class="w"> </span><span class="s2">&quot;Get information about the current user&quot;</span>
2896
+ </span><span id="__span-7-4"><a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a>
2897
+ </span><span id="__span-7-5"><a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="w"> </span><span class="n">param</span><span class="w"> </span><span class="ss">:user_id</span><span class="p">,</span><span class="w"> </span><span class="ss">type</span><span class="p">:</span><span class="w"> </span><span class="ss">:integer</span><span class="p">,</span><span class="w"> </span><span class="ss">desc</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;The user ID to look up&quot;</span>
2898
+ </span><span id="__span-7-6"><a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a>
2899
+ </span><span id="__span-7-7"><a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nf">execute</span><span class="p">(</span><span class="ss">user_id</span><span class="p">:)</span>
2900
+ </span><span id="__span-7-8"><a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a><span class="w"> </span><span class="n">user</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">User</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="n">user_id</span><span class="p">)</span>
2901
+ </span><span id="__span-7-9"><a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="w"> </span><span class="p">{</span>
2902
+ </span><span id="__span-7-10"><a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="w"> </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="n">user</span><span class="o">.</span><span class="n">name</span><span class="p">,</span>
2903
+ </span><span id="__span-7-11"><a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="w"> </span><span class="ss">email</span><span class="p">:</span><span class="w"> </span><span class="n">user</span><span class="o">.</span><span class="n">email</span><span class="p">,</span>
2904
+ </span><span id="__span-7-12"><a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="w"> </span><span class="ss">plan</span><span class="p">:</span><span class="w"> </span><span class="n">user</span><span class="o">.</span><span class="n">subscription</span><span class="o">&amp;.</span><span class="n">plan</span><span class="w"> </span><span class="o">||</span><span class="w"> </span><span class="s2">&quot;free&quot;</span><span class="p">,</span>
2905
+ </span><span id="__span-7-13"><a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a><span class="w"> </span><span class="ss">member_since</span><span class="p">:</span><span class="w"> </span><span class="n">user</span><span class="o">.</span><span class="n">created_at</span><span class="o">.</span><span class="n">to_date</span><span class="o">.</span><span class="n">to_s</span>
2906
+ </span><span id="__span-7-14"><a id="__codelineno-7-14" name="__codelineno-7-14" href="#__codelineno-7-14"></a><span class="w"> </span><span class="p">}</span>
2907
+ </span><span id="__span-7-15"><a id="__codelineno-7-15" name="__codelineno-7-15" href="#__codelineno-7-15"></a><span class="w"> </span><span class="k">rescue</span><span class="w"> </span><span class="no">ActiveRecord</span><span class="o">::</span><span class="no">RecordNotFound</span>
2908
+ </span><span id="__span-7-16"><a id="__codelineno-7-16" name="__codelineno-7-16" href="#__codelineno-7-16"></a><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="ss">error</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;User not found&quot;</span><span class="w"> </span><span class="p">}</span>
2909
+ </span><span id="__span-7-17"><a id="__codelineno-7-17" name="__codelineno-7-17" href="#__codelineno-7-17"></a><span class="w"> </span><span class="k">end</span>
2910
+ </span><span id="__span-7-18"><a id="__codelineno-7-18" name="__codelineno-7-18" href="#__codelineno-7-18"></a><span class="k">end</span>
2911
+ </span><span id="__span-7-19"><a id="__codelineno-7-19" name="__codelineno-7-19" href="#__codelineno-7-19"></a>
2912
+ </span><span id="__span-7-20"><a id="__codelineno-7-20" name="__codelineno-7-20" href="#__codelineno-7-20"></a><span class="c1"># app/tools/get_orders_tool.rb</span>
2913
+ </span><span id="__span-7-21"><a id="__codelineno-7-21" name="__codelineno-7-21" href="#__codelineno-7-21"></a><span class="k">class</span><span class="w"> </span><span class="nc">GetOrdersTool</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="no">RubyLLM</span><span class="o">::</span><span class="no">Tool</span>
2914
+ </span><span id="__span-7-22"><a id="__codelineno-7-22" name="__codelineno-7-22" href="#__codelineno-7-22"></a><span class="w"> </span><span class="n">description</span><span class="w"> </span><span class="s2">&quot;Get user&#39;s recent orders&quot;</span>
2915
+ </span><span id="__span-7-23"><a id="__codelineno-7-23" name="__codelineno-7-23" href="#__codelineno-7-23"></a>
2916
+ </span><span id="__span-7-24"><a id="__codelineno-7-24" name="__codelineno-7-24" href="#__codelineno-7-24"></a><span class="w"> </span><span class="n">param</span><span class="w"> </span><span class="ss">:user_id</span><span class="p">,</span><span class="w"> </span><span class="ss">type</span><span class="p">:</span><span class="w"> </span><span class="ss">:integer</span><span class="p">,</span><span class="w"> </span><span class="ss">desc</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;The user ID&quot;</span>
2917
+ </span><span id="__span-7-25"><a id="__codelineno-7-25" name="__codelineno-7-25" href="#__codelineno-7-25"></a><span class="w"> </span><span class="n">param</span><span class="w"> </span><span class="ss">:limit</span><span class="p">,</span><span class="w"> </span><span class="ss">type</span><span class="p">:</span><span class="w"> </span><span class="ss">:integer</span><span class="p">,</span><span class="w"> </span><span class="ss">desc</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Number of orders to return&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">default</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span>
2918
+ </span><span id="__span-7-26"><a id="__codelineno-7-26" name="__codelineno-7-26" href="#__codelineno-7-26"></a>
2919
+ </span><span id="__span-7-27"><a id="__codelineno-7-27" name="__codelineno-7-27" href="#__codelineno-7-27"></a><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nf">execute</span><span class="p">(</span><span class="ss">user_id</span><span class="p">:,</span><span class="w"> </span><span class="ss">limit</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="p">)</span>
2920
+ </span><span id="__span-7-28"><a id="__codelineno-7-28" name="__codelineno-7-28" href="#__codelineno-7-28"></a><span class="w"> </span><span class="n">orders</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">Order</span><span class="o">.</span><span class="n">where</span><span class="p">(</span><span class="ss">user_id</span><span class="p">:</span><span class="w"> </span><span class="n">user_id</span><span class="p">)</span>
2921
+ </span><span id="__span-7-29"><a id="__codelineno-7-29" name="__codelineno-7-29" href="#__codelineno-7-29"></a><span class="w"> </span><span class="o">.</span><span class="n">order</span><span class="p">(</span><span class="ss">created_at</span><span class="p">:</span><span class="w"> </span><span class="ss">:desc</span><span class="p">)</span>
2922
+ </span><span id="__span-7-30"><a id="__codelineno-7-30" name="__codelineno-7-30" href="#__codelineno-7-30"></a><span class="w"> </span><span class="o">.</span><span class="n">limit</span><span class="p">(</span><span class="n">limit</span><span class="p">)</span>
2923
+ </span><span id="__span-7-31"><a id="__codelineno-7-31" name="__codelineno-7-31" href="#__codelineno-7-31"></a>
2924
+ </span><span id="__span-7-32"><a id="__codelineno-7-32" name="__codelineno-7-32" href="#__codelineno-7-32"></a><span class="w"> </span><span class="n">orders</span><span class="o">.</span><span class="n">map</span><span class="w"> </span><span class="k">do</span><span class="w"> </span><span class="o">|</span><span class="n">order</span><span class="o">|</span>
2925
+ </span><span id="__span-7-33"><a id="__codelineno-7-33" name="__codelineno-7-33" href="#__codelineno-7-33"></a><span class="w"> </span><span class="p">{</span>
2926
+ </span><span id="__span-7-34"><a id="__codelineno-7-34" name="__codelineno-7-34" href="#__codelineno-7-34"></a><span class="w"> </span><span class="nb">id</span><span class="p">:</span><span class="w"> </span><span class="n">order</span><span class="o">.</span><span class="n">external_id</span><span class="p">,</span>
2927
+ </span><span id="__span-7-35"><a id="__codelineno-7-35" name="__codelineno-7-35" href="#__codelineno-7-35"></a><span class="w"> </span><span class="ss">status</span><span class="p">:</span><span class="w"> </span><span class="n">order</span><span class="o">.</span><span class="n">status</span><span class="p">,</span>
2928
+ </span><span id="__span-7-36"><a id="__codelineno-7-36" name="__codelineno-7-36" href="#__codelineno-7-36"></a><span class="w"> </span><span class="ss">total</span><span class="p">:</span><span class="w"> </span><span class="n">order</span><span class="o">.</span><span class="n">total</span><span class="o">.</span><span class="n">to_f</span><span class="p">,</span>
2929
+ </span><span id="__span-7-37"><a id="__codelineno-7-37" name="__codelineno-7-37" href="#__codelineno-7-37"></a><span class="w"> </span><span class="ss">created_at</span><span class="p">:</span><span class="w"> </span><span class="n">order</span><span class="o">.</span><span class="n">created_at</span><span class="o">.</span><span class="n">iso8601</span>
2930
+ </span><span id="__span-7-38"><a id="__codelineno-7-38" name="__codelineno-7-38" href="#__codelineno-7-38"></a><span class="w"> </span><span class="p">}</span>
2931
+ </span><span id="__span-7-39"><a id="__codelineno-7-39" name="__codelineno-7-39" href="#__codelineno-7-39"></a><span class="w"> </span><span class="k">end</span>
2932
+ </span><span id="__span-7-40"><a id="__codelineno-7-40" name="__codelineno-7-40" href="#__codelineno-7-40"></a><span class="w"> </span><span class="k">end</span>
2933
+ </span><span id="__span-7-41"><a id="__codelineno-7-41" name="__codelineno-7-41" href="#__codelineno-7-41"></a><span class="k">end</span>
2934
+ </span><span id="__span-7-42"><a id="__codelineno-7-42" name="__codelineno-7-42" href="#__codelineno-7-42"></a>
2935
+ </span><span id="__span-7-43"><a id="__codelineno-7-43" name="__codelineno-7-43" href="#__codelineno-7-43"></a><span class="c1"># app/tools/create_ticket_tool.rb</span>
2936
+ </span><span id="__span-7-44"><a id="__codelineno-7-44" name="__codelineno-7-44" href="#__codelineno-7-44"></a><span class="k">class</span><span class="w"> </span><span class="nc">CreateTicketTool</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="no">RubyLLM</span><span class="o">::</span><span class="no">Tool</span>
2937
+ </span><span id="__span-7-45"><a id="__codelineno-7-45" name="__codelineno-7-45" href="#__codelineno-7-45"></a><span class="w"> </span><span class="n">description</span><span class="w"> </span><span class="s2">&quot;Create a support ticket&quot;</span>
2938
+ </span><span id="__span-7-46"><a id="__codelineno-7-46" name="__codelineno-7-46" href="#__codelineno-7-46"></a>
2939
+ </span><span id="__span-7-47"><a id="__codelineno-7-47" name="__codelineno-7-47" href="#__codelineno-7-47"></a><span class="w"> </span><span class="n">param</span><span class="w"> </span><span class="ss">:user_id</span><span class="p">,</span><span class="w"> </span><span class="ss">type</span><span class="p">:</span><span class="w"> </span><span class="ss">:integer</span><span class="p">,</span><span class="w"> </span><span class="ss">desc</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;The user ID&quot;</span>
2940
+ </span><span id="__span-7-48"><a id="__codelineno-7-48" name="__codelineno-7-48" href="#__codelineno-7-48"></a><span class="w"> </span><span class="n">param</span><span class="w"> </span><span class="ss">:subject</span><span class="p">,</span><span class="w"> </span><span class="ss">type</span><span class="p">:</span><span class="w"> </span><span class="ss">:string</span><span class="p">,</span><span class="w"> </span><span class="ss">desc</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Ticket subject&quot;</span>
2941
+ </span><span id="__span-7-49"><a id="__codelineno-7-49" name="__codelineno-7-49" href="#__codelineno-7-49"></a><span class="w"> </span><span class="n">param</span><span class="w"> </span><span class="ss">:description</span><span class="p">,</span><span class="w"> </span><span class="ss">type</span><span class="p">:</span><span class="w"> </span><span class="ss">:string</span><span class="p">,</span><span class="w"> </span><span class="ss">desc</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Ticket description&quot;</span>
2942
+ </span><span id="__span-7-50"><a id="__codelineno-7-50" name="__codelineno-7-50" href="#__codelineno-7-50"></a><span class="w"> </span><span class="n">param</span><span class="w"> </span><span class="ss">:priority</span><span class="p">,</span><span class="w"> </span><span class="ss">type</span><span class="p">:</span><span class="w"> </span><span class="ss">:string</span><span class="p">,</span><span class="w"> </span><span class="ss">desc</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Priority level&quot;</span><span class="p">,</span><span class="w"> </span><span class="ss">enum</span><span class="p">:</span><span class="w"> </span><span class="sx">%w[low medium high]</span>
2943
+ </span><span id="__span-7-51"><a id="__codelineno-7-51" name="__codelineno-7-51" href="#__codelineno-7-51"></a>
2944
+ </span><span id="__span-7-52"><a id="__codelineno-7-52" name="__codelineno-7-52" href="#__codelineno-7-52"></a><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nf">execute</span><span class="p">(</span><span class="ss">user_id</span><span class="p">:,</span><span class="w"> </span><span class="ss">subject</span><span class="p">:,</span><span class="w"> </span><span class="ss">description</span><span class="p">:,</span><span class="w"> </span><span class="ss">priority</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;medium&quot;</span><span class="p">)</span>
2945
+ </span><span id="__span-7-53"><a id="__codelineno-7-53" name="__codelineno-7-53" href="#__codelineno-7-53"></a><span class="w"> </span><span class="n">ticket</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">SupportTicket</span><span class="o">.</span><span class="n">create!</span><span class="p">(</span>
2946
+ </span><span id="__span-7-54"><a id="__codelineno-7-54" name="__codelineno-7-54" href="#__codelineno-7-54"></a><span class="w"> </span><span class="ss">user_id</span><span class="p">:</span><span class="w"> </span><span class="n">user_id</span><span class="p">,</span>
2947
+ </span><span id="__span-7-55"><a id="__codelineno-7-55" name="__codelineno-7-55" href="#__codelineno-7-55"></a><span class="w"> </span><span class="ss">subject</span><span class="p">:</span><span class="w"> </span><span class="n">subject</span><span class="p">,</span>
2948
+ </span><span id="__span-7-56"><a id="__codelineno-7-56" name="__codelineno-7-56" href="#__codelineno-7-56"></a><span class="w"> </span><span class="ss">description</span><span class="p">:</span><span class="w"> </span><span class="n">description</span><span class="p">,</span>
2949
+ </span><span id="__span-7-57"><a id="__codelineno-7-57" name="__codelineno-7-57" href="#__codelineno-7-57"></a><span class="w"> </span><span class="ss">priority</span><span class="p">:</span><span class="w"> </span><span class="n">priority</span>
2950
+ </span><span id="__span-7-58"><a id="__codelineno-7-58" name="__codelineno-7-58" href="#__codelineno-7-58"></a><span class="w"> </span><span class="p">)</span>
2951
+ </span><span id="__span-7-59"><a id="__codelineno-7-59" name="__codelineno-7-59" href="#__codelineno-7-59"></a>
2952
+ </span><span id="__span-7-60"><a id="__codelineno-7-60" name="__codelineno-7-60" href="#__codelineno-7-60"></a><span class="w"> </span><span class="p">{</span>
2953
+ </span><span id="__span-7-61"><a id="__codelineno-7-61" name="__codelineno-7-61" href="#__codelineno-7-61"></a><span class="w"> </span><span class="ss">success</span><span class="p">:</span><span class="w"> </span><span class="kp">true</span><span class="p">,</span>
2954
+ </span><span id="__span-7-62"><a id="__codelineno-7-62" name="__codelineno-7-62" href="#__codelineno-7-62"></a><span class="w"> </span><span class="ss">ticket_id</span><span class="p">:</span><span class="w"> </span><span class="n">ticket</span><span class="o">.</span><span class="n">external_id</span><span class="p">,</span>
2955
+ </span><span id="__span-7-63"><a id="__codelineno-7-63" name="__codelineno-7-63" href="#__codelineno-7-63"></a><span class="w"> </span><span class="ss">message</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;Ticket created successfully&quot;</span>
2956
+ </span><span id="__span-7-64"><a id="__codelineno-7-64" name="__codelineno-7-64" href="#__codelineno-7-64"></a><span class="w"> </span><span class="p">}</span>
2957
+ </span><span id="__span-7-65"><a id="__codelineno-7-65" name="__codelineno-7-65" href="#__codelineno-7-65"></a><span class="w"> </span><span class="k">rescue</span><span class="w"> </span><span class="o">=&gt;</span><span class="w"> </span><span class="n">e</span>
2958
+ </span><span id="__span-7-66"><a id="__codelineno-7-66" name="__codelineno-7-66" href="#__codelineno-7-66"></a><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="ss">success</span><span class="p">:</span><span class="w"> </span><span class="kp">false</span><span class="p">,</span><span class="w"> </span><span class="ss">error</span><span class="p">:</span><span class="w"> </span><span class="n">e</span><span class="o">.</span><span class="n">message</span><span class="w"> </span><span class="p">}</span>
2959
+ </span><span id="__span-7-67"><a id="__codelineno-7-67" name="__codelineno-7-67" href="#__codelineno-7-67"></a><span class="w"> </span><span class="k">end</span>
2960
+ </span><span id="__span-7-68"><a id="__codelineno-7-68" name="__codelineno-7-68" href="#__codelineno-7-68"></a><span class="k">end</span>
2961
+ </span></code></pre></div>
2962
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-8-1"><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="c1"># app/robots/support_robot.rb</span>
2963
+ </span><span id="__span-8-2"><a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="k">class</span><span class="w"> </span><span class="nc">SupportRobot</span>
2964
+ </span><span id="__span-8-3"><a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nc">self</span><span class="o">.</span><span class="nf">build</span><span class="p">(</span><span class="ss">user_id</span><span class="p">:)</span>
2965
+ </span><span id="__span-8-4"><a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">build</span><span class="p">(</span>
2966
+ </span><span id="__span-8-5"><a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="w"> </span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;support&quot;</span><span class="p">,</span>
2967
+ </span><span id="__span-8-6"><a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="w"> </span><span class="ss">system_prompt</span><span class="p">:</span><span class="w"> </span><span class="o">&lt;&lt;~</span><span class="dl">PROMPT</span><span class="p">,</span>
2968
+ </span><span id="__span-8-7"><a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a><span class="sh"> You are a helpful customer support assistant for our company.</span>
2969
+ </span><span id="__span-8-8"><a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="sh"> Be friendly, professional, and thorough in your responses.</span>
2970
+ </span><span id="__span-8-9"><a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="sh"> If you need to look up information, use the available tools.</span>
2971
+ </span><span id="__span-8-10"><a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a><span class="sh"> The current user ID is #{user_id}.</span>
2972
+ </span><span id="__span-8-11"><a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="dl"> PROMPT</span>
2973
+ </span><span id="__span-8-12"><a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="w"> </span><span class="ss">local_tools</span><span class="p">:</span><span class="w"> </span><span class="o">[</span><span class="no">GetUserInfoTool</span><span class="p">,</span><span class="w"> </span><span class="no">GetOrdersTool</span><span class="p">,</span><span class="w"> </span><span class="no">CreateTicketTool</span><span class="o">]</span>
2974
+ </span><span id="__span-8-13"><a id="__codelineno-8-13" name="__codelineno-8-13" href="#__codelineno-8-13"></a><span class="w"> </span><span class="p">)</span>
2975
+ </span><span id="__span-8-14"><a id="__codelineno-8-14" name="__codelineno-8-14" href="#__codelineno-8-14"></a><span class="w"> </span><span class="k">end</span>
2976
+ </span><span id="__span-8-15"><a id="__codelineno-8-15" name="__codelineno-8-15" href="#__codelineno-8-15"></a><span class="k">end</span>
2977
+ </span></code></pre></div>
2978
+ <h2 id="network-configuration">Network Configuration<a class="headerlink" href="#network-configuration" title="Permanent link">&para;</a></h2>
2979
+ <p>Networks use <code>create_network</code> with a block DSL that defines tasks and their dependencies:</p>
2980
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-9-1"><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="c1"># app/robots/support_network.rb</span>
2981
+ </span><span id="__span-9-2"><a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="k">class</span><span class="w"> </span><span class="nc">SupportNetwork</span>
2982
+ </span><span id="__span-9-3"><a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nc">self</span><span class="o">.</span><span class="nf">build</span><span class="p">(</span><span class="ss">user_id</span><span class="p">:)</span>
2983
+ </span><span id="__span-9-4"><a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="w"> </span><span class="n">support</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">SupportRobot</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="ss">user_id</span><span class="p">:</span><span class="w"> </span><span class="n">user_id</span><span class="p">)</span>
2984
+ </span><span id="__span-9-5"><a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a>
2985
+ </span><span id="__span-9-6"><a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="w"> </span><span class="no">RobotLab</span><span class="o">.</span><span class="n">create_network</span><span class="p">(</span><span class="nb">name</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;support_network&quot;</span><span class="p">)</span><span class="w"> </span><span class="k">do</span>
2986
+ </span><span id="__span-9-7"><a id="__codelineno-9-7" name="__codelineno-9-7" href="#__codelineno-9-7"></a><span class="w"> </span><span class="n">task</span><span class="w"> </span><span class="ss">:support</span><span class="p">,</span><span class="w"> </span><span class="n">support</span><span class="p">,</span><span class="w"> </span><span class="ss">depends_on</span><span class="p">:</span><span class="w"> </span><span class="ss">:none</span>
2987
+ </span><span id="__span-9-8"><a id="__codelineno-9-8" name="__codelineno-9-8" href="#__codelineno-9-8"></a><span class="w"> </span><span class="k">end</span>
2988
+ </span><span id="__span-9-9"><a id="__codelineno-9-9" name="__codelineno-9-9" href="#__codelineno-9-9"></a><span class="w"> </span><span class="k">end</span>
2989
+ </span><span id="__span-9-10"><a id="__codelineno-9-10" name="__codelineno-9-10" href="#__codelineno-9-10"></a><span class="k">end</span>
2990
+ </span></code></pre></div>
2991
+ <h2 id="service-object">Service Object<a class="headerlink" href="#service-object" title="Permanent link">&para;</a></h2>
2992
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-10-1"><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="c1"># app/services/chat_service.rb</span>
2993
+ </span><span id="__span-10-2"><a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="k">class</span><span class="w"> </span><span class="nc">ChatService</span>
2994
+ </span><span id="__span-10-3"><a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nf">initialize</span><span class="p">(</span><span class="ss">user</span><span class="p">:,</span><span class="w"> </span><span class="ss">thread_id</span><span class="p">:</span><span class="w"> </span><span class="kp">nil</span><span class="p">)</span>
2995
+ </span><span id="__span-10-4"><a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="w"> </span><span class="vi">@user</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">user</span>
2996
+ </span><span id="__span-10-5"><a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="w"> </span><span class="vi">@thread_id</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">thread_id</span>
2997
+ </span><span id="__span-10-6"><a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a><span class="w"> </span><span class="k">end</span>
2998
+ </span><span id="__span-10-7"><a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a>
2999
+ </span><span id="__span-10-8"><a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nf">call</span><span class="p">(</span><span class="ss">message</span><span class="p">:)</span>
3000
+ </span><span id="__span-10-9"><a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a><span class="w"> </span><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">SupportRobot</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="ss">user_id</span><span class="p">:</span><span class="w"> </span><span class="vi">@user</span><span class="o">.</span><span class="n">id</span><span class="p">)</span>
3001
+ </span><span id="__span-10-10"><a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a><span class="w"> </span><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">robot</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">message</span><span class="p">)</span>
3002
+ </span><span id="__span-10-11"><a id="__codelineno-10-11" name="__codelineno-10-11" href="#__codelineno-10-11"></a>
3003
+ </span><span id="__span-10-12"><a id="__codelineno-10-12" name="__codelineno-10-12" href="#__codelineno-10-12"></a><span class="w"> </span><span class="p">{</span>
3004
+ </span><span id="__span-10-13"><a id="__codelineno-10-13" name="__codelineno-10-13" href="#__codelineno-10-13"></a><span class="w"> </span><span class="ss">response</span><span class="p">:</span><span class="w"> </span><span class="n">result</span><span class="o">.</span><span class="n">last_text_content</span><span class="p">,</span>
3005
+ </span><span id="__span-10-14"><a id="__codelineno-10-14" name="__codelineno-10-14" href="#__codelineno-10-14"></a><span class="w"> </span><span class="ss">has_tool_calls</span><span class="p">:</span><span class="w"> </span><span class="n">result</span><span class="o">.</span><span class="n">has_tool_calls?</span>
3006
+ </span><span id="__span-10-15"><a id="__codelineno-10-15" name="__codelineno-10-15" href="#__codelineno-10-15"></a><span class="w"> </span><span class="p">}</span>
3007
+ </span><span id="__span-10-16"><a id="__codelineno-10-16" name="__codelineno-10-16" href="#__codelineno-10-16"></a><span class="w"> </span><span class="k">end</span>
3008
+ </span><span id="__span-10-17"><a id="__codelineno-10-17" name="__codelineno-10-17" href="#__codelineno-10-17"></a><span class="k">end</span>
3009
+ </span></code></pre></div>
3010
+ <h2 id="controller">Controller<a class="headerlink" href="#controller" title="Permanent link">&para;</a></h2>
3011
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-11-1"><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="c1"># app/controllers/api/chats_controller.rb</span>
3012
+ </span><span id="__span-11-2"><a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="k">module</span><span class="w"> </span><span class="nn">Api</span>
3013
+ </span><span id="__span-11-3"><a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="w"> </span><span class="k">class</span><span class="w"> </span><span class="nc">ChatsController</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="no">ApplicationController</span>
3014
+ </span><span id="__span-11-4"><a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="w"> </span><span class="n">before_action</span><span class="w"> </span><span class="ss">:authenticate_user!</span>
3015
+ </span><span id="__span-11-5"><a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a>
3016
+ </span><span id="__span-11-6"><a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nf">create</span>
3017
+ </span><span id="__span-11-7"><a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a><span class="w"> </span><span class="n">service</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">ChatService</span><span class="o">.</span><span class="n">new</span><span class="p">(</span>
3018
+ </span><span id="__span-11-8"><a id="__codelineno-11-8" name="__codelineno-11-8" href="#__codelineno-11-8"></a><span class="w"> </span><span class="ss">user</span><span class="p">:</span><span class="w"> </span><span class="n">current_user</span><span class="p">,</span>
3019
+ </span><span id="__span-11-9"><a id="__codelineno-11-9" name="__codelineno-11-9" href="#__codelineno-11-9"></a><span class="w"> </span><span class="ss">thread_id</span><span class="p">:</span><span class="w"> </span><span class="n">params</span><span class="o">[</span><span class="ss">:thread_id</span><span class="o">]</span>
3020
+ </span><span id="__span-11-10"><a id="__codelineno-11-10" name="__codelineno-11-10" href="#__codelineno-11-10"></a><span class="w"> </span><span class="p">)</span>
3021
+ </span><span id="__span-11-11"><a id="__codelineno-11-11" name="__codelineno-11-11" href="#__codelineno-11-11"></a>
3022
+ </span><span id="__span-11-12"><a id="__codelineno-11-12" name="__codelineno-11-12" href="#__codelineno-11-12"></a><span class="w"> </span><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">service</span><span class="o">.</span><span class="n">call</span><span class="p">(</span><span class="ss">message</span><span class="p">:</span><span class="w"> </span><span class="n">params</span><span class="o">[</span><span class="ss">:message</span><span class="o">]</span><span class="p">)</span>
3023
+ </span><span id="__span-11-13"><a id="__codelineno-11-13" name="__codelineno-11-13" href="#__codelineno-11-13"></a>
3024
+ </span><span id="__span-11-14"><a id="__codelineno-11-14" name="__codelineno-11-14" href="#__codelineno-11-14"></a><span class="w"> </span><span class="n">render</span><span class="w"> </span><span class="ss">json</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>
3025
+ </span><span id="__span-11-15"><a id="__codelineno-11-15" name="__codelineno-11-15" href="#__codelineno-11-15"></a><span class="w"> </span><span class="ss">response</span><span class="p">:</span><span class="w"> </span><span class="n">result</span><span class="o">[</span><span class="ss">:response</span><span class="o">]</span>
3026
+ </span><span id="__span-11-16"><a id="__codelineno-11-16" name="__codelineno-11-16" href="#__codelineno-11-16"></a><span class="w"> </span><span class="p">}</span>
3027
+ </span><span id="__span-11-17"><a id="__codelineno-11-17" name="__codelineno-11-17" href="#__codelineno-11-17"></a><span class="w"> </span><span class="k">end</span>
3028
+ </span><span id="__span-11-18"><a id="__codelineno-11-18" name="__codelineno-11-18" href="#__codelineno-11-18"></a><span class="w"> </span><span class="k">end</span>
3029
+ </span><span id="__span-11-19"><a id="__codelineno-11-19" name="__codelineno-11-19" href="#__codelineno-11-19"></a><span class="k">end</span>
3030
+ </span></code></pre></div>
3031
+ <h2 id="action-cable-integration">Action Cable Integration<a class="headerlink" href="#action-cable-integration" title="Permanent link">&para;</a></h2>
3032
+ <div class="language-ruby highlight"><pre><span></span><code><span id="__span-12-1"><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a><span class="c1"># app/channels/chat_channel.rb</span>
3033
+ </span><span id="__span-12-2"><a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="k">class</span><span class="w"> </span><span class="nc">ChatChannel</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="no">ApplicationCable</span><span class="o">::</span><span class="no">Channel</span>
3034
+ </span><span id="__span-12-3"><a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nf">subscribed</span>
3035
+ </span><span id="__span-12-4"><a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="w"> </span><span class="n">stream_for</span><span class="w"> </span><span class="n">current_user</span>
3036
+ </span><span id="__span-12-5"><a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="w"> </span><span class="k">end</span>
3037
+ </span><span id="__span-12-6"><a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a>
3038
+ </span><span id="__span-12-7"><a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nf">receive</span><span class="p">(</span><span class="n">data</span><span class="p">)</span>
3039
+ </span><span id="__span-12-8"><a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a><span class="w"> </span><span class="no">ChatJob</span><span class="o">.</span><span class="n">perform_later</span><span class="p">(</span>
3040
+ </span><span id="__span-12-9"><a id="__codelineno-12-9" name="__codelineno-12-9" href="#__codelineno-12-9"></a><span class="w"> </span><span class="ss">user_id</span><span class="p">:</span><span class="w"> </span><span class="n">current_user</span><span class="o">.</span><span class="n">id</span><span class="p">,</span>
3041
+ </span><span id="__span-12-10"><a id="__codelineno-12-10" name="__codelineno-12-10" href="#__codelineno-12-10"></a><span class="w"> </span><span class="ss">thread_id</span><span class="p">:</span><span class="w"> </span><span class="n">data</span><span class="o">[</span><span class="s2">&quot;thread_id&quot;</span><span class="o">]</span><span class="p">,</span>
3042
+ </span><span id="__span-12-11"><a id="__codelineno-12-11" name="__codelineno-12-11" href="#__codelineno-12-11"></a><span class="w"> </span><span class="ss">message</span><span class="p">:</span><span class="w"> </span><span class="n">data</span><span class="o">[</span><span class="s2">&quot;message&quot;</span><span class="o">]</span>
3043
+ </span><span id="__span-12-12"><a id="__codelineno-12-12" name="__codelineno-12-12" href="#__codelineno-12-12"></a><span class="w"> </span><span class="p">)</span>
3044
+ </span><span id="__span-12-13"><a id="__codelineno-12-13" name="__codelineno-12-13" href="#__codelineno-12-13"></a><span class="w"> </span><span class="k">end</span>
3045
+ </span><span id="__span-12-14"><a id="__codelineno-12-14" name="__codelineno-12-14" href="#__codelineno-12-14"></a><span class="k">end</span>
3046
+ </span><span id="__span-12-15"><a id="__codelineno-12-15" name="__codelineno-12-15" href="#__codelineno-12-15"></a>
3047
+ </span><span id="__span-12-16"><a id="__codelineno-12-16" name="__codelineno-12-16" href="#__codelineno-12-16"></a><span class="c1"># app/jobs/chat_job.rb</span>
3048
+ </span><span id="__span-12-17"><a id="__codelineno-12-17" name="__codelineno-12-17" href="#__codelineno-12-17"></a><span class="k">class</span><span class="w"> </span><span class="nc">ChatJob</span><span class="w"> </span><span class="o">&lt;</span><span class="w"> </span><span class="no">ApplicationJob</span>
3049
+ </span><span id="__span-12-18"><a id="__codelineno-12-18" name="__codelineno-12-18" href="#__codelineno-12-18"></a><span class="w"> </span><span class="n">queue_as</span><span class="w"> </span><span class="ss">:default</span>
3050
+ </span><span id="__span-12-19"><a id="__codelineno-12-19" name="__codelineno-12-19" href="#__codelineno-12-19"></a>
3051
+ </span><span id="__span-12-20"><a id="__codelineno-12-20" name="__codelineno-12-20" href="#__codelineno-12-20"></a><span class="w"> </span><span class="k">def</span><span class="w"> </span><span class="nf">perform</span><span class="p">(</span><span class="ss">user_id</span><span class="p">:,</span><span class="w"> </span><span class="ss">thread_id</span><span class="p">:,</span><span class="w"> </span><span class="ss">message</span><span class="p">:)</span>
3052
+ </span><span id="__span-12-21"><a id="__codelineno-12-21" name="__codelineno-12-21" href="#__codelineno-12-21"></a><span class="w"> </span><span class="n">user</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">User</span><span class="o">.</span><span class="n">find</span><span class="p">(</span><span class="n">user_id</span><span class="p">)</span>
3053
+ </span><span id="__span-12-22"><a id="__codelineno-12-22" name="__codelineno-12-22" href="#__codelineno-12-22"></a><span class="w"> </span><span class="n">robot</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="no">SupportRobot</span><span class="o">.</span><span class="n">build</span><span class="p">(</span><span class="ss">user_id</span><span class="p">:</span><span class="w"> </span><span class="n">user</span><span class="o">.</span><span class="n">id</span><span class="p">)</span>
3054
+ </span><span id="__span-12-23"><a id="__codelineno-12-23" name="__codelineno-12-23" href="#__codelineno-12-23"></a>
3055
+ </span><span id="__span-12-24"><a id="__codelineno-12-24" name="__codelineno-12-24" href="#__codelineno-12-24"></a><span class="w"> </span><span class="n">result</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="n">robot</span><span class="o">.</span><span class="n">run</span><span class="p">(</span><span class="n">message</span><span class="p">)</span>
3056
+ </span><span id="__span-12-25"><a id="__codelineno-12-25" name="__codelineno-12-25" href="#__codelineno-12-25"></a>
3057
+ </span><span id="__span-12-26"><a id="__codelineno-12-26" name="__codelineno-12-26" href="#__codelineno-12-26"></a><span class="w"> </span><span class="no">ChatChannel</span><span class="o">.</span><span class="n">broadcast_to</span><span class="p">(</span>
3058
+ </span><span id="__span-12-27"><a id="__codelineno-12-27" name="__codelineno-12-27" href="#__codelineno-12-27"></a><span class="w"> </span><span class="n">user</span><span class="p">,</span>
3059
+ </span><span id="__span-12-28"><a id="__codelineno-12-28" name="__codelineno-12-28" href="#__codelineno-12-28"></a><span class="w"> </span><span class="ss">type</span><span class="p">:</span><span class="w"> </span><span class="s2">&quot;complete&quot;</span><span class="p">,</span>
3060
+ </span><span id="__span-12-29"><a id="__codelineno-12-29" name="__codelineno-12-29" href="#__codelineno-12-29"></a><span class="w"> </span><span class="ss">content</span><span class="p">:</span><span class="w"> </span><span class="n">result</span><span class="o">.</span><span class="n">last_text_content</span>
3061
+ </span><span id="__span-12-30"><a id="__codelineno-12-30" name="__codelineno-12-30" href="#__codelineno-12-30"></a><span class="w"> </span><span class="p">)</span>
3062
+ </span><span id="__span-12-31"><a id="__codelineno-12-31" name="__codelineno-12-31" href="#__codelineno-12-31"></a><span class="w"> </span><span class="k">end</span>
3063
+ </span><span id="__span-12-32"><a id="__codelineno-12-32" name="__codelineno-12-32" href="#__codelineno-12-32"></a><span class="k">end</span>
3064
+ </span></code></pre></div>
3065
+ <h2 id="frontend-stimulus">Frontend (Stimulus)<a class="headerlink" href="#frontend-stimulus" title="Permanent link">&para;</a></h2>
3066
+ <div class="language-javascript highlight"><pre><span></span><code><span id="__span-13-1"><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="c1">// app/javascript/controllers/chat_controller.js</span>
3067
+ </span><span id="__span-13-2"><a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="k">import</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nx">Controller</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="kr">from</span><span class="w"> </span><span class="s2">&quot;@hotwired/stimulus&quot;</span>
3068
+ </span><span id="__span-13-3"><a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a><span class="k">import</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nx">createConsumer</span><span class="w"> </span><span class="p">}</span><span class="w"> </span><span class="kr">from</span><span class="w"> </span><span class="s2">&quot;@rails/actioncable&quot;</span>
3069
+ </span><span id="__span-13-4"><a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a>
3070
+ </span><span id="__span-13-5"><a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a><span class="k">export</span><span class="w"> </span><span class="k">default</span><span class="w"> </span><span class="kd">class</span><span class="w"> </span><span class="k">extends</span><span class="w"> </span><span class="nx">Controller</span><span class="w"> </span><span class="p">{</span>
3071
+ </span><span id="__span-13-6"><a id="__codelineno-13-6" name="__codelineno-13-6" href="#__codelineno-13-6"></a><span class="w"> </span><span class="k">static</span><span class="w"> </span><span class="nx">targets</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">[</span><span class="s2">&quot;messages&quot;</span><span class="p">,</span><span class="w"> </span><span class="s2">&quot;input&quot;</span><span class="p">,</span><span class="w"> </span><span class="s2">&quot;response&quot;</span><span class="p">]</span>
3072
+ </span><span id="__span-13-7"><a id="__codelineno-13-7" name="__codelineno-13-7" href="#__codelineno-13-7"></a>
3073
+ </span><span id="__span-13-8"><a id="__codelineno-13-8" name="__codelineno-13-8" href="#__codelineno-13-8"></a><span class="w"> </span><span class="nx">connect</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
3074
+ </span><span id="__span-13-9"><a id="__codelineno-13-9" name="__codelineno-13-9" href="#__codelineno-13-9"></a><span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">consumer</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">createConsumer</span><span class="p">()</span>
3075
+ </span><span id="__span-13-10"><a id="__codelineno-13-10" name="__codelineno-13-10" href="#__codelineno-13-10"></a><span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">channel</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">consumer</span><span class="p">.</span><span class="nx">subscriptions</span><span class="p">.</span><span class="nx">create</span><span class="p">(</span><span class="s2">&quot;ChatChannel&quot;</span><span class="p">,</span><span class="w"> </span><span class="p">{</span>
3076
+ </span><span id="__span-13-11"><a id="__codelineno-13-11" name="__codelineno-13-11" href="#__codelineno-13-11"></a><span class="w"> </span><span class="nx">received</span><span class="o">:</span><span class="w"> </span><span class="p">(</span><span class="nx">data</span><span class="p">)</span><span class="w"> </span><span class="p">=&gt;</span><span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">handleMessage</span><span class="p">(</span><span class="nx">data</span><span class="p">)</span>
3077
+ </span><span id="__span-13-12"><a id="__codelineno-13-12" name="__codelineno-13-12" href="#__codelineno-13-12"></a><span class="w"> </span><span class="p">})</span>
3078
+ </span><span id="__span-13-13"><a id="__codelineno-13-13" name="__codelineno-13-13" href="#__codelineno-13-13"></a><span class="w"> </span><span class="p">}</span>
3079
+ </span><span id="__span-13-14"><a id="__codelineno-13-14" name="__codelineno-13-14" href="#__codelineno-13-14"></a>
3080
+ </span><span id="__span-13-15"><a id="__codelineno-13-15" name="__codelineno-13-15" href="#__codelineno-13-15"></a><span class="w"> </span><span class="nx">disconnect</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
3081
+ </span><span id="__span-13-16"><a id="__codelineno-13-16" name="__codelineno-13-16" href="#__codelineno-13-16"></a><span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">channel</span><span class="o">?</span><span class="p">.</span><span class="nx">unsubscribe</span><span class="p">()</span>
3082
+ </span><span id="__span-13-17"><a id="__codelineno-13-17" name="__codelineno-13-17" href="#__codelineno-13-17"></a><span class="w"> </span><span class="p">}</span>
3083
+ </span><span id="__span-13-18"><a id="__codelineno-13-18" name="__codelineno-13-18" href="#__codelineno-13-18"></a>
3084
+ </span><span id="__span-13-19"><a id="__codelineno-13-19" name="__codelineno-13-19" href="#__codelineno-13-19"></a><span class="w"> </span><span class="nx">send</span><span class="p">()</span><span class="w"> </span><span class="p">{</span>
3085
+ </span><span id="__span-13-20"><a id="__codelineno-13-20" name="__codelineno-13-20" href="#__codelineno-13-20"></a><span class="w"> </span><span class="kd">const</span><span class="w"> </span><span class="nx">message</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">inputTarget</span><span class="p">.</span><span class="nx">value</span><span class="p">.</span><span class="nx">trim</span><span class="p">()</span>
3086
+ </span><span id="__span-13-21"><a id="__codelineno-13-21" name="__codelineno-13-21" href="#__codelineno-13-21"></a><span class="w"> </span><span class="k">if</span><span class="w"> </span><span class="p">(</span><span class="o">!</span><span class="nx">message</span><span class="p">)</span><span class="w"> </span><span class="k">return</span>
3087
+ </span><span id="__span-13-22"><a id="__codelineno-13-22" name="__codelineno-13-22" href="#__codelineno-13-22"></a>
3088
+ </span><span id="__span-13-23"><a id="__codelineno-13-23" name="__codelineno-13-23" href="#__codelineno-13-23"></a><span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">appendMessage</span><span class="p">(</span><span class="s2">&quot;user&quot;</span><span class="p">,</span><span class="w"> </span><span class="nx">message</span><span class="p">)</span>
3089
+ </span><span id="__span-13-24"><a id="__codelineno-13-24" name="__codelineno-13-24" href="#__codelineno-13-24"></a><span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">inputTarget</span><span class="p">.</span><span class="nx">value</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">&quot;&quot;</span>
3090
+ </span><span id="__span-13-25"><a id="__codelineno-13-25" name="__codelineno-13-25" href="#__codelineno-13-25"></a>
3091
+ </span><span id="__span-13-26"><a id="__codelineno-13-26" name="__codelineno-13-26" href="#__codelineno-13-26"></a><span class="w"> </span><span class="c1">// Create response container</span>
3092
+ </span><span id="__span-13-27"><a id="__codelineno-13-27" name="__codelineno-13-27" href="#__codelineno-13-27"></a><span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">currentResponse</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">document</span><span class="p">.</span><span class="nx">createElement</span><span class="p">(</span><span class="s2">&quot;div&quot;</span><span class="p">)</span>
3093
+ </span><span id="__span-13-28"><a id="__codelineno-13-28" name="__codelineno-13-28" href="#__codelineno-13-28"></a><span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">currentResponse</span><span class="p">.</span><span class="nx">className</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="s2">&quot;message assistant&quot;</span>
3094
+ </span><span id="__span-13-29"><a id="__codelineno-13-29" name="__codelineno-13-29" href="#__codelineno-13-29"></a><span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">messagesTarget</span><span class="p">.</span><span class="nx">appendChild</span><span class="p">(</span><span class="k">this</span><span class="p">.</span><span class="nx">currentResponse</span><span class="p">)</span>
3095
+ </span><span id="__span-13-30"><a id="__codelineno-13-30" name="__codelineno-13-30" href="#__codelineno-13-30"></a>
3096
+ </span><span id="__span-13-31"><a id="__codelineno-13-31" name="__codelineno-13-31" href="#__codelineno-13-31"></a><span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">channel</span><span class="p">.</span><span class="nx">send</span><span class="p">({</span>
3097
+ </span><span id="__span-13-32"><a id="__codelineno-13-32" name="__codelineno-13-32" href="#__codelineno-13-32"></a><span class="w"> </span><span class="nx">message</span><span class="o">:</span><span class="w"> </span><span class="nx">message</span><span class="p">,</span>
3098
+ </span><span id="__span-13-33"><a id="__codelineno-13-33" name="__codelineno-13-33" href="#__codelineno-13-33"></a><span class="w"> </span><span class="nx">thread_id</span><span class="o">:</span><span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">threadId</span>
3099
+ </span><span id="__span-13-34"><a id="__codelineno-13-34" name="__codelineno-13-34" href="#__codelineno-13-34"></a><span class="w"> </span><span class="p">})</span>
3100
+ </span><span id="__span-13-35"><a id="__codelineno-13-35" name="__codelineno-13-35" href="#__codelineno-13-35"></a><span class="w"> </span><span class="p">}</span>
3101
+ </span><span id="__span-13-36"><a id="__codelineno-13-36" name="__codelineno-13-36" href="#__codelineno-13-36"></a>
3102
+ </span><span id="__span-13-37"><a id="__codelineno-13-37" name="__codelineno-13-37" href="#__codelineno-13-37"></a><span class="w"> </span><span class="nx">handleMessage</span><span class="p">(</span><span class="nx">data</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
3103
+ </span><span id="__span-13-38"><a id="__codelineno-13-38" name="__codelineno-13-38" href="#__codelineno-13-38"></a><span class="w"> </span><span class="k">switch</span><span class="w"> </span><span class="p">(</span><span class="nx">data</span><span class="p">.</span><span class="nx">type</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
3104
+ </span><span id="__span-13-39"><a id="__codelineno-13-39" name="__codelineno-13-39" href="#__codelineno-13-39"></a><span class="w"> </span><span class="k">case</span><span class="w"> </span><span class="s2">&quot;complete&quot;</span><span class="o">:</span>
3105
+ </span><span id="__span-13-40"><a id="__codelineno-13-40" name="__codelineno-13-40" href="#__codelineno-13-40"></a><span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">currentResponse</span><span class="p">.</span><span class="nx">textContent</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">data</span><span class="p">.</span><span class="nx">content</span>
3106
+ </span><span id="__span-13-41"><a id="__codelineno-13-41" name="__codelineno-13-41" href="#__codelineno-13-41"></a><span class="w"> </span><span class="k">break</span>
3107
+ </span><span id="__span-13-42"><a id="__codelineno-13-42" name="__codelineno-13-42" href="#__codelineno-13-42"></a><span class="w"> </span><span class="p">}</span>
3108
+ </span><span id="__span-13-43"><a id="__codelineno-13-43" name="__codelineno-13-43" href="#__codelineno-13-43"></a><span class="w"> </span><span class="p">}</span>
3109
+ </span><span id="__span-13-44"><a id="__codelineno-13-44" name="__codelineno-13-44" href="#__codelineno-13-44"></a>
3110
+ </span><span id="__span-13-45"><a id="__codelineno-13-45" name="__codelineno-13-45" href="#__codelineno-13-45"></a><span class="w"> </span><span class="nx">appendMessage</span><span class="p">(</span><span class="nx">role</span><span class="p">,</span><span class="w"> </span><span class="nx">content</span><span class="p">)</span><span class="w"> </span><span class="p">{</span>
3111
+ </span><span id="__span-13-46"><a id="__codelineno-13-46" name="__codelineno-13-46" href="#__codelineno-13-46"></a><span class="w"> </span><span class="kd">const</span><span class="w"> </span><span class="nx">div</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nb">document</span><span class="p">.</span><span class="nx">createElement</span><span class="p">(</span><span class="s2">&quot;div&quot;</span><span class="p">)</span>
3112
+ </span><span id="__span-13-47"><a id="__codelineno-13-47" name="__codelineno-13-47" href="#__codelineno-13-47"></a><span class="w"> </span><span class="nx">div</span><span class="p">.</span><span class="nx">className</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="sb">`message </span><span class="si">${</span><span class="nx">role</span><span class="si">}</span><span class="sb">`</span>
3113
+ </span><span id="__span-13-48"><a id="__codelineno-13-48" name="__codelineno-13-48" href="#__codelineno-13-48"></a><span class="w"> </span><span class="nx">div</span><span class="p">.</span><span class="nx">textContent</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nx">content</span>
3114
+ </span><span id="__span-13-49"><a id="__codelineno-13-49" name="__codelineno-13-49" href="#__codelineno-13-49"></a><span class="w"> </span><span class="k">this</span><span class="p">.</span><span class="nx">messagesTarget</span><span class="p">.</span><span class="nx">appendChild</span><span class="p">(</span><span class="nx">div</span><span class="p">)</span>
3115
+ </span><span id="__span-13-50"><a id="__codelineno-13-50" name="__codelineno-13-50" href="#__codelineno-13-50"></a><span class="w"> </span><span class="p">}</span>
3116
+ </span><span id="__span-13-51"><a id="__codelineno-13-51" name="__codelineno-13-51" href="#__codelineno-13-51"></a><span class="p">}</span>
3117
+ </span></code></pre></div>
3118
+ <h2 id="view">View<a class="headerlink" href="#view" title="Permanent link">&para;</a></h2>
3119
+ <div class="language-erb highlight"><pre><span></span><code><span id="__span-14-1"><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a><span class="x">&lt;!-- app/views/chats/show.html.erb --&gt;</span>
3120
+ </span><span id="__span-14-2"><a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="x">&lt;div data-controller=&quot;chat&quot;&gt;</span>
3121
+ </span><span id="__span-14-3"><a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a><span class="x"> &lt;div class=&quot;messages&quot; data-chat-target=&quot;messages&quot;&gt;</span>
3122
+ </span><span id="__span-14-4"><a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a><span class="x"> &lt;!-- Messages appear here --&gt;</span>
3123
+ </span><span id="__span-14-5"><a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a><span class="x"> &lt;/div&gt;</span>
3124
+ </span><span id="__span-14-6"><a id="__codelineno-14-6" name="__codelineno-14-6" href="#__codelineno-14-6"></a>
3125
+ </span><span id="__span-14-7"><a id="__codelineno-14-7" name="__codelineno-14-7" href="#__codelineno-14-7"></a><span class="x"> &lt;form data-action=&quot;submit-&gt;chat#send&quot;&gt;</span>
3126
+ </span><span id="__span-14-8"><a id="__codelineno-14-8" name="__codelineno-14-8" href="#__codelineno-14-8"></a><span class="x"> &lt;input type=&quot;text&quot;</span>
3127
+ </span><span id="__span-14-9"><a id="__codelineno-14-9" name="__codelineno-14-9" href="#__codelineno-14-9"></a><span class="x"> data-chat-target=&quot;input&quot;</span>
3128
+ </span><span id="__span-14-10"><a id="__codelineno-14-10" name="__codelineno-14-10" href="#__codelineno-14-10"></a><span class="x"> placeholder=&quot;Type a message...&quot;</span>
3129
+ </span><span id="__span-14-11"><a id="__codelineno-14-11" name="__codelineno-14-11" href="#__codelineno-14-11"></a><span class="x"> autocomplete=&quot;off&quot;&gt;</span>
3130
+ </span><span id="__span-14-12"><a id="__codelineno-14-12" name="__codelineno-14-12" href="#__codelineno-14-12"></a><span class="x"> &lt;button type=&quot;submit&quot;&gt;Send&lt;/button&gt;</span>
3131
+ </span><span id="__span-14-13"><a id="__codelineno-14-13" name="__codelineno-14-13" href="#__codelineno-14-13"></a><span class="x"> &lt;/form&gt;</span>
3132
+ </span><span id="__span-14-14"><a id="__codelineno-14-14" name="__codelineno-14-14" href="#__codelineno-14-14"></a><span class="x">&lt;/div&gt;</span>
3133
+ </span></code></pre></div>
3134
+ <h2 id="running">Running<a class="headerlink" href="#running" title="Permanent link">&para;</a></h2>
3135
+ <div class="language-bash highlight"><pre><span></span><code><span id="__span-15-1"><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a><span class="c1"># Install dependencies</span>
3136
+ </span><span id="__span-15-2"><a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a>bundle<span class="w"> </span>install
3137
+ </span><span id="__span-15-3"><a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a>yarn<span class="w"> </span>install
3138
+ </span><span id="__span-15-4"><a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a>
3139
+ </span><span id="__span-15-5"><a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a><span class="c1"># Setup database</span>
3140
+ </span><span id="__span-15-6"><a id="__codelineno-15-6" name="__codelineno-15-6" href="#__codelineno-15-6"></a>rails<span class="w"> </span>db:migrate
3141
+ </span><span id="__span-15-7"><a id="__codelineno-15-7" name="__codelineno-15-7" href="#__codelineno-15-7"></a>
3142
+ </span><span id="__span-15-8"><a id="__codelineno-15-8" name="__codelineno-15-8" href="#__codelineno-15-8"></a><span class="c1"># Set API key (or configure via config/robot_lab.yml)</span>
3143
+ </span><span id="__span-15-9"><a id="__codelineno-15-9" name="__codelineno-15-9" href="#__codelineno-15-9"></a><span class="nb">export</span><span class="w"> </span><span class="nv">ANTHROPIC_API_KEY</span><span class="o">=</span><span class="s2">&quot;your-key&quot;</span>
3144
+ </span><span id="__span-15-10"><a id="__codelineno-15-10" name="__codelineno-15-10" href="#__codelineno-15-10"></a>
3145
+ </span><span id="__span-15-11"><a id="__codelineno-15-11" name="__codelineno-15-11" href="#__codelineno-15-11"></a><span class="c1"># Start server</span>
3146
+ </span><span id="__span-15-12"><a id="__codelineno-15-12" name="__codelineno-15-12" href="#__codelineno-15-12"></a>bin/dev
3147
+ </span></code></pre></div>
3148
+ <h2 id="key-concepts">Key Concepts<a class="headerlink" href="#key-concepts" title="Permanent link">&para;</a></h2>
3149
+ <ol>
3150
+ <li><strong>Robot Factory</strong>: <code>RobotLab.build(name:, system_prompt:, local_tools:, ...)</code> creates robot instances</li>
3151
+ <li><strong>MywayConfig</strong>: Configuration via YAML files and environment variables, not a configure block</li>
3152
+ <li><strong><code>robot.run("message")</code></strong>: Send a message as a positional string argument</li>
3153
+ <li><strong><code>result.last_text_content</code></strong>: Extract the response text from a <code>RobotResult</code></li>
3154
+ <li><strong>Memory</strong>: Robots have <code>robot.memory</code> for key-value storage; networks share memory</li>
3155
+ <li><strong>Tools</strong>: Ruby classes inheriting from <code>RubyLLM::Tool</code>, passed via <code>local_tools:</code></li>
3156
+ <li><strong>Action Cable</strong>: Real-time streaming to browser</li>
3157
+ <li><strong>Background Jobs</strong>: Non-blocking processing</li>
3158
+ </ol>
3159
+ <h2 id="see-also">See Also<a class="headerlink" href="#see-also" title="Permanent link">&para;</a></h2>
3160
+ <ul>
3161
+ <li><a href="../../guides/rails-integration/">Rails Integration Guide</a></li>
3162
+ <li><a href="../../guides/streaming/">Streaming Guide</a></li>
3163
+ </ul>
3164
+
3165
+
3166
+
3167
+
3168
+
3169
+
3170
+
3171
+
3172
+
3173
+
3174
+
3175
+
3176
+
3177
+ <form class="md-feedback" name="feedback" hidden>
3178
+ <fieldset>
3179
+ <legend class="md-feedback__title">
3180
+ Was this page helpful?
3181
+ </legend>
3182
+ <div class="md-feedback__inner">
3183
+ <div class="md-feedback__list">
3184
+
3185
+ <button class="md-feedback__icon md-icon" type="submit" title="This page was helpful" data-md-value="1">
3186
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 12a8 8 0 0 0-8-8 8 8 0 0 0-8 8 8 8 0 0 0 8 8 8 8 0 0 0 8-8m2 0a10 10 0 0 1-10 10A10 10 0 0 1 2 12 10 10 0 0 1 12 2a10 10 0 0 1 10 10M10 9.5c0 .8-.7 1.5-1.5 1.5S7 10.3 7 9.5 7.7 8 8.5 8s1.5.7 1.5 1.5m7 0c0 .8-.7 1.5-1.5 1.5S14 10.3 14 9.5 14.7 8 15.5 8s1.5.7 1.5 1.5m-5 7.73c-1.75 0-3.29-.73-4.19-1.81L9.23 14c.45.72 1.52 1.23 2.77 1.23s2.32-.51 2.77-1.23l1.42 1.42c-.9 1.08-2.44 1.81-4.19 1.81"/></svg>
3187
+ </button>
3188
+
3189
+ <button class="md-feedback__icon md-icon" type="submit" title="This page could be improved" data-md-value="0">
3190
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 12a8 8 0 0 0-8-8 8 8 0 0 0-8 8 8 8 0 0 0 8 8 8 8 0 0 0 8-8m2 0a10 10 0 0 1-10 10A10 10 0 0 1 2 12 10 10 0 0 1 12 2a10 10 0 0 1 10 10m-6.5-4c.8 0 1.5.7 1.5 1.5s-.7 1.5-1.5 1.5-1.5-.7-1.5-1.5.7-1.5 1.5-1.5M10 9.5c0 .8-.7 1.5-1.5 1.5S7 10.3 7 9.5 7.7 8 8.5 8s1.5.7 1.5 1.5m2 4.5c1.75 0 3.29.72 4.19 1.81l-1.42 1.42C14.32 16.5 13.25 16 12 16s-2.32.5-2.77 1.23l-1.42-1.42C8.71 14.72 10.25 14 12 14"/></svg>
3191
+ </button>
3192
+
3193
+ </div>
3194
+ <div class="md-feedback__note">
3195
+
3196
+ <div data-md-value="1" hidden>
3197
+
3198
+
3199
+
3200
+
3201
+
3202
+
3203
+
3204
+
3205
+
3206
+ Thanks for your feedback!
3207
+ </div>
3208
+
3209
+ <div data-md-value="0" hidden>
3210
+
3211
+
3212
+
3213
+
3214
+
3215
+
3216
+
3217
+
3218
+
3219
+ Thanks for your feedback! Help us improve by creating an issue.
3220
+ </div>
3221
+
3222
+ </div>
3223
+ </div>
3224
+ </fieldset>
3225
+ </form>
3226
+
3227
+
3228
+
3229
+ </article>
3230
+ </div>
3231
+
3232
+
3233
+ <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
3234
+
3235
+ <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
3236
+ </div>
3237
+
3238
+ <button type="button" class="md-top md-icon" data-md-component="top" hidden>
3239
+
3240
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>
3241
+ Back to top
3242
+ </button>
3243
+
3244
+ </main>
3245
+
3246
+ <footer class="md-footer">
3247
+
3248
+
3249
+
3250
+ <nav class="md-footer__inner md-grid" aria-label="Footer" >
3251
+
3252
+
3253
+ <a href="../mcp-server/" class="md-footer__link md-footer__link--prev" aria-label="Previous: MCP Server">
3254
+ <div class="md-footer__button md-icon">
3255
+
3256
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>
3257
+ </div>
3258
+ <div class="md-footer__title">
3259
+ <span class="md-footer__direction">
3260
+ Previous
3261
+ </span>
3262
+ <div class="md-ellipsis">
3263
+ MCP Server
3264
+ </div>
3265
+ </div>
3266
+ </a>
3267
+
3268
+
3269
+ </nav>
3270
+
3271
+
3272
+ <div class="md-footer-meta md-typeset">
3273
+ <div class="md-footer-meta__inner md-grid">
3274
+ <div class="md-copyright">
3275
+
3276
+ <div class="md-copyright__highlight">
3277
+ Copyright &copy; 2025 Dewayne VanHoozer
3278
+ </div>
3279
+
3280
+
3281
+ Made with
3282
+ <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
3283
+ Material for MkDocs
3284
+ </a>
3285
+
3286
+ </div>
3287
+
3288
+
3289
+ <div class="md-social">
3290
+
3291
+
3292
+
3293
+
3294
+
3295
+ <a href="https://github.com/madbomber/robot_lab" target="_blank" rel="noopener" title="RobotLab on GitHub" class="md-social__link">
3296
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
3297
+ </a>
3298
+
3299
+
3300
+
3301
+
3302
+
3303
+ <a href="https://rubygems.org/gems/robot_lab" target="_blank" rel="noopener" title="RobotLab on RubyGems" class="md-social__link">
3304
+ <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M116.7 33.8c4.5-6.1 11.7-9.8 19.3-9.8h240c7.6 0 14.8 3.6 19.3 9.8l112 152c6.8 9.2 6.1 21.9-1.5 30.4l-232 256c-4.5 5-11 7.9-17.8 7.9s-13.2-2.9-17.8-7.9l-232-256c-7.7-8.5-8.3-21.2-1.5-30.4zm38.5 39.8c-3.3 2.5-4.2 7-2.1 10.5l57.4 95.7L63.3 192c-4.1.3-7.3 3.8-7.3 8s3.2 7.6 7.3 8l192 16h1.3l192-16c4.1-.3 7.3-3.8 7.3-8s-3.2-7.6-7.3-8l-147.2-12.3 57.4-95.6c2.1-3.5 1.2-8.1-2.1-10.5s-7.9-2-10.7 1l-90 97.6-90.1-97.6c-2.8-3-7.4-3.4-10.7-1"/></svg>
3305
+ </a>
3306
+
3307
+ </div>
3308
+
3309
+ </div>
3310
+ </div>
3311
+ </footer>
3312
+
3313
+ </div>
3314
+ <div class="md-dialog" data-md-component="dialog">
3315
+ <div class="md-dialog__inner md-typeset"></div>
3316
+ </div>
3317
+
3318
+
3319
+
3320
+
3321
+
3322
+ <script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.instant", "navigation.tracking", "navigation.tabs", "navigation.tabs.sticky", "navigation.path", "navigation.indexes", "navigation.top", "navigation.footer", "toc.follow", "search.suggest", "search.highlight", "search.share", "header.autohide", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.tooltips", "content.action.edit", "content.action.view"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
3323
+
3324
+
3325
+ <script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>
3326
+
3327
+
3328
+ </body>
3329
+ </html>