Skip to main content
POST
Resolve Config
Use this API to resolve optimal extraction strategies and execution strategy for an agent based on its instructions. The engine analyzes the (optional rawInstructions plus the processed instructions) and returns:
  • A recommended set of contextGathering.strategies
  • A recommended executionStrategy (ai, service, service+ai, or stagehand-agent)
  • Per-strategy options where a recommended strategy needs them
  • Reasoning for each recommendation
Use this as a starting point when creating a new agent; the response can be passed straight into Create Agent under the contextGathering and execution blocks.

Endpoint

POST https://api.velt.dev/v2/agents/config/resolve

Headers

string
required
Your API key.
string
required

Body

Params

object
required

Example Requests

1. Resolve a static analysis agent

2. Resolve an interactive agent

Response

Success Response

Carry strategy_options across to Create Agent along with extraction_strategies. Some strategies are inert without it: computed-styles requires a selectors list, and dropping the resolver’s options silently produces an agent that gathers nothing for that strategy.
Mapping the response onto Create Agent:

Failure Response

Errors: INVALID_ARGUMENT (missing or empty instructions).
The resolver never surfaces an AI failure as an error. If the model call fails for any reason, the endpoint still returns 200 with "status": "success" and a hardcoded fallback recommendation: extraction_strategies of ["web-page-text", "web-page-html", "web-page-screenshot"], execution_strategy of "ai", and reasoning of "Default configuration applied". Check for that exact reasoning string before treating a response as tailored to your instructions.