Skip to content

Commit 1f34686

Browse files
dev-seth-vapidvsth
andauthored
Add selected GPT-Live guide illustrations (#1274)
Co-authored-by: dev-seth-vapi <dev@devseth.com>
1 parent 4157d07 commit 1f34686

29 files changed

Lines changed: 111 additions & 1 deletion

‎fern/assets/styles.css‎

Lines changed: 45 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -383,4 +383,48 @@ html.dark button[data-highlighted] .fern-api-property-meta {
383383
:is(.dark) .subscribe-form-message.error {
384384
color: #fca5a5;
385385
background-color: #7f1d1d;
386-
}
386+
}
387+
388+
/* GPT-Live illustrations follow the docs theme and use a compact drawing on phones. */
389+
.gpt-live-illustration {
390+
max-width: 640px;
391+
margin: 2rem auto;
392+
}
393+
394+
.gpt-live-illustration img {
395+
display: none;
396+
width: 100%;
397+
height: auto;
398+
margin: 0;
399+
}
400+
401+
.gpt-live-illustration .gpt-live-art-light {
402+
display: block;
403+
}
404+
405+
.dark .gpt-live-illustration .gpt-live-art-light {
406+
display: none;
407+
}
408+
409+
.dark .gpt-live-illustration .gpt-live-art-dark {
410+
display: block;
411+
}
412+
413+
@media (max-width: 540px) {
414+
.gpt-live-illustration .gpt-live-art-light,
415+
.dark .gpt-live-illustration .gpt-live-art-dark {
416+
display: none;
417+
}
418+
419+
.gpt-live-illustration .gpt-live-art-light-compact {
420+
display: block;
421+
}
422+
423+
.dark .gpt-live-illustration .gpt-live-art-light-compact {
424+
display: none;
425+
}
426+
427+
.dark .gpt-live-illustration .gpt-live-art-dark-compact {
428+
display: block;
429+
}
430+
}

‎fern/gpt-live/design.mdx‎

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -88,6 +88,13 @@ Start each piece of work as soon as its inputs are known, and use the conversati
8888
- A time can be chosen only after the open times are known.
8989
- A booking can be announced only after the booking tool confirms it.
9090

91+
<div className="gpt-live-illustration">
92+
<img className="gpt-live-art-light" src="../static/images/gpt-live/dependency-cairn-light.svg" alt="Stacked stones show the dependencies for booking: service, location and date support open times, a chosen time and caller agreement. The name can be gathered independently." loading="lazy" />
93+
<img className="gpt-live-art-dark" src="../static/images/gpt-live/dependency-cairn-dark.svg" alt="Stacked stones show the dependencies for booking: service, location and date support open times, a chosen time and caller agreement. The name can be gathered independently." loading="lazy" />
94+
<img className="gpt-live-art-light-compact" src="../static/images/gpt-live/dependency-cairn-light-compact.svg" alt="Stacked stones show the dependencies for booking: service, location and date support open times, a chosen time and caller agreement. The name can be gathered independently." loading="lazy" />
95+
<img className="gpt-live-art-dark-compact" src="../static/images/gpt-live/dependency-cairn-dark-compact.svg" alt="Stacked stones show the dependencies for booking: service, location and date support open times, a chosen time and caller agreement. The name can be gathered independently." loading="lazy" />
96+
</div>
97+
9198
The useful test for any question during a lookup is whether the outstanding work still answers the caller's need after they reply. In this example, the lookup tool returns every open time for the requested day and location. So if the caller says "afternoon, ideally after three" while that lookup runs, the result still covers it, and the assistant can filter. If the caller says "Actually, can we do Riverside instead?", the running lookup no longer answers the request, and a new one is needed.
9299

93100
That's why the example lookup returns the whole day rather than taking a time-of-day argument. When you design your own tools, return enough to answer the likely follow-up questions without another round trip, as long as the result stays short.
@@ -293,6 +300,13 @@ Existing squads and assistant handoffs aren't supported with GPT-Live. See [Migr
293300

294301
The speaker hears the caller's voice, but the reasoner works from the transcript, and a transcript can contain mistakes. A name, reference number, or date that's slightly wrong in the transcript becomes a wrong tool argument.
295302

303+
<div className="gpt-live-illustration">
304+
<img className="gpt-live-art-light" src="../static/images/gpt-live/name-prism-light.svg" alt="One spoken name branches into three possible spellings, with Siobhan highlighted." loading="lazy" />
305+
<img className="gpt-live-art-dark" src="../static/images/gpt-live/name-prism-dark.svg" alt="One spoken name branches into three possible spellings, with Siobhan highlighted." loading="lazy" />
306+
<img className="gpt-live-art-light-compact" src="../static/images/gpt-live/name-prism-light-compact.svg" alt="One spoken name branches into three possible spellings, with Siobhan highlighted." loading="lazy" />
307+
<img className="gpt-live-art-dark-compact" src="../static/images/gpt-live/name-prism-dark-compact.svg" alt="One spoken name branches into three possible spellings, with Siobhan highlighted." loading="lazy" />
308+
</div>
309+
296310
For anything the task depends on, have the assistant read it back before acting:
297311

298312
> **Caller:** It's under Siobhan.
@@ -341,6 +355,13 @@ what they say.
341355

342356
A consistent personality doesn't require a constant pace.
343357

358+
<div className="gpt-live-illustration">
359+
<img className="gpt-live-art-light" src="../static/images/gpt-live/pacing-dunes-light.svg" alt="A single voice moves through closely spaced waves into wider, more spacious rhythms." loading="lazy" />
360+
<img className="gpt-live-art-dark" src="../static/images/gpt-live/pacing-dunes-dark.svg" alt="A single voice moves through closely spaced waves into wider, more spacious rhythms." loading="lazy" />
361+
<img className="gpt-live-art-light-compact" src="../static/images/gpt-live/pacing-dunes-light-compact.svg" alt="A single voice moves through closely spaced waves into wider, more spacious rhythms." loading="lazy" />
362+
<img className="gpt-live-art-dark-compact" src="../static/images/gpt-live/pacing-dunes-dark-compact.svg" alt="A single voice moves through closely spaced waves into wider, more spacious rhythms." loading="lazy" />
363+
</div>
364+
344365
| Moment | Delivery to aim for |
345366
| --- | --- |
346367
| The caller knows what they want | Short questions and concise answers |

‎fern/gpt-live/migrate.mdx‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -74,6 +74,13 @@ You can also migrate by hand through the API: create a new assistant with the GP
7474

7575
A classic assistant has one prompt that covers both how to talk and how to do the work. GPT-Live has two. The speaker prompt shapes the conversation and says when to delegate. The reasoner prompt holds the procedures and tool rules. Neither sees the other, so rules that affect both belong in both, worded for each role.
7676

77+
<div className="gpt-live-illustration">
78+
<img className="gpt-live-art-light" src="../static/images/gpt-live/split-prompt-light.svg" alt="Prompt instructions separate into speaker and reasoner bundles. One shared rule branches into both." loading="lazy" />
79+
<img className="gpt-live-art-dark" src="../static/images/gpt-live/split-prompt-dark.svg" alt="Prompt instructions separate into speaker and reasoner bundles. One shared rule branches into both." loading="lazy" />
80+
<img className="gpt-live-art-light-compact" src="../static/images/gpt-live/split-prompt-light-compact.svg" alt="Prompt instructions separate into speaker and reasoner bundles. One shared rule branches into both." loading="lazy" />
81+
<img className="gpt-live-art-dark-compact" src="../static/images/gpt-live/split-prompt-dark-compact.svg" alt="Prompt instructions separate into speaker and reasoner bundles. One shared rule branches into both." loading="lazy" />
82+
</div>
83+
7784
For example, a classic prompt for an appointment assistant at Example Service Studio, a fictional business, might read:
7885

7986
```text title="Before: one classic system prompt"

‎fern/gpt-live/testing.mdx‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -100,6 +100,13 @@ Callers notice two kinds of delay, and they have different causes:
100100

101101
Measure them separately. The call's messages and your service's logs have timestamps for delegations and tool calls, and the recording shows when the caller heard each part.
102102

103+
<div className="gpt-live-illustration">
104+
<img className="gpt-live-art-light" src="../static/images/gpt-live/two-delays-light.svg" alt="Two intervals begin at the same moment: a short interval to the first reply and a longer interval to the result." loading="lazy" />
105+
<img className="gpt-live-art-dark" src="../static/images/gpt-live/two-delays-dark.svg" alt="Two intervals begin at the same moment: a short interval to the first reply and a longer interval to the result." loading="lazy" />
106+
<img className="gpt-live-art-light-compact" src="../static/images/gpt-live/two-delays-light-compact.svg" alt="Two intervals begin at the same moment: a short interval to the first reply and a longer interval to the result." loading="lazy" />
107+
<img className="gpt-live-art-dark-compact" src="../static/images/gpt-live/two-delays-dark-compact.svg" alt="Two intervals begin at the same moment: a short interval to the first reply and a longer interval to the result." loading="lazy" />
108+
</div>
109+
103110
When the task takes too long, try these, one at a time, and check that the outcome is still correct after each change:
104111

105112
| Cause | What to try |

‎fern/gpt-live/tools.mdx‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,6 +30,13 @@ A tool's inputs and results shape the conversation as much as the prompts do.
3030

3131
**Return enough to answer the likely follow-up.** The example lookup takes a service, location, and date, and returns every open time for that day. If the caller adds "ideally after three" while it runs, the result still answers the request, and the assistant can filter it without another lookup. A different day or location changes the request, so it needs a new lookup. Keep results short even when they're complete.
3232

33+
<div className="gpt-live-illustration">
34+
<img className="gpt-live-art-light" src="../static/images/gpt-live/whole-day-light.svg" alt="Available times are 10:30 AM, 2:30 PM and 4:00 PM. The after-3-PM region highlights 4:00 PM within the same result." loading="lazy" />
35+
<img className="gpt-live-art-dark" src="../static/images/gpt-live/whole-day-dark.svg" alt="Available times are 10:30 AM, 2:30 PM and 4:00 PM. The after-3-PM region highlights 4:00 PM within the same result." loading="lazy" />
36+
<img className="gpt-live-art-light-compact" src="../static/images/gpt-live/whole-day-light-compact.svg" alt="Available times are 10:30 AM, 2:30 PM and 4:00 PM. The after-3-PM region highlights 4:00 PM within the same result." loading="lazy" />
37+
<img className="gpt-live-art-dark-compact" src="../static/images/gpt-live/whole-day-dark-compact.svg" alt="Available times are 10:30 AM, 2:30 PM and 4:00 PM. The after-3-PM region highlights 4:00 PM within the same result." loading="lazy" />
38+
</div>
39+
3340
**Echo the request details.** Include the date and location in each result. When the caller changes their mind during a lookup, the earlier result may still come back, and the details make it easy to recognize as out of date.
3441

3542
**Say what didn't happen, as well as what did.** "Availability only. Nothing has been booked" helps the assistant avoid overstating a lookup.

‎fern/static/images/gpt-live/dependency-cairn-dark-compact.svg‎

Lines changed: 1 addition & 0 deletions
Loading

‎fern/static/images/gpt-live/dependency-cairn-dark.svg‎

Lines changed: 1 addition & 0 deletions
Loading

‎fern/static/images/gpt-live/dependency-cairn-light-compact.svg‎

Lines changed: 1 addition & 0 deletions
Loading

‎fern/static/images/gpt-live/dependency-cairn-light.svg‎

Lines changed: 1 addition & 0 deletions
Loading
Lines changed: 1 addition & 0 deletions
Loading

0 commit comments

Comments
 (0)