Agent integration: new docs page + sidebar entry across all docs
Ports the in-repo KEYSAT_AGENT_GUIDE.md into the docs site as a first-class page rather than linking out to a raw markdown file on GitHub. The page covers authentication, scoped API keys, OpenAPI discovery, error envelope conventions, common workflows (issue / revoke / find / cancel / change-tier / free-machine), webhook event types + signature verification, robust-agent patterns, a "comp-license-via-email" recipe, and the operator-only operations that aren't exposed to any scoped key. Sidebar gains an "Agent integration" entry under Get started on every page (index, install, integrate, wire-format, operate, agent itself). Docs index "These docs cover" + "Where to next" grids each gain a third card pointing at the agent guide so it's discoverable from the introduction page even for visitors who don't scan the sidebar.
This commit is contained in:
+11
@@ -21,6 +21,7 @@
|
||||
<a href="index.html" class="active">Introduction</a>
|
||||
<a href="install.html">Install & setup</a>
|
||||
<a href="integrate.html">Integrate the SDK</a>
|
||||
<a href="agent.html">Agent integration</a>
|
||||
</div>
|
||||
<div class="group">
|
||||
<div class="glabel">Concepts</div>
|
||||
@@ -61,6 +62,11 @@
|
||||
<h4>Integrate the SDK →</h4>
|
||||
<p>Add the SDK to your app, embed your public key, verify a license at startup. About five lines of code.</p>
|
||||
</a>
|
||||
<a class="next-card" href="agent.html">
|
||||
<span class="eyebrow">Agent / automation</span>
|
||||
<h4>Agent integration →</h4>
|
||||
<p>OpenAPI spec, scoped API keys, webhooks. Build bots that issue comp licenses, react to events, or automate support flows.</p>
|
||||
</a>
|
||||
</div>
|
||||
|
||||
<h2 id="architecture">Architecture</h2>
|
||||
@@ -138,6 +144,11 @@
|
||||
<h4>Integrate the SDK →</h4>
|
||||
<p>Embed your public key, add the SDK to your app, verify a license offline.</p>
|
||||
</a>
|
||||
<a class="next-card" href="agent.html">
|
||||
<span class="eyebrow">Step 1 for agent builders</span>
|
||||
<h4>Agent integration →</h4>
|
||||
<p>Operate your Keysat instance programmatically. OpenAPI spec, scoped keys, webhooks, recipes.</p>
|
||||
</a>
|
||||
</div>
|
||||
</main>
|
||||
|
||||
|
||||
Reference in New Issue
Block a user