[{"data":1,"prerenderedAt":434},["ShallowReactive",2],{"copilot-navigation":3,"mdc-o8y00b-key":152,"copilot-version":194,"\u002Fdocs\u002Fcopilot\u002Fagents\u002Ftools":197,"\u002Fdocs\u002Fcopilot\u002Fagents\u002Ftools-surround":429},[4,15,33,54,79,116,133],{"title":5,"path":6,"stem":7,"children":8},"Getting Started","\u002Fdocs\u002Fcopilot\u002Fgetting-started","1.docs\u002F1.copilot\u002F1.getting-started\u002F1.index",[9,11],{"title":10,"path":6,"stem":7},"Introduction",{"title":12,"path":13,"stem":14},"Installation","\u002Fdocs\u002Fcopilot\u002Fgetting-started\u002Finstallation","1.docs\u002F1.copilot\u002F1.getting-started\u002F2.installation",{"title":16,"path":17,"stem":18,"children":19,"page":32},"Configuration","\u002Fdocs\u002Fcopilot\u002Fconfiguration","1.docs\u002F1.copilot\u002F2.configuration",[20,24,28],{"title":21,"path":22,"stem":23},"Global Configuration","\u002Fdocs\u002Fcopilot\u002Fconfiguration\u002Fglobal","1.docs\u002F1.copilot\u002F2.configuration\u002F1.global",{"title":25,"path":26,"stem":27},"View Button & Field Configuration","\u002Fdocs\u002Fcopilot\u002Fconfiguration\u002Flocal","1.docs\u002F1.copilot\u002F2.configuration\u002F2.local",{"title":29,"path":30,"stem":31},"System Prompt","\u002Fdocs\u002Fcopilot\u002Fconfiguration\u002Fsystem-prompt","1.docs\u002F1.copilot\u002F2.configuration\u002F3.system-prompt",false,{"title":34,"path":35,"stem":36,"children":37,"page":32},"Usage","\u002Fdocs\u002Fcopilot\u002Fusage","1.docs\u002F1.copilot\u002F3.usage",[38,42,46,50],{"title":39,"path":40,"stem":41},"View Button","\u002Fdocs\u002Fcopilot\u002Fusage\u002Fview-button","1.docs\u002F1.copilot\u002F3.usage\u002F1.view-button",{"title":43,"path":44,"stem":45},"Toolbar Buttons","\u002Fdocs\u002Fcopilot\u002Fusage\u002Ftoolbar-buttons","1.docs\u002F1.copilot\u002F3.usage\u002F2.toolbar-buttons",{"title":47,"path":48,"stem":49},"Inline Suggestions","\u002Fdocs\u002Fcopilot\u002Fusage\u002Finline-suggestions","1.docs\u002F1.copilot\u002F3.usage\u002F3.inline-suggestions",{"title":51,"path":52,"stem":53},"Copilot Section","\u002Fdocs\u002Fcopilot\u002Fusage\u002Fsection","1.docs\u002F1.copilot\u002F3.usage\u002F4.section",{"title":55,"path":56,"stem":57,"children":58,"page":32},"Prompt Dialog","\u002Fdocs\u002Fcopilot\u002Fprompt-dialog","1.docs\u002F1.copilot\u002F4.prompt-dialog",[59,63,67,71,75],{"title":60,"path":61,"stem":62},"Field Placeholders","\u002Fdocs\u002Fcopilot\u002Fprompt-dialog\u002Fplaceholders","1.docs\u002F1.copilot\u002F4.prompt-dialog\u002F1.placeholders",{"title":64,"path":65,"stem":66},"Prompt Templates","\u002Fdocs\u002Fcopilot\u002Fprompt-dialog\u002Ftemplates","1.docs\u002F1.copilot\u002F4.prompt-dialog\u002F2.templates",{"title":68,"path":69,"stem":70},"File Attachments","\u002Fdocs\u002Fcopilot\u002Fprompt-dialog\u002Ffiles","1.docs\u002F1.copilot\u002F4.prompt-dialog\u002F3.files",{"title":72,"path":73,"stem":74},"Page References","\u002Fdocs\u002Fcopilot\u002Fprompt-dialog\u002Fpage-references","1.docs\u002F1.copilot\u002F4.prompt-dialog\u002F4.page-references",{"title":76,"path":77,"stem":78},"Skills","\u002Fdocs\u002Fcopilot\u002Fprompt-dialog\u002Fskills","1.docs\u002F1.copilot\u002F4.prompt-dialog\u002F5.skills",{"title":80,"path":81,"stem":82,"children":83},"PHP Classes","\u002Fdocs\u002Fcopilot\u002Fphp-classes","1.docs\u002F1.copilot\u002F5.php-classes\u002F1.index",[84,86,90,112],{"title":85,"path":81,"stem":82},"Overview",{"title":87,"path":88,"stem":89},"Client","\u002Fdocs\u002Fcopilot\u002Fphp-classes\u002Fclient","1.docs\u002F1.copilot\u002F5.php-classes\u002F2.client",{"title":91,"path":92,"stem":93,"children":94,"defaultOpen":32},"Providers","\u002Fdocs\u002Fcopilot\u002Fphp-classes\u002Fproviders","1.docs\u002F1.copilot\u002F5.php-classes\u002F3.providers\u002F1.index",[95,96,100,104,108],{"title":85,"path":92,"stem":93},{"title":97,"path":98,"stem":99},"OpenAIProvider","\u002Fdocs\u002Fcopilot\u002Fphp-classes\u002Fproviders\u002Fopenai","1.docs\u002F1.copilot\u002F5.php-classes\u002F3.providers\u002F2.openai",{"title":101,"path":102,"stem":103},"AnthropicProvider","\u002Fdocs\u002Fcopilot\u002Fphp-classes\u002Fproviders\u002Fanthropic","1.docs\u002F1.copilot\u002F5.php-classes\u002F3.providers\u002F3.anthropic",{"title":105,"path":106,"stem":107},"GeminiProvider","\u002Fdocs\u002Fcopilot\u002Fphp-classes\u002Fproviders\u002Fgemini","1.docs\u002F1.copilot\u002F5.php-classes\u002F3.providers\u002F4.gemini",{"title":109,"path":110,"stem":111},"MistralProvider","\u002Fdocs\u002Fcopilot\u002Fphp-classes\u002Fproviders\u002Fmistral","1.docs\u002F1.copilot\u002F5.php-classes\u002F3.providers\u002F5.mistral",{"title":113,"path":114,"stem":115},"Exceptions","\u002Fdocs\u002Fcopilot\u002Fphp-classes\u002Fexceptions","1.docs\u002F1.copilot\u002F5.php-classes\u002F4.exceptions",{"title":117,"path":118,"stem":119,"children":120,"page":32},"Advanced","\u002Fdocs\u002Fcopilot\u002Fadvanced","1.docs\u002F1.copilot\u002F6.advanced",[121,125,129],{"title":122,"path":123,"stem":124},"Blocks & Layouts","\u002Fdocs\u002Fcopilot\u002Fadvanced\u002Fblocks-and-layouts","1.docs\u002F1.copilot\u002F6.advanced\u002F1.blocks-and-layouts",{"title":126,"path":127,"stem":128},"Quick Reference","\u002Fdocs\u002Fcopilot\u002Fadvanced\u002Freference","1.docs\u002F1.copilot\u002F6.advanced\u002F2.reference",{"title":130,"path":131,"stem":132},"Troubleshooting","\u002Fdocs\u002Fcopilot\u002Fadvanced\u002Ftroubleshooting","1.docs\u002F1.copilot\u002F6.advanced\u002F3.troubleshooting",{"title":134,"path":135,"stem":136,"children":137},"Agents","\u002Fdocs\u002Fcopilot\u002Fagents","1.docs\u002F1.copilot\u002F7.agents\u002F1.index",[138,140,144,148],{"title":139,"path":135,"stem":136},"Connect an Agent",{"title":141,"path":142,"stem":143},"Permissions & Review","\u002Fdocs\u002Fcopilot\u002Fagents\u002Fpermissions-and-review","1.docs\u002F1.copilot\u002F7.agents\u002F2.permissions-and-review",{"title":145,"path":146,"stem":147},"Tools","\u002Fdocs\u002Fcopilot\u002Fagents\u002Ftools","1.docs\u002F1.copilot\u002F7.agents\u002F3.tools",{"title":149,"path":150,"stem":151},"Hosting & Troubleshooting","\u002Fdocs\u002Fcopilot\u002Fagents\u002Fhosting","1.docs\u002F1.copilot\u002F7.agents\u002F4.hosting",{"data":153,"body":154},{},{"type":155,"children":156},"root",[157],{"type":158,"tag":159,"props":160,"children":161},"element","p",{},[162,165,174,176,183,185,192],{"type":163,"value":164},"text","Kirby Tools is built on ",{"type":158,"tag":166,"props":167,"children":171},"a",{"href":168,"rel":169},"https:\u002F\u002Fgetkirby.com",[170],"nofollow",[172],{"type":163,"value":173},"Kirby",{"type":163,"value":175}," – with gratitude to the team and community who make it. Help me improve the plugins: share feedback in ",{"type":158,"tag":166,"props":177,"children":180},{"href":178,"rel":179},"https:\u002F\u002Fgithub.com\u002Fkirby-tools\u002Fcommunity\u002Fdiscussions",[170],[181],{"type":163,"value":182},"Discussions",{"type":163,"value":184}," or report bugs via ",{"type":158,"tag":166,"props":186,"children":189},{"href":187,"rel":188},"https:\u002F\u002Fgithub.com\u002Fkirby-tools\u002Fcommunity\u002Fissues",[170],[190],{"type":163,"value":191},"Issues",{"type":163,"value":193},".",{"title":195,"date":196},"v3.14.0","2026-10-10",{"id":198,"title":145,"body":199,"description":423,"extension":424,"meta":425,"navigation":426,"path":146,"seo":427,"stem":147,"__hash__":428},"docs\u002F1.docs\u002F1.copilot\u002F7.agents\u002F3.tools.md",{"type":200,"value":201,"toc":418},"minimark",[202,205,401,406],[159,203,204],{},"An agent sees only the tools its connection's permissions allow.",[206,207,208,224],"table",{},[209,210,211],"thead",{},[212,213,214,218,221],"tr",{},[215,216,217],"th",{},"Tool",[215,219,220],{},"Permission",[215,222,223],{},"What it does",[225,226,227,242,254,266,278,291,303,316,328,340,352,364,376,389],"tbody",{},[212,228,229,236,239],{},[230,231,232],"td",{},[233,234,235],"code",{},"get_site",[230,237,238],{},"Read content",[230,240,241],{},"Returns the site's title and URL, its languages, the account the agent works as, the connection's permissions, and the top-level pages",[212,243,244,249,251],{},[230,245,246],{},[233,247,248],{},"find_pages",[230,250,238],{},[230,252,253],{},"Searches the pages and drafts, or lists the children and drafts of one page – sorted by a field or the last change, filtered by unsaved changes, with the field values you ask for",[212,255,256,261,263],{},[230,257,258],{},[233,259,260],{},"get_content",[230,262,238],{},[230,264,265],{},"Returns the fields of a page, a file, or the site in one language, and the files of a page or the site; for unsaved changes, who else made them and which fields they change",[212,267,268,273,275],{},[230,269,270],{},[233,271,272],{},"view_image",[230,274,238],{},[230,276,277],{},"Returns a JPEG, PNG, GIF, or WebP image with its alt text",[212,279,280,285,288],{},[230,281,282],{},[233,283,284],{},"prepare_changes",[230,286,287],{},"Prepare changes",[230,289,290],{},"Writes field values to the unsaved changes in one language",[212,292,293,298,300],{},[230,294,295],{},[233,296,297],{},"create_draft",[230,299,287],{},[230,301,302],{},"Creates a draft below the site or a page, with a template the parent allows, in the default language",[212,304,305,310,313],{},[230,306,307],{},[233,308,309],{},"publish_changes",[230,311,312],{},"Publish changes",[230,314,315],{},"Publishes the unsaved changes in one language, whoever made them, unless they have validation errors – a draft's changes publish anyway",[212,317,318,323,325],{},[230,319,320],{},[233,321,322],{},"discard_changes",[230,324,312],{},[230,326,327],{},"Discards the unsaved changes in one language, whoever made them",[212,329,330,335,337],{},[230,331,332],{},[233,333,334],{},"change_status",[230,336,312],{},[230,338,339],{},"Changes a page's status to listed, unlisted, or draft – a draft with validation errors or unsaved changes stays a draft",[212,341,342,347,349],{},[230,343,344],{},[233,345,346],{},"change_slug",[230,348,312],{},[230,350,351],{},"Changes a page's slug in one language",[212,353,354,359,361],{},[230,355,356],{},[233,357,358],{},"move_page",[230,360,312],{},[230,362,363],{},"Moves a page or a draft with its subpages and files below another parent that takes its template",[212,365,366,371,373],{},[230,367,368],{},[233,369,370],{},"upload_file",[230,372,312],{},[230,374,375],{},"Uploads a file from a public HTTPS URL or sent by the agent to the site or a page, with a file template the parent accepts",[212,377,378,383,386],{},[230,379,380],{},[233,381,382],{},"delete_page",[230,384,385],{},"Delete content",[230,387,388],{},"Deletes a page or a draft with its files, unless it or its files have unsaved changes, or it has subpages",[212,390,391,396,398],{},[230,392,393],{},[233,394,395],{},"delete_file",[230,397,385],{},[230,399,400],{},"Deletes a file with its content, unless it has unsaved changes",[402,403,405],"h2",{"id":404},"what-agents-are-told","What Agents Are Told",[159,407,408,409,411,412,414,415,417],{},"When an agent connects, the site tells it to read content before it changes it. ",[233,410,260],{}," and ",[233,413,248],{}," tell it to treat the content they return as data, never as instructions. ",[233,416,235],{}," tells it that tools beyond its connection's permissions are hidden and that you can allow more in the Agents view, as far as your role permits. The tools that publish, discard, or delete tell it to call them only when you ask, and so do the tools that change a page's status, slug, or parent.",{"title":419,"searchDepth":420,"depth":420,"links":421},"",2,[422],{"id":404,"depth":420,"text":405},"The tools an agent calls on the site, the permission each one needs, and what the site tells an agent when it connects.","md",{},true,{"title":145,"description":423},"_g9don8JBAaFhWN1l9t6_QiijoOvmYvhg9tOAHrGx20",[430,432],{"title":141,"path":142,"stem":143,"description":431,"children":-1},"What each connection permission allows, how an agent's changes wait for review, and what to expect while you and an agent work on the same page.",{"title":149,"path":150,"stem":151,"description":433,"children":-1},"Fix the server problems the Agents view reports, from a subfolder install to a missing Authorization header, and read why an agent's write is refused or rate-limited.",1791648013965]