Scoring Profiles

Scoring profiles control how VeriSwarm Gate weighs evidence when computing agent trust scores. Every workspace uses a profile -- the default is general, but you can switch to a preset that matches your use case or apply custom weight overrides.

How Profiles Work

Gate scores agents across four dimensions: Identity, Risk, Reliability, and Autonomy. Each dimension is computed from weighted input signals. A scoring profile defines:

Dimension weights -- How much each input signal contributes to its dimension score.
Composite weights -- How the four dimensions combine into the overall composite trust score.
Tier thresholds -- The score boundaries that determine which policy tier an agent is assigned to.
Risk bands -- The numeric ranges that map risk scores to low, moderate, high, and severe labels.

When you change your workspace's scoring profile, all future score computations use the new weights. Existing scores are not retroactively recalculated.

Preset Profiles

Five presets are available out of the box:

`general` (Default)

Balanced evaluation across all dimensions. Suitable for most platforms.

`high_security`

For platforms where credential integrity and exploit resistance are paramount -- financial services, infrastructure management, security tooling. Stricter risk thresholds and heavier weighting on key attestation and secret hygiene.

`social_platform`

Optimized for communities, social apps, and content platforms. Prioritizes coordinated abuse detection, deception flags, and community endorsement signals.

`developer_tools`

For developer platforms, CI/CD integrations, and code-adjacent tooling. Emphasizes task success rate, evidence integrity, and tool trace consistency.

`marketplace`

For agent marketplaces, app stores, and platform ecosystems. Prioritizes verified identity, declaration completeness, and community reputation.

Viewing Your Current Profile

Via the Dashboard

Navigate to Account > Settings and look for the Scoring Profile section.

Via the API

curl https://api.veriswarm.ai/v1/suite/scoring/profile \
  -H "x-account-access-token: YOUR_SESSION_TOKEN"

The response includes the active profile code, resolved weights for all dimensions, tier thresholds, risk bands, and the list of available presets.

Setting a Profile

Requires admin or owner role. Changing the profile takes effect on the next score computation for each agent.

Switch to a Preset

curl -X POST https://api.veriswarm.ai/v1/suite/scoring/profile \
  -H "x-account-access-token: YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_code": "high_security"
  }'

Apply Custom Weight Overrides

You can start from any preset and selectively override specific weights. Overrides are merged with the base preset -- you only need to specify the weights you want to change.

curl -X POST https://api.veriswarm.ai/v1/suite/scoring/profile \
  -H "x-account-access-token: YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "profile_code": "general",
    "weight_overrides": {
      "risk": {
        "policy_violation_rate": 0.30,
        "exploit_susceptibility": 0.25,
        "coordination_anomaly": 0.15,
        "secret_hygiene_failures": 0.15,
        "rate_abuse": 0.10,
        "deception_flags": 0.05
      }
    }
  }'

Overrides are organized by dimension (identity, risk, reliability, autonomy, composite). All keys are optional. Weights within each category must sum to 1.0.

Tips

Start with a preset. The five presets cover the most common platform types. Only add overrides if you have a specific tuning need.
Test before committing. Use the GET endpoint to inspect the resolved profile after setting overrides.
Overrides persist. If you switch presets, any weight_overrides are applied on top of the new base preset. Set weight_overrides to null to clear them.