Airgentic Help
This page lists the settings that turn Future Student Experience on for a service. Airgentic usually applies them with you during setup. Review them when you change recruitment priorities, add a campus, or replace an apply URL.
The interview agent is configured on Configure Agents. The future_student.* keys live in service configuration (the same place as your service title and search settings).
For the product itself, start at Future Student Experience.
The job searches the same index your Study Pathways and Enrolment agents already use. Do not create a second thin crawl. If coverage is weak, fix the crawl — the experience will otherwise invent nothing and omit sections.
Checklist:
scopes.scholarships — do not leave the job to guess.persist_trace_logs: true).Vocational services skip ranked entry. Local recruitment emphasises campus, travel, and next intake instead of “people like me” belonging pages.
| Key | Typical value | What it does |
|---|---|---|
future_student.enabled |
true |
Master switch. When false, the concierge cannot start a job. |
future_student.artifact_title |
My Murdoch Experience |
Title on the page and in the chat “your page is ready” message. Use My {institution} Experience. |
Your service logo (the existing logo setting) can appear at the top of the page. Brand colours come from --brand-* variables in the service style.css — the same tokens used by the chat widget. See UI Design.
These keys change interview emphasis, which page sections are kept, and how the synthesis job searches. They do not create a separate product.
| Key | Values | What it does |
|---|---|---|
future_student.institution_kind |
university, vocational, private_college |
Sets default sections and language. Vocational defaults: no ranked entry section, no belonging section, local recruitment. |
future_student.recruitment_focus |
local, domestic_national, international (list) |
Hints for the interview and retrieval. A TAFE is often [local]; a university might be [domestic_national] or include international. |
future_student.currency |
AUD |
Fees language on the page. |
future_student.region |
AU |
Spelling and which student segments to assume. |
future_student.template |
default |
Leave as default unless Airgentic has given you a custom HTML template. |
| Key | Default (university) | Default (vocational) | Content |
|---|---|---|---|
future_student.sections.entry |
on if a credential is configured | off | Published entry ranks or routes |
future_student.sections.practical |
on | on | Fees, funding, relocation, living, travel |
future_student.sections.belonging |
on | off | Clubs, halls, “people like me” |
future_student.sections.outcomes |
on | on | Jobs and further study |
Turn a section off when you do not have indexed content for it. Empty headings are worse than a shorter page.
Omit this entire block if you do not admit on a published rank (typical for TAFEs). The interview then never asks for a score.
| Key | Example | What it does |
|---|---|---|
future_student.credential.system |
selection_rank |
Label for the score system. Not a global atar field — each institution names its own. |
future_student.credential.attribute |
selection_rank |
The catalog field to filter on. Must be numeric with a range filter. |
future_student.credential.comparison |
lte |
How the student’s number is compared to the course requirement (usually “at or below”). |
A student who says they have no score is not excluded. The job looks for pathway and preparation routes instead.
Map the job’s search areas onto your scope ids from Search Configuration.
| Key | Example | Required? |
|---|---|---|
future_student.scopes.courses |
courses |
Yes |
future_student.scopes.scholarships |
scholarships |
Only if that scope is indexed and you want it on the page |
future_student.scopes.people |
staff |
Optional |
future_student.scopes.events |
events |
Optional |
If a scope is missing here, the job will not search it. Keep this list aligned with Search Scopes and Catalog Search.
The model may only pick from this list. Labels and URLs come from configuration, never from generated text.
future_student.ctas:
- id: apply
label: Start an application
url: https://www.example.edu/apply
- id: open_day
label: Book Open Day
url: https://www.example.edu/events
- id: enquiry
label: Talk to us
url: https://www.example.edu/enquire
| Field | Rules |
|---|---|
id |
Stable token (apply, enquiry, open_day, campus_tour, next_intake, contact, …). Used in analytics. |
label |
Button text on the page. |
url |
A page you own. Update this when marketing changes the apply path. |
A vocational service might use campus_tour and next_intake instead of open_day. You need at least one CTA. Three is plenty.
Clicks on these buttons are recorded, then the student is sent to your URL with campaign parameters (utm_source=airgentic, utm_medium=future_student). Existing UTM on your URL is left alone.
| Key | Typical value | What it does |
|---|---|---|
future_student.require_consent |
true |
The concierge must get a clear yes before starting a job. Leave on. |
future_student.cap_per_session |
2 |
How many pages one chat session may start. Stops loops on a public widget. |
future_student.daily_cap_per_service |
50 |
How many jobs this service may start per UTC day. |
future_student.delivery |
link |
link delivers into chat only. Include email (for example link, email) to also send the link when the student offered an address. The concierge must not ask for email. |
future_student.email_from |
platform default | Override the From address if you use email delivery. |
future_student.retention_days |
30 |
How long the signed page URL stays valid. Shortening this invalidates links already sent. |
persist_trace_logs |
true |
Service-level. Stores the interview so you can review it in Insights. Required for this feature. |
Lead capture on the experience itself is currently off. If someone volunteers a name plus phone or email mid-chat, that still goes to your Lead Gen agent. Gating the page on contact details is a later option — do not add it in prompts.
On Configure Agents, the Future Student Experience agent should look like this:
| Setting | Recommended |
|---|---|
| Status | Testing until you are ready for the Frontline agent to route to it; then Live. A dedicated landing page can pin the agent while it is still Testing. |
| Role | Narrower than Study Pathways. See the examples in Prompts. |
| Initial prompt | agent_future_student |
| Functions | search, create_experience, search_catalog (tight “is this offered?” checks only), and hand_off_to_agent only if other specialists are live |
| Conversation lock | On. Stops a mid-interview “what are the fees?” from being re-routed to another agent. |
| Guided search handoff | Off. A broad catalog search must not abandon the interview for Search Guide. |
| Search URL prefixes | Usually empty. The job already uses the scopes above. |
create_experience is a platform function. It is not editable AirScript. Caps, consent, and CTA URLs are enforced there on purpose.
University, national recruitment
future_student.institution_kind: university
future_student.recruitment_focus:
- domestic_national
future_student.sections:
entry: true
practical: true
belonging: true
outcomes: true
future_student.credential:
system: selection_rank
attribute: selection_rank
comparison: lte
future_student.scopes:
courses: courses
scholarships: scholarships
Vocational, local recruitment
future_student.institution_kind: vocational
future_student.recruitment_focus:
- local
future_student.sections:
entry: false
practical: true
belonging: false
outcomes: true
# no credential block
future_student.scopes:
courses: courses
The difference in voice belongs in sub_fse_institution.prompt, not in extra YAML. See Prompts.