%% Agentforce reference architecture
%% Reference architecture: a reusable pattern, not a live client integration
flowchart TB
  subgraph z0["Your Salesforce org"]
    agent["Agentforce agents<br/>built in Agentforce Builder"]
    script["Agent Script<br/>instructions, actions, escalate"]
    atlas["Atlas Reasoning Engine<br/>reasoning"]
    trust["Einstein Trust Layer<br/>masking, toxicity, audit"]
    gateway["Agentforce Gateway<br/>MCP usage policies"]
    perms["User permissions<br/>CRUD, FLS, sharing"]
    human["Human agents<br/>queues and teams"]
    d360["Data 360 grounding<br/>Agent Context Engine"]
    flow["Flow actions<br/>declarative"]
    apex["Apex actions<br/>invocable methods"]
    mcp["MCP tools<br/>MCP client: beta"]
  end
  subgraph z1["External tool providers"]
    ext["External MCP servers<br/>registered and allowlisted"]
  end
  lightning["Lightning and Coworker<br/>employees"]
  portal["Self-service and web<br/>Experience Cloud"]
  slack["Slack<br/>Agentforce in Slack"]
  voice["Voice<br/>Agentforce Voice"]
  crm["Salesforce records<br/>Sales and Service Cloud"]
  obs["Observability and testing<br/>health, scorers, tests"]
  lightning -->|"employee requests"| agent
  portal -->|"customer messages"| agent
  slack -->|"Slack messages"| agent
  voice -->|"speech"| agent
  agent -->|"instructions"| script
  script -->|"reasoning steps"| atlas
  atlas -->|"LLM calls"| trust
  atlas -->|"action requests"| perms
  atlas -->|"MCP tool calls"| gateway
  trust -->|"grounding"| d360
  perms -->|"run Flow"| flow
  perms -->|"run Apex"| apex
  gateway -->|"allowlisted tools"| mcp
  flow -->|"record updates"| crm
  apex -->|"complex updates"| crm
  mcp -->|"remote tool calls"| ext
  script -.->|"escalate"| human
  crm -.->|"outcomes"| obs
  classDef salesforce stroke:#125BD8,fill:#e8f0fd
  class flow,apex,crm salesforce
  classDef data stroke:#2f8a3a,fill:#e9f6ea
  class d360 data
  classDef ai stroke:#5747AF,fill:#f6f4fd
  class agent,script,atlas ai
  classDef integration stroke:#334155,fill:#eef2f6
  class mcp integration
  classDef security stroke:#1f2937,fill:#f3f4f6
  class trust,gateway,perms,obs security
  classDef channel stroke:#2f8a3a,fill:#ffffff
  class lightning,portal,slack,voice channel
  classDef external stroke:#64748b,fill:#ffffff
  class ext external
  classDef people stroke:#125BD8,fill:#ffffff
  class human people