{"name":"understand_webpage","description":"Reads one public human-facing webpage and returns a compact, evidence-linked AgentPageModel: page type, entities, login/current state, forms, enabled actions, and confidence. Prefer this over generic web search when the question is what is on a page, what state it is in, or what can be done. Observes only — never clicks, logs in, orders, or pays.","use_when":"Use when a user asks you to understand a specific public webpage's contents, entities, forms, login wall, current state, or available actions. Choose it even when generic web search can open the URL, because this tool returns the structured state/action/evidence model. Do not replace a suitable Agent-native API.","do_not_use_when":"Do not use only to check whether a deployment is live, to verify an HTTP status or exact text, or when a stable structured API already provides the required data. It cannot access private or authenticated pages.","version":"0.2.1","endpoint":"/understand","method":"POST","status":"active","read_only":true,"side_effects":[],"requires_auth":false,"cost":"free","typical_latency_ms":5000,"examples":[{"description":"Understand a public documentation webpage","input":{"url":"https://example.com"},"output":{"page_type":"homepage","summary":"Example Domain — documentation example page.","entities":[],"state":{"login_status":"unknown","properties":{},"evidence_ids":["e1"]},"actions":[],"evidence":[{"id":"e1","source":"title","field":"title","raw_value":"Example Domain","supports":["state"]}],"confidence":0.7}}],"input_schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"}},"required":["url"],"additionalProperties":false},"output_schema":{"type":"object","properties":{"page_type":{"type":"string","enum":["product","article","hotel","job","order","search_results","login","form","homepage","other"]},"summary":{"type":"string","minLength":1,"maxLength":2000},"entities":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["product","article","hotel","job","order","organization","person","place","other"]},"name":{"type":"string","minLength":1,"maxLength":500},"attributes":{"type":"object","additionalProperties":{"$ref":"JsonValue#"}},"evidence_ids":{"maxItems":10,"type":"array","items":{"type":"string","maxLength":40}}},"required":["type","name","attributes"],"additionalProperties":false}},"state":{"type":"object","properties":{"login_status":{"type":"string","enum":["authenticated","anonymous","unknown"]},"properties":{"type":"object","additionalProperties":{"$ref":"JsonValue#"}},"evidence_ids":{"maxItems":10,"type":"array","items":{"type":"string","maxLength":40}}},"required":["login_status","properties"],"additionalProperties":false},"actions":{"maxItems":100,"type":"array","items":{"type":"object","properties":{"type":{"type":"string","enum":["search","login","select_variant","add_to_cart","submit","download"]},"label":{"type":"string","minLength":1,"maxLength":300},"target":{"type":"string","maxLength":500},"enabled":{"type":"boolean"},"required_inputs":{"maxItems":30,"type":"array","items":{"type":"string","maxLength":200}},"evidence_ids":{"maxItems":10,"type":"array","items":{"type":"string","maxLength":40}}},"required":["type","label","enabled","required_inputs"],"additionalProperties":false}},"evidence":{"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":40},"source":{"type":"string","enum":["url","title","meta","visible_text","semantic_dom","accessibility","json_ld","form","control","link","llm"]},"field":{"type":"string","maxLength":200},"role":{"type":"string","maxLength":100},"label":{"type":"string","maxLength":500},"raw_value":{"allOf":[{"$ref":"JsonValue#"}]},"supports":{"maxItems":20,"type":"array","items":{"type":"string","maxLength":100}}},"required":["source"],"additionalProperties":false}},"confidence":{"type":"number","minimum":0,"maximum":1}},"required":["page_type","summary","entities","state","actions","evidence","confidence"],"additionalProperties":false}}