Skip to content

docs: document web-UI harness credential setup - #392

Open
omnigent-ci[bot] wants to merge 4 commits into
mainfrom
auto/docs/pr-3088
Open

docs: document web-UI harness credential setup#392
omnigent-ci[bot] wants to merge 4 commits into
mainfrom
auto/docs/pr-3088

Conversation

@omnigent-ci

@omnigent-ci omnigent-ci Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Documentation update for omnigent-ai/omnigent#3088 — feat(onboarding): write a harness provider credential from the UI (M3 backend)

Changes documented

  • app/docs/build/models/page.mdx — added a "From the web UI" subsection under Credentials describing the setup dialog's Add a credential action: the three kinds (API key / gateway / adopt), where the secret is stored on the host (OS keychain → ~/.omnigent/secrets.json), the providers: reference-not-raw-value behavior, the server-as-pass-through security note, the Claude/Codex/Pi vs. env-auth (OpenCode/Qwen) scope, in-place readiness refresh, and the OMNIGENT_HARNESS_INSTALL_ENABLED gate.

Manual review needed

  • app/docs/build/models/page.mdx — no screenshot/GIF exists for the new web-UI credential dialog; consider adding one (I cannot generate binaries).
  • app/reference (REST API) — two new endpoints (POST /v1/hosts/{host_id}/harnesses/{harness}/credential and GET /v1/hosts/{host_id}/credentials/detected) landed in openapi.json. If the reference page is generated from that spec no action is needed; if it's hand-maintained, add these routes.
  • Placement check — I extended Models & Credentials rather than the Web UI page; a reviewer may prefer a cross-link or a short mention on app/docs/interact/web-ui/page.mdx.

Source PR: omnigent-ai/omnigent#3088 · merged by @xq-yin
Drafted automatically by the doc-sync workflow. Review for accuracy before merging.

omnigent-ci Bot and others added 4 commits July 22, 2026 14:33
Co-authored-by: omnigent-ci[bot] <294685417+omnigent-ci[bot]@users.noreply.github.com>
Co-authored-by: omnigent-ci[bot] <294685417+omnigent-ci[bot]@users.noreply.github.com>
)

* docs(build): add Smart Routing page with external routing API spec

Document the smart-routing feature as a standalone page under Build:
- enabling it via OMNIGENT_SMART_ROUTING=1 (built-in judge vs external API)
- the top-level routing: server config block (base_url, router_name,
  model_prefix, api_key/profile auth precedence)
- the external routes:select API spec (SelectRouteRequest /
  SelectRouteResponse from omnigent.api.routing.v1) with request/response
  field tables and JSON examples

Registered in the sidebar and prev/next nav under Custom Agents, and
regenerated the OG manifest.

* docs(routing): smart routing enables from config, no OMNIGENT_SMART_ROUTING

The server no longer gates routing behind an opt-in env; it builds the routing
client whenever an llm: block (built-in judge) or a routing.provider=external
block is configured. Update the enablement section accordingly.

Signed-off-by: Tomu Hirata <tomu.hirata@databricks.com>

* docs(routing): regenerate og-manifest for 0.7-docs pages

Regenerate lib/og-manifest.json from the pages actually present on the 0.7-docs
branch, so the routing entry is added without dragging in main-only manifest
copy (the cherry-pick had carried main's mobile description).

Signed-off-by: Tomu Hirata <tomu.hirata@databricks.com>

* docs(routing): drop '(default)' label from built-in judge

Neither router is a default — routing is chosen by which config block is
present (llm: → built-in judge, routing.provider=external → external API).

Signed-off-by: Tomu Hirata <tomu.hirata@databricks.com>

* docs(routing): add demo video and fix server start command

- Embed a Smart Routing demo (public/images/docs/smart-routing-oss.mp4) via a
  <video> tag in the routing page.
- Fix the enablement command: 'omni server -c path/to/config.yaml' (the server
  subcommand + explicit config path), not 'omni serve'.

Signed-off-by: Tomu Hirata <tomu.hirata@databricks.com>

* docs(routing): size demo video via inline style like site images

className=w-full (Tailwind) on a raw MDX element wasn't in the compiled CSS, so
the video rendered at its intrinsic (oversized) resolution. Use the same inline
style the site's img mapper applies (width:100%, height:auto, rounded) so the
video scales to the content column like the GIF demos.

Signed-off-by: Tomu Hirata <tomu.hirata@databricks.com>

* docs(routing): move demo video up under the intro

Place the demo right after the opening paragraph (before 'Two routers are
available') so readers see it before the configuration details.

Signed-off-by: Tomu Hirata <tomu.hirata@databricks.com>

* docs(routing): replace em dashes with commas/colons

Drop em dashes throughout the routing page in favor of commas or colons for a
plainer style.

Signed-off-by: Tomu Hirata <tomu.hirata@databricks.com>

* docs(routing): drop redundant 'no feature flag' sentence

The enablement section already explains that routing turns on from config
(an llm: block or a routing: block), so the standalone sentence was redundant.

Signed-off-by: Tomu Hirata <tomu.hirata@databricks.com>

---------

Signed-off-by: Tomu Hirata <tomu.hirata@databricks.com>
@vercel

vercel Bot commented Jul 24, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
omnigent-site Ready Ready Preview, Comment Jul 24, 2026 10:53am

Request Review

@omnigent-ci omnigent-ci Bot added automated-docs Automated documentation update v0.7.0 Docs staged for the v0.7.0 release labels Jul 24, 2026
@omnigent-ci
omnigent-ci Bot requested a review from xq-yin July 24, 2026 10:52
Base automatically changed from 0.7-docs to main July 31, 2026 08:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

automated-docs Automated documentation update v0.7.0 Docs staged for the v0.7.0 release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants