Skip to main content

​
Engine Endpoints

​
Plan

POST https://api.probe.sh/v1/plan The Planner. Given a user’s intent, the engine decides which tools need to be executed to gather necessary information.

​
Request

​
query
string
required
The natural language query describing the bug or question. Example: “Why is the login button disabled?”

​
Response

​
steps
array
List of tools to execute.
{
  "query": "Why is the login button disabled?"
}

{
  "steps": [
    { "tool": "get_dom_element", "selector": "#login-btn" },
    { "tool": "check_local_storage", "key": "auth_token" }
  ]
}

​
Analyze

POST https://api.probe.sh/v1/analyze The Analyst. Given the results from the executed tools, the engine provides a human-readable explanation and fix suggestions.

​
Request

​
query
string
required
The original query.
​
tool_results
array
required
Array of results from the executed tools.

​
Response

​
explanation
string
Human-readable explanation of the issue.
​
suggestion
string
Actionable suggestion to fix the issue.
{
  "query": "Why is the login button disabled?",
  "tool_results": [
    { "tool": "get_dom_element", "result": { "disabled": true } }
  ]
}

{
  "explanation": "The button is disabled because it has the 'btn-disabled' class.",
  "suggestion": "Check if form validation logic is failing."
}