Airgentic Help
Two prompts make Future Student Experience feel like your institution. Everything else — searching, grounding, button URLs, page layout — is platform behaviour and should stay that way.
Edit prompts on Edit Prompts. Attach them on Configure Agents. See Editing a Prompt for substitutions and version history.
| File | Who edits it | Purpose |
|---|---|---|
agent_future_student.prompt |
You, with Airgentic | How the concierge interviews, consents, and when it hands off |
sub_fse_institution.prompt |
You | Campuses, audiences, how entry and funding actually work here |
Shared components (Tone, Guardrails, Identity, …) |
Usually inherited | Keep consistent with your other agents |
create_experience |
Platform | Starts the job. Not AirScript. Do not replace it with a custom function. |
| Synthesis / grounding rules | Platform | The job’s search-and-write instructions are not a customer prompt, so they cannot be deleted by accident |
Do not put apply URLs, fees, or “this course exists” claims in prompts. Those must come from the index and from CTA configuration.
agent_future_student)This is the concierge’s system prompt. The library copy is a good starting point; services often only change the opening name (for example “You are the My Murdoch Experience concierge”).
It should tell the agent to:
search(), then return to the interview.search_catalog() only to check that a named field is offered at all — never to browse or compare courses in chat.create_experience() once.Before create_experience(), the prompt requires the agent to say, in its own words:
It must not promise immediate deletion, and it must not promise that no person will ever see it.
If they say no, the agent keeps helping in chat and does not start a job.
| Substitution | Typical source | Notes |
|---|---|---|
{{Title}} |
Service title | Institution name in the opening line |
{{prompt:FSE Institution}} |
sub_fse_institution.prompt |
Orientation only — see below |
{{prompt:Tone}} |
Shared tone component | Keep unless this concierge needs a distinct voice |
{{prompt:Guardrails}} |
Shared guardrails | Safety; do not remove |
{{prompt:Information Retrieval}} |
Shared retrieval component | How chat search() behaves |
{{segment:Country}} |
User segment | Optional country-specific lines |
The interview prompt deliberately does not include Query Building or catalog allowlists. Those belong to Study Pathways. Deep catalog work happens inside the job.
The agent’s Role on Configure Agents is what the Frontline agent reads when deciding whether to delegate.
Keep it narrower than Study Pathways. A working pattern:
sub_fse_institution)This is the prompt you should spend time on. It is attached to the concierge as a component and is also injected into the synthesis job.
It is orientation, not evidence. The first lines should say so. The agent may use it to ask better questions. It must not treat a course, campus offering, scholarship, or entry route as proven just because it appears here.
Write in prose, not YAML. Cover:
| Topic | Examples |
|---|---|
| Kind and focus | University vs vocational; local vs national; whether people usually move |
| Campuses and travel | Names they will say; “Melbourne” is not a campus filter; ask what they can actually reach |
| Study areas people arrive asking about | Including common mix-ups (“vet” vs any work with animals; “nursing” vs any care work) |
| Entry | Ranked entry or none; pathway / preparation / recognition of prior learning; never imply a score is required |
| Cost and support | That scholarships or Free TAFE exist as a topic — never name an amount or eligibility from memory |
| Who you are usually talking to | School leavers, mature-age, career changers, regional movers |
University example (shortened):
Murdoch uses a selection rank. It is not the same as a raw ATAR. There are entry routes that do not need a rank at all. Someone who says “I don’t have an ATAR” has not disqualified themselves — say so, and let the job find the actual routes.
Vocational example (shortened):
This is a vocational institute. Recruitment is local. Campus they can reach, travel time, and next intake matter more than almost anything else. There is no ranked school-leaver entry. Do not ask for ATAR. Free TAFE is a government scheme — never imply someone is eligible.
When you add a campus or change how entry works, update this file. Then test in Admin Chat with two or three realistic stories (school leaver, mature-age, “I don’t have a rank”).
| Function | In the interview | Notes |
|---|---|---|
search |
Side questions | Fees, dates, “is there a farm on campus?” Keep answers short. |
search_catalog |
Optional existence check | hits_per_page of 3 or less. Do not read out a course list. |
create_experience |
Once, after consent | Platform function. Passes the profile into the job. |
hand_off_to_agent |
Task has genuinely changed | Expert Finder, Events, Enrolment, or Study Pathways for a named-course comparison. Omit this function on a dedicated landing page that has no other specialists. |
create_experience accepts the profile fields the concierge gathered (interests, home, mobility, constraints, optional entry score, optional email if they offered one) plus consent: true. Extra fields the model invents are dropped.
After create_experience runs, a separate synthesis pass searches your index and produces the page. It is instructed to:
If retrieval is thin, the page will be shorter and more cautious. That is preferable to invented courses. Fix coverage in the crawl and in sub_fse_institution, not by loosening grounding.
data-agent-id="future_student".Use the Trace Log on Admin Chat to see the profile passed into create_experience and which pages the job retrieved.