Initial commit

skills/agentforce-2025.md

@@ -0,0 +1,604 @@
+---
+name: agentforce-2025
+description: Salesforce Agentforce AI agents and autonomous automation (2025)
+---
+
+## 🚨 CRITICAL GUIDELINES
+
+### Windows File Path Requirements
+
+**MANDATORY: Always Use Backslashes on Windows for File Paths**
+
+When using Edit or Write tools on Windows, you MUST use backslashes (`\`) in file paths, NOT forward slashes (`/`).
+
+**Examples:**
+- ❌ WRONG: `D:/repos/project/file.tsx`
+- ✅ CORRECT: `D:\repos\project\file.tsx`
+
+This applies to:
+- Edit tool file_path parameter
+- Write tool file_path parameter
+- All file operations on Windows systems
+
+
+### Documentation Guidelines
+
+**NEVER create new documentation files unless explicitly requested by the user.**
+
+- **Priority**: Update existing README.md files rather than creating new documentation
+- **Repository cleanliness**: Keep repository root clean - only README.md unless user requests otherwise
+- **Style**: Documentation should be concise, direct, and professional - avoid AI-generated tone
+- **User preference**: Only create additional .md files when user specifically asks for documentation
+
+
+---
+
+# Agentforce: AI Agents for Salesforce (2025)
+
+## What is Agentforce?
+
+Agentforce is Salesforce's enterprise AI agent platform that enables autonomous, proactive applications to execute specialized tasks for employees and customers. Agentforce agents use large language models (LLMs) with the Atlas Reasoning Engine to analyze context, reason through decisions, and take action autonomously.
+
+**Key Distinction**: Agentforce represents the evolution from Einstein Copilot (conversational assistant) to autonomous agents that can complete tasks without human prompting.
+
+## Core Architecture
+
+### Atlas Reasoning Engine
+
+The Atlas Reasoning Engine is the brain of Agentforce, enabling agents to:
+- **Understand**: Analyze full context of customer interactions or automated triggers
+- **Decide**: Reason through decisions using LLMs and business logic
+- **Act**: Execute actions autonomously across any system
+- **Learn**: Improve over time based on outcomes and feedback
+
+### Agent Components
+
+```
+┌─────────────────────────────────────────────────┐
+│              Agentforce Agent                   │
+├─────────────────────────────────────────────────┤
+│  1. Topics (what agent handles)                 │
+│  2. Actions (what agent can do)                 │
+│  3. Instructions (how agent behaves)            │
+│  4. Channel Integrations (where agent works)    │
+│  5. Data Sources (what agent knows)             │
+└─────────────────────────────────────────────────┘
+```
+
+## Agentforce 2.0 (GA December 2024)
+
+Agentforce 2.0 is the digital labor platform for enterprises, enabling a limitless workforce through AI agents. Key enhancements:
+
+- **Pre-built Skills Library**: Rapid agent customization with out-of-the-box capabilities
+- **Workflow Integrations**: MuleSoft for Flow, MuleSoft API Catalog, Topic Center (Q1 2025)
+- **Slack Deployment**: Native Slack integration for collaboration agents
+- **Enhanced RAG**: Improved retrieval augmented generation for accurate responses
+- **Advanced Reasoning**: More sophisticated Atlas Reasoning Engine capabilities
+- **Pricing**: $2 per conversation (GA October 25, 2024)
+
+## Building Agents with Agentforce Builder (GA December 2024)
+
+### Step 1: Define Agent Purpose
+
+Identify what the agent should accomplish:
+- **Service Agent**: Handle support cases, answer FAQs, resolve issues (4 new actions in Spring '25)
+- **Sales Development Agent**: Qualify leads, answer product questions, book meetings
+- **Personal Shopper Agent**: Recommend products, handle orders, track shipments
+- **Operations Agent**: Automate approvals, process requests, manage workflows
+- **Slack Agent**: Proactive notifications and collaboration assistance
+
+### Step 2: Configure Agent Topics
+
+Topics define what the agent can help with:
+
+```apex
+// Example: Service Agent Topics
+Topic: Password Reset
+- Intent: User wants to reset password
+- Required Data: Email, Username
+- Connected Action: PasswordResetFlow
+
+Topic: Order Status
+- Intent: User wants order status
+- Required Data: Order Number or Email
+- Connected Action: GetOrderStatus
+
+Topic: Escalate to Human
+- Intent: User needs human assistance
+- Required Data: Case context
+- Connected Action: CreateCase + NotifyAgent
+```
+
+### Step 3: Define Agent Actions
+
+Actions are what the agent can execute. These can be:
+- **Standard Actions**: Pre-built Salesforce actions (create/update records)
+- **Flow Actions**: Custom Flow automations
+- **Apex Actions**: Custom Apex invocable methods
+- **MuleSoft Actions**: API integrations via MuleSoft connectors
+- **External API Actions**: REST/SOAP callouts
+
+**Example Apex Action**:
+```apex
+public class AgentActions {
+    @InvocableMethod(label='Get Order Status' description='Retrieves order status for customer')
+    public static List<OrderStatus> getOrderStatus(List<OrderRequest> requests) {
+        List<OrderStatus> results = new List<OrderStatus>();
+
+        for (OrderRequest req : requests) {
+            Order order = [SELECT Id, Status, EstimatedDelivery__c
+                          FROM Order
+                          WHERE OrderNumber = :req.orderNumber
+                          LIMIT 1];
+
+            OrderStatus status = new OrderStatus();
+            status.orderNumber = req.orderNumber;
+            status.status = order.Status;
+            status.estimatedDelivery = order.EstimatedDelivery__c;
+            results.add(status);
+        }
+
+        return results;
+    }
+
+    public class OrderRequest {
+        @InvocableVariable(required=true)
+        public String orderNumber;
+    }
+
+    public class OrderStatus {
+        @InvocableVariable
+        public String orderNumber;
+        @InvocableVariable
+        public String status;
+        @InvocableVariable
+        public Date estimatedDelivery;
+    }
+}
+```
+
+### Step 4: Write Agent Instructions
+
+Instructions guide the agent's behavior and tone:
+
+```
+You are a helpful customer service agent for Acme Corp.
+
+Personality:
+- Friendly, professional, and empathetic
+- Patient with customers who are frustrated
+- Proactive in offering solutions
+
+Guidelines:
+- Always greet customers by name if available
+- Verify customer identity before sharing account information
+- Offer alternatives if the requested action cannot be completed
+- Escalate to human agent for: refunds >$500, legal issues, abusive customers
+- Use simple language, avoid jargon
+- Provide order numbers and case numbers in responses
+
+Security:
+- Never share: passwords, credit card numbers, SSN
+- Always verify identity using: email, phone, or account number
+- Log all interactions for compliance
+
+Response Format:
+- Keep responses under 3 sentences when possible
+- Use bullet points for multiple items
+- Include next steps or call-to-action
+```
+
+### Step 5: Connect Data Sources
+
+Agentforce agents can access:
+- **Salesforce Objects**: Standard and custom objects
+- **Data Cloud**: Unified customer data from all sources
+- **Knowledge Base**: Salesforce Knowledge articles
+- **External Systems**: Via APIs and MuleSoft connectors
+
+**Data Cloud Integration**:
+```apex
+// Query Data Cloud from Agentforce
+public class AgentDataCloudActions {
+    @InvocableMethod(label='Get Customer 360 View')
+    public static List<Customer360> getCustomer360(List<String> customerIds) {
+        // Query Data Cloud for unified customer data
+        List<Customer360> results = new List<Customer360>();
+
+        for (String customerId : customerIds) {
+            // Data Cloud connector provides unified view
+            DataCloudConnector.QueryRequest req = new DataCloudConnector.QueryRequest();
+            req.sql = 'SELECT * FROM Unified_Customer WHERE customer_id = \'' + customerId + '\'';
+
+            DataCloudConnector.QueryResponse res = DataCloudConnector.query(req);
+
+            Customer360 customer = new Customer360();
+            customer.customerId = customerId;
+            customer.totalPurchases = (Decimal)res.data.get('total_purchases');
+            customer.preferredChannel = (String)res.data.get('preferred_channel');
+            customer.lifetimeValue = (Decimal)res.data.get('lifetime_value');
+            results.add(customer);
+        }
+
+        return results;
+    }
+}
+```
+
+### Step 6: Configure Channels
+
+Deploy agents across multiple channels:
+- **Web Chat**: Embedded on website
+- **Mobile App**: In Salesforce Mobile or custom apps
+- **SMS/WhatsApp**: Messaging platforms
+- **Slack/Teams**: Collaboration tools
+- **Voice**: Phone support with voice-to-text
+- **Email**: Email case management
+
+## Agent Types and Use Cases
+
+### 1. Service Agent (Customer Support)
+
+**Capabilities**:
+- Answer FAQs from Knowledge Base
+- Retrieve order/account status
+- Process returns and exchanges
+- Reset passwords and unlock accounts
+- Create and route cases to specialists
+- Provide troubleshooting steps
+
+**Example Flow**:
+```
+Customer: "Where is my order #12345?"
+↓
+Agent: Validates order number
+↓
+Agent: Queries Order object
+↓
+Agent: Retrieves tracking information
+↓
+Agent: "Your order #12345 shipped yesterday and will arrive Thursday.
+       Tracking: UPS 1Z999AA10123456784. Need anything else?"
+```
+
+### 2. Sales Development Agent (SDR)
+
+**Capabilities**:
+- Qualify inbound leads
+- Answer product questions
+- Handle objections with sales playbooks
+- Book meetings with sales reps
+- Send follow-up emails
+- Update lead scores based on engagement
+
+**Example Flow**:
+```
+Lead: "Tell me about your enterprise plan"
+↓
+Agent: Retrieves product information
+↓
+Agent: Explains features, pricing
+↓
+Agent: Detects buying intent
+↓
+Agent: "Would you like to schedule a demo with our sales team?"
+↓
+Agent: Creates meeting, updates lead status to "Meeting Scheduled"
+```
+
+### 3. Personal Shopper Agent (E-commerce)
+
+**Capabilities**:
+- Recommend products based on preferences
+- Answer product questions
+- Check inventory and availability
+- Process orders and payments
+- Apply discounts and promotions
+- Handle cart abandonment
+
+### 4. Operations Agent (Internal Automation)
+
+**Capabilities**:
+- Process employee requests (PTO, equipment)
+- Automate approvals based on rules
+- Onboard new employees
+- Generate reports and insights
+- Monitor system health
+- Trigger workflows based on events
+
+## Integrating Agentforce with Platform Events
+
+Publish events to trigger Agentforce actions:
+
+```apex
+// Publish event when order status changes
+public class OrderEventPublisher {
+    public static void publishOrderUpdate(Id orderId, String newStatus) {
+        OrderStatusChangeEvent__e event = new OrderStatusChangeEvent__e(
+            OrderId__c = orderId,
+            NewStatus__c = newStatus,
+            Timestamp__c = System.now()
+        );
+
+        EventBus.publish(event);
+
+        // Agentforce subscribes to this event
+        // Triggers proactive customer notification
+    }
+}
+
+// Trigger
+trigger OrderTrigger on Order (after update) {
+    for (Order ord : Trigger.new) {
+        if (ord.Status != Trigger.oldMap.get(ord.Id).Status) {
+            OrderEventPublisher.publishOrderUpdate(ord.Id, ord.Status);
+        }
+    }
+}
+```
+
+**Agentforce Flow** (subscribed to OrderStatusChangeEvent__e):
+```
+1. Receive event
+2. Query order and customer details
+3. Determine notification channel (email, SMS, push)
+4. Generate personalized message using LLM
+5. Send notification via preferred channel
+6. Log interaction in Customer timeline
+```
+
+## Agentforce with External AI Systems
+
+Integrate Agentforce with external AI providers:
+
+### OpenAI GPT Integration
+
+```apex
+public class AgentOpenAIIntegration {
+    @InvocableMethod(label='Generate Response with GPT-4')
+    public static List<String> generateResponse(List<AIRequest> requests) {
+        List<String> responses = new List<String>();
+
+        for (AIRequest req : requests) {
+            HttpRequest httpReq = new HttpRequest();
+            httpReq.setEndpoint('callout:OpenAI/v1/chat/completions');
+            httpReq.setMethod('POST');
+            httpReq.setHeader('Content-Type', 'application/json');
+
+            Map<String, Object> payload = new Map<String, Object>{
+                'model' => 'gpt-4',
+                'messages' => new List<Object>{
+                    new Map<String, String>{
+                        'role' => 'system',
+                        'content' => req.systemPrompt
+                    },
+                    new Map<String, String>{
+                        'role' => 'user',
+                        'content' => req.userMessage
+                    }
+                },
+                'temperature' => 0.7,
+                'max_tokens' => 500
+            };
+
+            httpReq.setBody(JSON.serialize(payload));
+
+            Http http = new Http();
+            HttpResponse httpRes = http.send(httpReq);
+
+            if (httpRes.getStatusCode() == 200) {
+                Map<String, Object> result = (Map<String, Object>)JSON.deserializeUntyped(httpRes.getBody());
+                List<Object> choices = (List<Object>)result.get('choices');
+                Map<String, Object> choice = (Map<String, Object>)choices[0];
+                Map<String, Object> message = (Map<String, Object>)choice.get('message');
+                responses.add((String)message.get('content'));
+            }
+        }
+
+        return responses;
+    }
+
+    public class AIRequest {
+        @InvocableVariable(required=true)
+        public String systemPrompt;
+        @InvocableVariable(required=true)
+        public String userMessage;
+    }
+}
+```
+
+### Anthropic Claude Integration
+
+```apex
+public class AgentClaudeIntegration {
+    @InvocableMethod(label='Generate Response with Claude')
+    public static List<String> generateResponse(List<AIRequest> requests) {
+        List<String> responses = new List<String>();
+
+        for (AIRequest req : requests) {
+            HttpRequest httpReq = new HttpRequest();
+            httpReq.setEndpoint('callout:Anthropic/v1/messages');
+            httpReq.setMethod('POST');
+            httpReq.setHeader('Content-Type', 'application/json');
+            httpReq.setHeader('anthropic-version', '2023-06-01');
+
+            Map<String, Object> payload = new Map<String, Object>{
+                'model' => 'claude-3-5-sonnet-20241022',
+                'max_tokens' => 1024,
+                'system' => req.systemPrompt,
+                'messages' => new List<Object>{
+                    new Map<String, String>{
+                        'role' => 'user',
+                        'content' => req.userMessage
+                    }
+                }
+            };
+
+            httpReq.setBody(JSON.serialize(payload));
+
+            Http http = new Http();
+            HttpResponse httpRes = http.send(httpReq);
+
+            if (httpRes.getStatusCode() == 200) {
+                Map<String, Object> result = (Map<String, Object>)JSON.deserializeUntyped(httpRes.getBody());
+                List<Object> content = (List<Object>)result.get('content');
+                Map<String, Object> contentBlock = (Map<String, Object>)content[0];
+                responses.add((String)contentBlock.get('text'));
+            }
+        }
+
+        return responses;
+    }
+}
+```
+
+## Monitoring and Analytics
+
+### Agent Performance Metrics
+
+Track agent effectiveness:
+- **Resolution Rate**: % of interactions resolved without escalation
+- **Average Handle Time**: Time to resolve customer request
+- **Customer Satisfaction**: Post-interaction survey scores
+- **Containment Rate**: % of interactions handled by agent vs human
+- **Action Success Rate**: % of successful action executions
+
+**Custom Reporting Object**:
+```apex
+public class AgentInteractionLogger {
+    public static void logInteraction(String agentName, String topic,
+                                     Boolean resolved, Decimal duration) {
+        AgentInteraction__c interaction = new AgentInteraction__c(
+            AgentName__c = agentName,
+            Topic__c = topic,
+            Resolved__c = resolved,
+            Duration__c = duration,
+            Timestamp__c = System.now()
+        );
+        insert interaction;
+    }
+}
+```
+
+### Analytics Dashboard Queries
+
+```sql
+-- Resolution rate by agent
+SELECT AgentName__c,
+       COUNT(Id) as TotalInteractions,
+       SUM(CASE WHEN Resolved__c = true THEN 1 ELSE 0 END) as Resolved,
+       AVG(Duration__c) as AvgDuration
+FROM AgentInteraction__c
+WHERE CreatedDate = LAST_N_DAYS:30
+GROUP BY AgentName__c
+
+-- Top topics requiring human escalation
+SELECT Topic__c,
+       COUNT(Id) as Escalations
+FROM AgentInteraction__c
+WHERE Resolved__c = false
+  AND CreatedDate = LAST_N_DAYS:30
+GROUP BY Topic__c
+ORDER BY COUNT(Id) DESC
+LIMIT 10
+```
+
+## Best Practices
+
+### Security and Compliance
+- **Field-Level Security**: Always use WITH SECURITY_ENFORCED in SOQL
+- **Data Access**: Respect sharing rules with `with sharing` keywords
+- **PII Protection**: Never log sensitive data (SSN, credit cards, passwords)
+- **Audit Trail**: Log all agent actions for compliance
+- **Human Oversight**: Require approval for high-impact actions
+
+### Performance Optimization
+- **Batch Processing**: Group similar actions to reduce API calls
+- **Caching**: Cache frequently accessed data (product catalogs, FAQs)
+- **Async Execution**: Use @future or Queueable for non-critical actions
+- **Rate Limiting**: Implement throttling for external API calls
+- **Timeout Handling**: Set appropriate timeouts and retry logic
+
+### User Experience
+- **Response Time**: Aim for <3 second responses
+- **Personalization**: Use customer data for personalized responses
+- **Transparency**: Clearly identify agent vs human interactions
+- **Escalation**: Provide easy path to human agent when needed
+- **Feedback Loop**: Collect user feedback to improve agent
+
+### Testing
+- **Unit Tests**: Test individual actions in isolation
+- **Integration Tests**: Test end-to-end agent flows
+- **Load Tests**: Simulate high volume to test scalability
+- **User Acceptance Tests**: Validate with real users in sandbox
+- **A/B Testing**: Compare different agent configurations
+
+## Agentforce Pricing and Licensing (2025)
+
+- **Agentforce Service Agent**: $2 per conversation (GA October 2024)
+- **Agentforce Sales Development Agent**: $2 per conversation
+- **Custom Agents**: Available with Einstein 1 Edition or add-on
+- **Agent Runs**: 600 free orchestration runs per year (Enterprise+)
+- **Consumption Model**: Pay-per-use based on conversations
+- **Vision**: One billion agents with Agentforce by end of 2025
+
+## Spring '25 and Summer '25 Updates
+
+### Spring '25 (API 63.0) - Available Q2 2025
+- **Enhanced Service Agent**: 4 new agent actions + 1 new topic
+- **Salesforce LLM Open Connector**: Connect any LLM (OpenAI, Claude, custom models)
+- **Conversation Context Testing**: Specify language, app, page type for precise testing
+- **Einstein Decision Element**: Automate flow paths based on email engagement metrics
+- **Einstein-Powered Flow Creation**: New Einstein Panel in Flow Builder
+
+### Summer '25 (API 64.0) - Available Q3 2025
+- **Hybrid Search**: Combines semantic search with keyword search for accuracy
+- **Multi-language Semantic Search**: Cross-language case similarity (e.g., French → English)
+- **Report Formula Generation**: Plain language descriptions create complex formulas
+- **AI-driven Account Summarization**: Automated insights for service agents
+
+## Resources
+
+- **Agentforce Platform**: https://www.salesforce.com/agentforce/
+- **Agentforce Builder Documentation**: https://help.salesforce.com/s/articleView?id=sf.einstein_studio.htm
+- **Einstein 1 Studio**: https://help.salesforce.com/s/articleView?id=sf.einstein_studio.htm
+- **Atlas Reasoning Engine**: Technical documentation in Winter '26 release notes
+- **Agentforce Trailhead**: Search "Agentforce" on Trailhead for modules
+- **LLM Open Connector**: Spring '25 release notes
+
+## Migration from Einstein Copilot
+
+**IMPORTANT**: Einstein Copilot was retired in January 2025 and renamed to "Agentforce (Default)". It is now one of the Agentforce agents.
+
+If you have Einstein Copilot (now Agentforce Assistant), migration path:
+
+```
+Einstein Copilot → Agentforce (Default)
+- Automatically migrated in January 2025
+- Conversational UI remains the same
+- Add autonomous triggers and workflows
+- Convert Copilot Actions to Agent Actions
+- Add proactive agent behaviors
+- Enable multi-channel deployment (including Slack in 2.0)
+```
+
+**Action Migration Example**:
+```apex
+// Einstein Copilot Action (reactive)
+@InvocableMethod(label='Copilot: Get Account Info')
+public static List<Account> getAccountInfo(List<Id> accountIds) {
+    return [SELECT Id, Name, Industry FROM Account WHERE Id IN :accountIds];
+}
+
+// Agentforce Action (proactive + reactive)
+@InvocableMethod(label='Agent: Monitor and Alert on Account Changes')
+public static void monitorAccounts(List<Id> accountIds) {
+    // Not only retrieve data, but also:
+    // 1. Monitor for changes
+    // 2. Detect anomalies (sudden revenue drop)
+    // 3. Proactively alert account manager
+    // 4. Suggest next best actions
+}
+```
+
+Agentforce represents a paradigm shift from conversational assistants to autonomous agents that can complete complex, multi-step tasks without human intervention while maintaining trust and security.