sessions_get_guide
Orientation for an agent that just landed: what this business is, and how to use the rest of the tools.
When to use it
As the first call on any Sessions page — it tells the agent what this business sells and which tools apply.
When you want the business’s cancellation terms in the agent’s context before it discusses changing a booking.
Parameters
This tool takes no arguments.
Returns
Every tool returns two things: text for the model to read, and a structuredContent object beside it for code that would rather branch on a field.
A plain-text orientation for the agent: the business’s name and handle, what it runs, its time zone and currency, the order to use the other tools in, and the cancellation policy currently in force.
Example
Run this from any agent or script executing in the page.
const tools =
await document.modelContext.getTools();
const tool = tools.find(
(t) => t.name === 'sessions_get_guide',
);
const result = await document.modelContext
.executeTool(tool);You are on the Sessions page for Capital Bodywork
(@capital-bodywork).
What this business runs: booking
Times are in America/Toronto; prices are in CAD.
How to help here:
1. sessions_list_schedule to see what is on…{
"business": {
"name": "Capital Bodywork",
"handle": "capital-bodywork",
"timezone": "America/Toronto",
"currency": "cad"
},
"cancellationPolicy": {
"tiers": [
"…"
],
"fallback": {
"refundPercentage": 0
}
}
}What the agent is told
The description the model reads when deciding whether to call this. It is the only thing that decides whether the tool fires at the right moment, so it is worth knowing what it says.