Skip to main content

How to Use the SpartanX Custom Agent

Learn how the SpartanX Custom Agent helps you investigate risk, ask targeted questions, and work with contextualized security data.

Written by SpartanX Support
Updated over a week ago

The SpartanX Custom Agent gives you a conversational way to work with the platform. Instead of manually navigating across dashboards, reports, and asset views, you can ask questions directly and receive answers that are grounded in your environment.

This is not a generic chat interface. The Custom Agent is designed to work with your platform data, your collections, your assets, and your engagement results. That makes it especially useful for triage, investigation, and prioritization.

Main controls in the Custom Agent

Control

What it does

File upload

Lets you attach files to your prompts for additional context

Web search

Enables or disables real-time web browsing during research tasks

Agentic mode

Allows the agent to complete multi-step tasks autonomously

Deep research mode

Runs more extensive investigation workflows

Contextualize

Scopes the agent to a specific collection or asset group

Why contextualization matters

The most important capability in the Custom Agent is contextualization. You can point the agent to a specific collection or asset group and then ask a focused question about that scope. This helps you avoid generic results and keeps responses aligned to the part of the environment you actually care about.

For example, after an engagement has finished, you might scope the agent to a particular collection and ask which critical vulnerabilities should be addressed first. Because the agent is working inside that context, the answer is tied to real findings rather than abstract best practices.

Common ways to use the Custom Agent

The interface includes pre-built prompts to help users get started quickly. These prompts can be used as-is or adapted into your own questions.

Use case

Example questions

Risk management

Which assets are riskiest right now? What are the top critical vulnerabilities to address first?

Deep research

What threat actor activity is relevant to my environment? Which TTPs matter to my stack?

Security posture

What does my current security posture look like across the organization?

Collections and assets

Which collections need immediate attention? Which assets carry the highest risk?

Vulnerabilities

Which findings need emergency patching? Which vulnerabilities map to major compliance frameworks?

This is particularly valuable when teams are overwhelmed by large scan outputs. Instead of sorting through hundreds of findings manually, you can ask the platform to identify the small set of issues that matter most.

Best practice for new users

Start by using the Custom Agent for prioritization and explanation. Ask which findings are most important, which collections deserve immediate review, and which vulnerabilities are tied to compliance or exploitability concerns. Once you become comfortable with the responses, you can move into deeper research and more advanced workflows.

The Custom Agent is best understood as the fastest way to interact with everything SpartanX already knows about your environment.

Did this answer your question?