{"componentChunkName":"component---src-templates-markdown-template-jsx","path":"/guides/mparticle-agent/overview/","result":{"data":{"pageMetadata":{"title":"Overview","path":"/guides/mparticle-agent/overview/","sourceCode":null,"metadataParent":{"title":"mParticle Agent","path":"/guides/mparticle-agent/","sourceCode":null,"hasVersionPicker":null,"metadataChildren":[{"title":"Overview","path":"/guides/mparticle-agent/overview/","order":1,"label":null},{"title":"Explore Your Data","path":"/guides/mparticle-agent/explore-your-data/","order":2,"label":null},{"title":"Build Audiences","path":"/guides/mparticle-agent/build-audiences/","order":3,"label":null},{"title":"Create Predictions","path":"/guides/mparticle-agent/create-predictions/","order":4,"label":null},{"title":"Data and Privacy","path":"/guides/mparticle-agent/data-and-privacy/","order":5,"label":null},{"title":"mParticle Agent FAQ","path":"/guides/mparticle-agent/faq/","order":6,"label":null}],"metadataParent":{"title":"Guides","path":"/guides/","metadataChildren":[{"title":"Customer 360","path":"/guides/customer-360/","order":1,"label":null},{"title":"Getting Started","path":"/guides/getting-started/","order":1,"label":null},{"title":"Platform Guide","path":"/guides/platform-guide/","order":2,"label":null},{"title":"IDSync","path":"/guides/idsync/","order":4,"label":null},{"title":"Segmentation","path":"/guides/segmentation/","order":4,"label":null},{"title":"mParticle Agent","path":"/guides/mparticle-agent/","order":5,"label":null},{"title":"Analytics","path":"/guides/analytics/","order":7,"label":null},{"title":"Warehouse Sync","path":"/guides/data-warehouse-sync/","order":7,"label":null},{"title":"Data Privacy Controls","path":"/guides/data-privacy-controls/","order":8,"label":null},{"title":"Data Subject Requests","path":"/guides/data-subject-requests/","order":9,"label":null},{"title":"Default Service Limits","path":"/guides/default-service-limits/","order":10,"label":null},{"title":"Feeds","path":"/guides/feeds/","order":11,"label":null},{"title":"Import Data with CSV Files","path":"/guides/csv/","order":13,"label":null},{"title":"Glossary","path":"/guides/glossary/","order":14,"label":null},{"title":"Video Index","path":"/guides/video-index/","order":15,"label":null},{"title":"Analytics (Deprecated)","path":"/guides/analytics-deprecated/","order":16,"label":null},{"title":"Composable Audiences","path":"/guides/composable-audiences/","order":null,"label":null}],"metadataParent":null}}},"markdownRemark":{"html":"<p>The mParticle Agent helps you explore data in your workspace, build supported real-time audiences, and work with Predictions. It can recommend a prediction type for your business goal, create Future Behavior predictions, inspect and interpret supported existing predictions, and prepare supported audiences after you select an exact target range. Start with a question, problem, or business goal in plain language.</p>\n<p>When your request leads to an action (like building an audience), the agent prepares a proposed configuration for you to review and approve rather than executing the change itself. Throughout the conversation, it explains its findings and assumptions and asks for clarification when needed. You remain in control by reviewing the Agent’s proposed configuration and explicitly approving the change before it is applied.</p>\n<h2 id=\"what-you-can-do-with-the-mparticle-agent\" style=\"position:relative;\"><a href=\"#what-you-can-do-with-the-mparticle-agent\" aria-label=\"what you can do with the mparticle agent permalink\" class=\"anchor before\"><svg width=\"16px\" height=\"17px\" viewBox=\"0 0 16 17\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n                <g id=\"Symbols\" stroke=\"none\" stroke-width=\"1\" fill=\"none\" fill-rule=\"evenodd\">\n                    <g id=\"Icon/Link\" fill=\"#98A0A3\" fill-rule=\"nonzero\">\n                        <g id=\"link\">\n                            <path d=\"M9.5,12.4 C9.6,12.4 9.7,12.4 9.9,12.4 C9.8,12.5 9.8,12.5 9.7,12.6 L7.5,14.8 C5.8,16.5 3,16.5 1.3,14.8 C-0.4,13.1 -0.4,10.3 1.3,8.6 L3.5,6.4 C3.6,6.3 3.6,6.3 3.7,6.2 C5,5 6.9,4.8 8.4,5.5 C8.8,5.7 9.3,6 9.6,6.4 C10,6.7 10.2,7.2 10.5,7.6 C10.2,7.9 9.9,8 9.5,8 C9.4,8 9.2,8 9.1,7.9 C8.9,7.5 8.5,7.2 8.1,6.9 C7,6.2 5.5,6.4 4.5,7.3 L3.8,8 L2.3,9.5 C1.2,10.6 1.2,12.5 2.3,13.6 C3.4,14.7 5.3,14.7 6.4,13.6 L7.9,12.1 C8.4,12.3 8.9,12.4 9.5,12.4 Z M14.7,1.3 C13,-0.4 10.2,-0.4 8.5,1.3 L6.3,3.5 C6.2,3.6 6.2,3.6 6.1,3.7 C6.7,3.7 7.4,3.7 8,3.9 L9.5,2.4 C10.6,1.3 12.5,1.3 13.6,2.4 C14.7,3.5 14.7,5.4 13.6,6.5 L12.1,8 L11.4,8.7 C10.4,9.7 8.9,9.8 7.8,9.1 C7.4,8.9 7.1,8.5 6.8,8.1 C6.7,8.1 6.5,8 6.4,8 C6,8 5.6,8.2 5.4,8.4 C5.6,8.8 5.9,9.3 6.3,9.6 C6.6,10 7.1,10.2 7.5,10.5 C9,11.2 10.9,11 12.3,9.8 C12.4,9.7 12.4,9.7 12.5,9.6 L14.7,7.4 C16.4,5.7 16.4,3 14.7,1.3 Z\" id=\"Shape\"></path>\n                        </g>\n                    </g>\n                </g>\n            </svg></a>What you can do with the mParticle Agent</h2>\n<p>Use the mParticle Agent to:</p>\n<ul>\n<li><strong>Explore your data:</strong> Ask the Agent about configured data sources, events, user and calculated attributes, aggregate activity trends, counts, and coverage to identify opportunities, gaps, or unexpected changes.</li>\n<li><strong>Inspect audiences:</strong> Review saved audience information and whether eligible Audience Membership can support a new real-time audience.</li>\n<li><strong>Act on a business goal:</strong> Describe the outcome you want, and let the agent identify the data it needs to translate your goal into the criteria and settings required for a supported task.</li>\n<li><strong>Validate data for a task:</strong> Confirm that your workspace contains the data you need before asking the agent to create a specific configuration.</li>\n<li><strong>Work with predictions:</strong> Create a Future Behavior prediction, inspect and interpret supported existing predictions, and prepare an audience from an exact target range you select.</li>\n</ul>\n<h2 id=\"how-the-mparticle-agent-works\" style=\"position:relative;\"><a href=\"#how-the-mparticle-agent-works\" aria-label=\"how the mparticle agent works permalink\" class=\"anchor before\"><svg width=\"16px\" height=\"17px\" viewBox=\"0 0 16 17\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n                <g id=\"Symbols\" stroke=\"none\" stroke-width=\"1\" fill=\"none\" fill-rule=\"evenodd\">\n                    <g id=\"Icon/Link\" fill=\"#98A0A3\" fill-rule=\"nonzero\">\n                        <g id=\"link\">\n                            <path d=\"M9.5,12.4 C9.6,12.4 9.7,12.4 9.9,12.4 C9.8,12.5 9.8,12.5 9.7,12.6 L7.5,14.8 C5.8,16.5 3,16.5 1.3,14.8 C-0.4,13.1 -0.4,10.3 1.3,8.6 L3.5,6.4 C3.6,6.3 3.6,6.3 3.7,6.2 C5,5 6.9,4.8 8.4,5.5 C8.8,5.7 9.3,6 9.6,6.4 C10,6.7 10.2,7.2 10.5,7.6 C10.2,7.9 9.9,8 9.5,8 C9.4,8 9.2,8 9.1,7.9 C8.9,7.5 8.5,7.2 8.1,6.9 C7,6.2 5.5,6.4 4.5,7.3 L3.8,8 L2.3,9.5 C1.2,10.6 1.2,12.5 2.3,13.6 C3.4,14.7 5.3,14.7 6.4,13.6 L7.9,12.1 C8.4,12.3 8.9,12.4 9.5,12.4 Z M14.7,1.3 C13,-0.4 10.2,-0.4 8.5,1.3 L6.3,3.5 C6.2,3.6 6.2,3.6 6.1,3.7 C6.7,3.7 7.4,3.7 8,3.9 L9.5,2.4 C10.6,1.3 12.5,1.3 13.6,2.4 C14.7,3.5 14.7,5.4 13.6,6.5 L12.1,8 L11.4,8.7 C10.4,9.7 8.9,9.8 7.8,9.1 C7.4,8.9 7.1,8.5 6.8,8.1 C6.7,8.1 6.5,8 6.4,8 C6,8 5.6,8.2 5.4,8.4 C5.6,8.8 5.9,9.3 6.3,9.6 C6.6,10 7.1,10.2 7.5,10.5 C9,11.2 10.9,11 12.3,9.8 C12.4,9.7 12.4,9.7 12.5,9.6 L14.7,7.4 C16.4,5.7 16.4,3 14.7,1.3 Z\" id=\"Shape\"></path>\n                        </g>\n                    </g>\n                </g>\n            </svg></a>How the mParticle Agent works</h2>\n<p>When you submit a request, the mParticle Agent interprets your intent and uses the available context in your workspace, including Data Catalog metadata, aggregate metrics, and permission-gated data. It identifies relevant information, explains its findings, and asks for clarification when it needs more detail.</p>\n<p>For supported tasks that involve a change, the agent translates your request into technical criteria and settings and prepares a configuration for your review. You can refine the configuration through the conversation before approving it. The agent does not apply the change until you explicitly confirm it.</p>\n<h2 id=\"agent-boundaries\" style=\"position:relative;\"><a href=\"#agent-boundaries\" aria-label=\"agent boundaries permalink\" class=\"anchor before\"><svg width=\"16px\" height=\"17px\" viewBox=\"0 0 16 17\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n                <g id=\"Symbols\" stroke=\"none\" stroke-width=\"1\" fill=\"none\" fill-rule=\"evenodd\">\n                    <g id=\"Icon/Link\" fill=\"#98A0A3\" fill-rule=\"nonzero\">\n                        <g id=\"link\">\n                            <path d=\"M9.5,12.4 C9.6,12.4 9.7,12.4 9.9,12.4 C9.8,12.5 9.8,12.5 9.7,12.6 L7.5,14.8 C5.8,16.5 3,16.5 1.3,14.8 C-0.4,13.1 -0.4,10.3 1.3,8.6 L3.5,6.4 C3.6,6.3 3.6,6.3 3.7,6.2 C5,5 6.9,4.8 8.4,5.5 C8.8,5.7 9.3,6 9.6,6.4 C10,6.7 10.2,7.2 10.5,7.6 C10.2,7.9 9.9,8 9.5,8 C9.4,8 9.2,8 9.1,7.9 C8.9,7.5 8.5,7.2 8.1,6.9 C7,6.2 5.5,6.4 4.5,7.3 L3.8,8 L2.3,9.5 C1.2,10.6 1.2,12.5 2.3,13.6 C3.4,14.7 5.3,14.7 6.4,13.6 L7.9,12.1 C8.4,12.3 8.9,12.4 9.5,12.4 Z M14.7,1.3 C13,-0.4 10.2,-0.4 8.5,1.3 L6.3,3.5 C6.2,3.6 6.2,3.6 6.1,3.7 C6.7,3.7 7.4,3.7 8,3.9 L9.5,2.4 C10.6,1.3 12.5,1.3 13.6,2.4 C14.7,3.5 14.7,5.4 13.6,6.5 L12.1,8 L11.4,8.7 C10.4,9.7 8.9,9.8 7.8,9.1 C7.4,8.9 7.1,8.5 6.8,8.1 C6.7,8.1 6.5,8 6.4,8 C6,8 5.6,8.2 5.4,8.4 C5.6,8.8 5.9,9.3 6.3,9.6 C6.6,10 7.1,10.2 7.5,10.5 C9,11.2 10.9,11 12.3,9.8 C12.4,9.7 12.4,9.7 12.5,9.6 L14.7,7.4 C16.4,5.7 16.4,3 14.7,1.3 Z\" id=\"Shape\"></path>\n                        </g>\n                    </g>\n                </g>\n            </svg></a>Agent boundaries</h2>\n<p>The mParticle Agent can summarize workspace data, prepare and create one top-level real-time audience per creation flow, recommend Future Behavior, Similar Customers, or Best Offering for a business goal, and create Future Behavior predictions. It can inspect and interpret supported existing predictions. After you select an exact target range, it can build one individual audience from a Future Behavior or Similar Customers prediction. An audience can combine eligible existing Composable Audience membership with live behavioral criteria.</p>\n<p>You complete these steps in the standard product workflow:</p>\n<ul>\n<li>Select the exact target range for a prediction. The Agent does not recommend, choose, optimize, or change it. Best Offering does not support the same single-audience handoff.</li>\n<li>Create Similar Customers and Best Offering predictions and any Composable Audience or Audience Group you need.</li>\n<li>Activate audiences and connect them to outputs.</li>\n</ul>\n<p>The Agent does not edit or delete saved resources or change workspace configuration. It asks for clarification when it cannot identify the information needed for a task and requires your explicit approval before creating an audience or Future Behavior prediction. See <a href=\"/guides/mparticle-agent/build-audiences/\">Build Audiences</a> and <a href=\"/guides/mparticle-agent/create-predictions/\">Create Predictions</a> for feature-specific steps and limits.</p>\n<h2 id=\"security-and-privacy-at-a-glance\" style=\"position:relative;\"><a href=\"#security-and-privacy-at-a-glance\" aria-label=\"security and privacy at a glance permalink\" class=\"anchor before\"><svg width=\"16px\" height=\"17px\" viewBox=\"0 0 16 17\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n                <g id=\"Symbols\" stroke=\"none\" stroke-width=\"1\" fill=\"none\" fill-rule=\"evenodd\">\n                    <g id=\"Icon/Link\" fill=\"#98A0A3\" fill-rule=\"nonzero\">\n                        <g id=\"link\">\n                            <path d=\"M9.5,12.4 C9.6,12.4 9.7,12.4 9.9,12.4 C9.8,12.5 9.8,12.5 9.7,12.6 L7.5,14.8 C5.8,16.5 3,16.5 1.3,14.8 C-0.4,13.1 -0.4,10.3 1.3,8.6 L3.5,6.4 C3.6,6.3 3.6,6.3 3.7,6.2 C5,5 6.9,4.8 8.4,5.5 C8.8,5.7 9.3,6 9.6,6.4 C10,6.7 10.2,7.2 10.5,7.6 C10.2,7.9 9.9,8 9.5,8 C9.4,8 9.2,8 9.1,7.9 C8.9,7.5 8.5,7.2 8.1,6.9 C7,6.2 5.5,6.4 4.5,7.3 L3.8,8 L2.3,9.5 C1.2,10.6 1.2,12.5 2.3,13.6 C3.4,14.7 5.3,14.7 6.4,13.6 L7.9,12.1 C8.4,12.3 8.9,12.4 9.5,12.4 Z M14.7,1.3 C13,-0.4 10.2,-0.4 8.5,1.3 L6.3,3.5 C6.2,3.6 6.2,3.6 6.1,3.7 C6.7,3.7 7.4,3.7 8,3.9 L9.5,2.4 C10.6,1.3 12.5,1.3 13.6,2.4 C14.7,3.5 14.7,5.4 13.6,6.5 L12.1,8 L11.4,8.7 C10.4,9.7 8.9,9.8 7.8,9.1 C7.4,8.9 7.1,8.5 6.8,8.1 C6.7,8.1 6.5,8 6.4,8 C6,8 5.6,8.2 5.4,8.4 C5.6,8.8 5.9,9.3 6.3,9.6 C6.6,10 7.1,10.2 7.5,10.5 C9,11.2 10.9,11 12.3,9.8 C12.4,9.7 12.4,9.7 12.5,9.6 L14.7,7.4 C16.4,5.7 16.4,3 14.7,1.3 Z\" id=\"Shape\"></path>\n                        </g>\n                    </g>\n                </g>\n            </svg></a>Security and privacy at a glance</h2>\n<p>The mParticle Agent runs under your authenticated mParticle session and follows your existing mParticle permissions. It can access only the workspaces, environments, and data that your user account can already access.</p>\n<p>The agent uses OpenAI to interpret your requests and generate responses; your prompt and the relevant workspace context are encrypted when sent to OpenAI and are processed under mParticle’s enterprise agreement with OpenAI. Your prompts and data are not used to train OpenAI’s models. mParticle does not use one customer’s conversations, workspace data, business context, or configurations to generate recommendations for other mParticle customers.</p>\n<p>The agent is not designed to expose personally identifiable information (PII) in your conversations. It won’t list stored email addresses, phone numbers, or raw identifiers, and it doesn’t support the export of PII. For more information about what the agent can and can’t access, how your data is secured, and where your data is processed, see <a href=\"/guides/mparticle-agent/data-and-privacy/\">Data and Privacy</a>.</p>\n<h2 id=\"next-steps\" style=\"position:relative;\"><a href=\"#next-steps\" aria-label=\"next steps permalink\" class=\"anchor before\"><svg width=\"16px\" height=\"17px\" viewBox=\"0 0 16 17\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\">\n                <g id=\"Symbols\" stroke=\"none\" stroke-width=\"1\" fill=\"none\" fill-rule=\"evenodd\">\n                    <g id=\"Icon/Link\" fill=\"#98A0A3\" fill-rule=\"nonzero\">\n                        <g id=\"link\">\n                            <path d=\"M9.5,12.4 C9.6,12.4 9.7,12.4 9.9,12.4 C9.8,12.5 9.8,12.5 9.7,12.6 L7.5,14.8 C5.8,16.5 3,16.5 1.3,14.8 C-0.4,13.1 -0.4,10.3 1.3,8.6 L3.5,6.4 C3.6,6.3 3.6,6.3 3.7,6.2 C5,5 6.9,4.8 8.4,5.5 C8.8,5.7 9.3,6 9.6,6.4 C10,6.7 10.2,7.2 10.5,7.6 C10.2,7.9 9.9,8 9.5,8 C9.4,8 9.2,8 9.1,7.9 C8.9,7.5 8.5,7.2 8.1,6.9 C7,6.2 5.5,6.4 4.5,7.3 L3.8,8 L2.3,9.5 C1.2,10.6 1.2,12.5 2.3,13.6 C3.4,14.7 5.3,14.7 6.4,13.6 L7.9,12.1 C8.4,12.3 8.9,12.4 9.5,12.4 Z M14.7,1.3 C13,-0.4 10.2,-0.4 8.5,1.3 L6.3,3.5 C6.2,3.6 6.2,3.6 6.1,3.7 C6.7,3.7 7.4,3.7 8,3.9 L9.5,2.4 C10.6,1.3 12.5,1.3 13.6,2.4 C14.7,3.5 14.7,5.4 13.6,6.5 L12.1,8 L11.4,8.7 C10.4,9.7 8.9,9.8 7.8,9.1 C7.4,8.9 7.1,8.5 6.8,8.1 C6.7,8.1 6.5,8 6.4,8 C6,8 5.6,8.2 5.4,8.4 C5.6,8.8 5.9,9.3 6.3,9.6 C6.6,10 7.1,10.2 7.5,10.5 C9,11.2 10.9,11 12.3,9.8 C12.4,9.7 12.4,9.7 12.5,9.6 L14.7,7.4 C16.4,5.7 16.4,3 14.7,1.3 Z\" id=\"Shape\"></path>\n                        </g>\n                    </g>\n                </g>\n            </svg></a>Next steps</h2>\n<ul>\n<li><strong><a href=\"/guides/mparticle-agent/explore-your-data/\">Explore Your Data</a>:</strong> Use the agent to find available events, attributes, or recent activity for audiences and predictions</li>\n<li><strong><a href=\"/guides/mparticle-agent/build-audiences/\">Build Audiences</a>:</strong> Use the agent to create a new real-time audience</li>\n<li><strong><a href=\"/guides/mparticle-agent/create-predictions/\">Create Predictions</a>:</strong> Create a Future Behavior prediction, interpret supported predictions, and use an exact target range in an audience</li>\n<li><strong><a href=\"/guides/mparticle-agent/data-and-privacy/\">Data and Privacy</a>:</strong> Learn about data access, permissions, or personal-data handling</li>\n<li><strong><a href=\"/guides/mparticle-agent/faq/\">FAQ</a>:</strong> Find answers to other common questions about supported tasks</li>\n</ul>","frontmatter":{"title":"Overview","order":1,"seoTitle":null,"seoDescription":null},"parent":{"__typename":"File","modifiedTime":"September 25, 2026"}}},"pageContext":{"slug":"/guides/mparticle-agent/overview/"}},"staticQueryHashes":["2950460867"]}