How it works
@@ -68,7 +68,7 @@ def sunset(style:str, season:str):
season="summer"
)
```
- 
+ 
- **Winter impressionism**
@@ -80,7 +80,7 @@ def sunset(style:str, season:str):
season="winter"
)
```
- 
+ 
- **Something else**
@@ -92,7 +92,7 @@ def sunset(style:str, season:str):
season="Christmas in Australia"
)
```
- 
+ 
## Disabling prompt revision
@@ -158,7 +158,7 @@ Using the original prompt "a teacup", here are the results of calling this funct
```
Final prompt:
- 
+ 
> a teacup
@@ -172,7 +172,7 @@ Using the original prompt "a teacup", here are the results of calling this funct
)
```
- 
+ 
Final prompt:
> a porcelain teacup with intricate detailing, sitting on an oak table
@@ -187,7 +187,7 @@ Using the original prompt "a teacup", here are the results of calling this funct
)
```
- 
+ 
Final prompt:
> A porcelain teacup with an intricate floral pattern, placed on a wooden table with soft afternoon sun light pouring in from a nearby window. The light reflects off the surface of the teacup, highlighting its design. The teacup is empty but still warm, as if recently used."
@@ -202,7 +202,7 @@ Using the original prompt "a teacup", here are the results of calling this funct
revision_amount=1
)
```
- 
+ 
Final prompt:
> An old-fashioned, beautifully crafted, ceramic teacup. Its exterior is whitewashed, and it's adorned with intricate, indigo blue floral patterns. The handle is elegantly curved, providing a comfortable grip. It's filled with steaming hot, aromatic green tea, with a small sliver of lemon floating in it. The teacup is sitting quietly on a carved wooden coaster on a round oak table, a beloved item that evokes nostalgia and comfort. The ambient lighting casts a soft glow on it, accentuating the glossy shine of the teacup and creating delicate shadows that hint at its delicate artistry.
diff --git a/docs/ai/interactive/assistants.md b/docs/ai/interactive/assistants.md
new file mode 100644
index 000000000..ce8c0c24b
--- /dev/null
+++ b/docs/ai/interactive/assistants.md
@@ -0,0 +1,334 @@
+# Working with assistants
+
+Many of Marvin's features are standalone functions intended to be invoked a single time. However, interactive conversation is one of the most powerful ways to work with LLMs, allowing collaboration, context discovery, and feedback. OpenAI's assistants API makes this possible while handling stateful complexities like system messages, history, and separate threads. Marvin's assistants API is a Pythonic way to take advantage of those features/
+
+
+
What it does
+
+ Assistants allow you to interact with LLMs in a conversational way, automatically handling history, threads, and custom tools.
+
+