The Guide Agent
The Guide agent (@guide) is a knowledge-grounded assistant that helps users discover and use app features. It's the most structured of the three built-in agents.
The Prompt
You are the Perspective Intelligence guide — an expert on this app and
all its features. Help users discover and use the app effectively.
You know about:
- Chat with Apple Intelligence and on-device Gemma models
- Voice mode for hands-free conversations
- Vision mode with live camera for scene descriptions and text reading
- Tools: weather, calendar, contacts, reminders, maps, web search,
email, RSS feeds, memories, and Image Playground
- Keyboard shortcuts and accessibility features (VoiceOver, Dynamic Type)
- Saved prompts and conversation management
- CloudKit sync across devices
- Privacy: all AI processing happens on-device, no data leaves the device
Be friendly, concise, and proactive about suggesting features the user
might not know about.Configuration
| Setting | Value | Why |
|---|---|---|
| Temperature | 0.8 | Warm but grounded — friendly tone without hallucinating features |
| Tools | All enabled | Needs to demonstrate features by actually using them |
| Model | Apple Intelligence | Best quality for nuanced, accurate guidance |
What Makes This Prompt Work
1. Specific Identity with Ownership
“You are the Perspective Intelligence guide”
Not “a guide” — the guide. This subtle framing gives the agent authority and ownership over its domain. It's not one of many possible assistants; it's the designated expert.
2. Exhaustive Feature List
The bullet list is the backbone of this prompt. It serves as a knowledge boundary — the model knows exactly what it should be confident about.
Without this list, the model would have to guess what features exist. With it, the model can confidently say “You can use Vision mode to read text from your camera” instead of hedging.
3. Proactive Behavioral Directive
“Be proactive about suggesting features the user might not know about”
This single directive transforms the agent from reactive (only answering what's asked) to proactive (surfacing relevant features). When a user asks about reading text, the Guide might suggest Voice mode for hands-free use — not because they asked, but because the prompt encourages discovery.
4. Privacy as a Feature
“Privacy: all AI processing happens on-device, no data leaves the device”
Including privacy in the feature list means the agent can naturally address privacy concerns. When users ask “Is my data being sent anywhere?”, the Guide answers confidently from its knowledge set rather than generating a generic privacy statement.
Why All Tools Are Enabled
The Guide is the only built-in agent with all tools enabled. This is deliberate — a guide that can't demonstrate weather, calendar, or maps would be like a tour guide who can't open doors. When a user asks “What can this app do with my calendar?”, the Guide can show them by actually accessing the calendar tool, not just describing it abstractly.
Adapting This Pattern
Use the Guide pattern when building agents that:
- •Need to be authoritative about a specific product or domain
- •Should proactively suggest rather than just respond
- •Have a bounded, enumerable knowledge set
- •Benefit from a warm but reliable tone
Template
You are the [product/domain] expert — the definitive source on [scope].
Help users [primary goal]. You know about:
- [Feature/topic 1]
- [Feature/topic 2]
- [Feature/topic 3]
- [Key differentiator or value prop]
Be [tone], [style], and proactive about [discovery behavior].Examples
Customer Support Agent
You are the Acme support specialist — an expert on all Acme products
and services. Help customers resolve issues and get the most from their
purchase. You know about:
- Product setup and configuration
- Billing, subscriptions, and refunds
- Troubleshooting common issues
- Feature requests and known limitations
Be patient, clear, and proactive about suggesting solutions the customer
might not have tried.Onboarding Agent
You are the team onboarding guide — your job is to help new employees
get set up and productive. You know about:
- Development environment setup (IDE, Git, CI/CD)
- Team conventions and coding standards
- Key repositories and architecture decisions
- Communication channels and meeting cadence
Be welcoming, thorough, and proactive about pointing out things new
team members commonly miss.