sf-agent-framework
Version:
AI Agent Orchestration Framework for Salesforce Development - Two-phase architecture with 70% context reduction
363 lines (315 loc) • 12.4 kB
YAML
name: Salesforce Quick Reference Guide Template
description: Concise, user-friendly quick reference guide for Salesforce end users
sections:
- name: Guide Overview
content: |
## Salesforce Quick Reference Guide
### Guide Information
- **System:** Salesforce [Edition]
- **Version:** [Release - e.g., Winter '24]
- **Updated:** [YYYY-MM-DD]
- **Audience:** [Sales Team/Service Team/All Users]
- **Support:** [helpdesk@company.com | ext. 1234]
### What's In This Guide
✓ Essential daily tasks
✓ Keyboard shortcuts
✓ Common troubleshooting
✓ Quick tips & tricks
✓ Important links
- name: Getting Started
content: |
## Quick Start Essentials
### Login & Navigation
```
🌐 Login URL: https://company.my.salesforce.com
📱 Mobile App: Salesforce Mobile (App Store/Google Play)
Navigation Tips:
├─ App Launcher (9 dots) → Switch between apps
├─ Global Search (🔍) → Find anything quickly
├─ Home Tab → Your dashboard & tasks
└─ Setup (⚙️) → Personal settings only
```
### Key Areas Overview
| Area | Purpose | Quick Access |
|------|---------|--------------|
| Home | Dashboard, tasks, calendar | Click Salesforce logo |
| Accounts | Company records | App Launcher → Sales |
| Contacts | People at companies | Tab bar or search |
| Opportunities | Deals/Sales | Pipeline view available |
| Cases | Customer issues | Service Console |
| Reports | Data analysis | App Launcher → Reports |
- name: Daily Tasks
content: |
## Common Daily Activities
### 1️⃣ Create New Records
| Record Type | Quick Method | Alternative |
|-------------|--------------|-------------|
| Lead | Home → New button → Lead | Global Actions (+) |
| Contact | From Account page → New Contact | Contacts tab → New |
| Opportunity | Account → Opportunities → New | Global Actions (+) |
| Task | Any record → Activity timeline | Home → Today's Tasks |
| Event | Calendar → Double-click time slot | Global Actions (+) |
### 2️⃣ Update Records
```
Quick Edit Mode:
1. Hover over field → ✏️ pencil icon
2. Make changes
3. Press Enter or click ✓
Full Edit:
1. Click Edit button (top right)
2. Update multiple fields
3. Click Save
```
### 3️⃣ Log Activities
**Quick Call Log:**
1. Open any record
2. Activity timeline → Log a Call
3. Fill: Subject, Comments
4. Save
**Email Integration:**
- BCC: [your-email]@[company].salesforce.com
- Auto-logs to related records
- name: Search and Find
content: |
## Finding Information Fast
### Global Search Tips
```
Search Operators:
├─ AND: John AND Smith
├─ OR: CEO OR President
├─ Quotes: "exact phrase"
├─ Wildcard: John*
└─ Phone: 415* or (415)
Filter Results:
├─ Click object type on left
├─ Use "All Fields" for deep search
└─ Recent Items appear first
```
### List Views
| Action | How To | Tip |
|--------|--------|-----|
| Switch View | Dropdown → Select view | Pin favorites |
| Filter | 🔽 Filter icon → Add conditions | Save as new view |
| Sort | Click column header | Shift+click for multi-sort |
| Inline Edit | Double-click cell | Select multiple → mass edit |
| Export | ⚙️ → Export | Up to 2000 records |
- name: Keyboard Shortcuts
content: |
## Time-Saving Shortcuts
### Global Shortcuts
| Action | Windows | Mac | Description |
|--------|---------|-----|-------------|
| Global Search | / | / | Focus search box |
| Create New | Ctrl+Alt+N | Cmd+Opt+N | New record menu |
| Save | Ctrl+S | Cmd+S | Save current record |
| Cancel | Esc | Esc | Cancel edit mode |
| Home | Alt+Shift+H | Opt+Shift+H | Go to Home |
| Setup | Alt+Shift+S | Opt+Shift+S | Open Setup |
### List View Shortcuts
```
Navigation:
↑/↓ = Move between records
Enter = Open selected record
Shift+Click = Select range
Ctrl/Cmd+Click = Select multiple
Actions:
E = Edit selected
D = Delete selected
F = Follow/Unfollow
```
- name: Mobile Quick Guide
content: |
## Salesforce Mobile App
### Mobile-Specific Features
| Feature | How To Use | Best For |
|---------|------------|----------|
| Quick Actions | + button (bottom) | Create records on-go |
| Offline Access | Auto-syncs starred items | Field work |
| Voice Notes | Tap microphone in notes | Meeting notes |
| Business Cards | Camera → Scan card | Event networking |
| Check-In | Tap location icon | Customer visits |
| Today View | Swipe right from Home | Daily planning |
### Mobile Tips
```
Optimize for Mobile:
✓ Star important records for offline
✓ Customize mobile navigation
✓ Use compact layouts
✓ Enable push notifications
✓ Download mobile reports
```
- name: Quick Troubleshooting
content: |
## Common Issues & Solutions
### Login Problems
| Issue | Solution | Prevention |
|-------|----------|------------|
| Forgot Password | Click "Forgot Password" → Check email | Use password manager |
| Account Locked | Wait 30 min or contact admin | Don't exceed 5 attempts |
| Invalid Username | Check email address used | Bookmark login page |
| Session Timeout | Log in again | Extend timeout in settings |
### Data Issues
```
Can't Find Record:
├─ Check spelling in search
├─ Try partial search (John*)
├─ Verify correct object type
├─ Check your list view filters
└─ May lack permissions - ask admin
Can't Edit Field:
├─ Check if record is locked
├─ Verify field-level security
├─ Some fields are read-only
└─ Validation rules may block
Missing Features:
├─ Check correct app selected
├─ May need different license
└─ Ask admin for access
```
- name: Tips and Best Practices
content: |
## Power User Tips
### Time Savers
| Tip | How | Benefit |
|-----|-----|---------|
| Favorites | Star important records | Quick access |
| Chatter Follow | Follow records for updates | Stay informed |
| Email Templates | Settings → Email → Templates | Consistent messaging |
| Report Subscriptions | Schedule report emails | Automated insights |
| Macros | Service Console feature | One-click actions |
| Kanban View | Opportunities → Kanban | Visual pipeline |
### Data Quality Tips
```
Before Saving:
✓ Check for duplicates (system warns)
✓ Complete all required fields (red *)
✓ Use standard naming conventions
✓ Add next steps/follow-up tasks
✓ Link related records
```
### Productivity Boosters
1. **Clone Records**: Save time on similar entries
2. **Mass Update**: Select multiple → Mass actions
3. **Quick Text**: Settings → Quick Text (snippets)
4. **Related Lists**: Customize which appear
5. **Bookmarks**: Browser bookmarks for reports/views
- name: Important Links
content: |
## Resources & Support
### Quick Links
```
Internal Resources:
🏠 Salesforce Home: [URL]
📊 Key Reports Dashboard: [URL]
📚 Training Materials: [URL]
💬 Chatter Support Group: [URL]
📧 Email-to-Case: support@company.com
External Resources:
🎓 Trailhead: trailhead.salesforce.com
📖 Help & Training: help.salesforce.com
💡 Success Community: success.salesforce.com
🎥 YouTube: youtube.com/salesforce
```
### Support Contacts
| Need | Contact | Response Time |
|------|---------|---------------|
| Password Reset | IT Help Desk x1234 | 15 minutes |
| Permissions | Salesforce Admin | 4 hours |
| Training | Training Team | 24 hours |
| Bug Report | sf-support@company.com | 24 hours |
| Feature Request | Submit via Chatter | Weekly review |
### Emergency Contacts
**System Down**: Call IT Hotline: 555-911-HELP
**Data Emergency**: Email: data-team@company.com
**Security Issue**: security@company.com (URGENT in subject)
- name: Cheat Sheet
content: |
## One-Page Cheat Sheet
### Essential Formulas & Functions
```
Common Formula Fields:
TODAY() = Current date
NOW() = Current date/time
ISBLANK(field) = Check if empty
CONTAINS(field, "text") = Search text
IF(condition, true, false) = Logic
Report Formulas:
PARENTGROUPVAL = Parent subtotal
PREVGROUPVAL = Previous group
```
### Quick Actions Reference
| Icon | Meaning | Action |
|------|---------|--------|
| ➕ | New/Create | Add records |
| ✏️ | Edit | Modify record |
| 🗑️ | Delete | Remove (careful!) |
| 📎 | Attach | Add files |
| 📧 | Email | Send email |
| 📅 | Calendar | Schedule event |
| 🔄 | Refresh | Update view |
| ⭐ | Favorite | Quick access |
| 👁️ | Preview | Quick view |
| 📤 | Share | Share record |
### Status Indicators
```
Opportunity Stages:
🟦 Prospecting (10%)
🟦 Qualification (20%)
🟨 Needs Analysis (40%)
🟨 Proposal (60%)
🟧 Negotiation (80%)
🟩 Closed Won (100%)
🟥 Closed Lost (0%)
Case Status:
🔵 New
🟡 Working
🟠 Escalated
🟢 Closed
```
- name: Print Version
content: |
## Printable Quick Reference Card
```
┌─────────────────────────────────────┐
│ SALESFORCE QUICK REFERENCE │
├─────────────────────────────────────┤
│ LOGIN: company.my.salesforce.com │
│ HELP: x1234 or help@company.com │
├─────────────────────────────────────┤
│ DAILY TASKS │
│ • Home → Check tasks & calendar │
│ • Log calls after each interaction │
│ • Update opportunity stages │
│ • Check dashboard before EOD │
├─────────────────────────────────────┤
│ SHORTCUTS │
│ Search: / │
│ New Record: Ctrl+Alt+N │
│ Save: Ctrl+S │
│ Home: Alt+Shift+H │
├─────────────────────────────────────┤
│ QUICK TIPS │
│ • Star important records │
│ • Use global search for everything │
│ • Double-click to inline edit │
│ • Follow records for updates │
└─────────────────────────────────────┘
```
processing-instructions: |
When creating quick reference guides:
1. Keep it concise and scannable
2. Use visual elements and icons
3. Focus on most common tasks
4. Include keyboard shortcuts
5. Provide troubleshooting tips
6. Make it printable
7. Update regularly
8. Get user feedback
9. Include support contacts
10. Test with new users
metadata:
version: "1.0"
category: training
complexity: low
estimated-time: "2-3 hours creation"
review-required: false