co-op/support
3
0 Fork 0
Code Issues 13 Pull Requests Actions Packages Projects Releases Wiki Activity

Agent docs for members + operator token inventory #31

New Issue
Closed
opened 2026-10-26 05:09:00 +00:00 by inference-bot · 2 comments
inference-bot commented 2026-10-26 05:09:00 +00:00
Owner
Copy link
Copy source

Two member-facing follow-ups came out of the agent-infrastructure work (#17). They live here so they survive that issue closing.

1. A short "working with the agent" page in co-op/docs. What members can ask it for, what never to bring into a shared room, what it does without being asked, and what always needs a human decision. (Offered by @solo.ist — a docs PR, edited down by the operator.)

2. An operator token/credential inventory. Every token the agent and the portal hold, with its scope, where it lives, and who can rotate it — the public-safe half goes in the docs, the owners and locations are filled in by the operator, and the secret half stays in the private ops repo.

Neither document contains secrets: the docs get the non-secret half only.

Two member-facing follow-ups came out of the agent-infrastructure work (#17). They live here so they survive that issue closing. **1. A short "working with the agent" page in `co-op/docs`.** What members can ask it for, what never to bring into a shared room, what it does without being asked, and what always needs a human decision. (Offered by @solo.ist — a docs PR, edited down by the operator.) **2. An operator token/credential inventory.** Every token the agent and the portal hold, with its scope, where it lives, and who can rotate it — the public-safe half goes in the docs, the owners and locations are filled in by the operator, and the secret half stays in the private ops repo. Neither document contains secrets: the docs get the non-secret half only.
inference-bot commented 2026-10-26 05:12:47 +00:00
Author
Owner
Copy link
Copy source

Both member-facing contributions from @solo.ist are now open against co-op/docs, and I have reviewed each against live configuration:

  • co-op/docs#6 — "Working with the agent" (member norms)
  • co-op/docs#7 — credential inventory in the operator token runbook

Corrections posted on both. The ones needing an operator decision rather than an edit: the deploy norm in #6 (the page is stricter than current practice — whichever way it lands, the page should win), and scoping the steward bot's gateway key like the new agent's, which is what makes the #7 row accurate. Tracking here so neither PR goes quiet.

Both member-facing contributions from @solo.ist are now open against `co-op/docs`, and I have reviewed each against live configuration: - co-op/docs#6 — "Working with the agent" (member norms) - co-op/docs#7 — credential inventory in the operator token runbook Corrections posted on both. The ones needing an operator decision rather than an edit: the deploy norm in #6 (the page is stricter than current practice — whichever way it lands, the page should win), and scoping the steward bot's gateway key like the new agent's, which is what makes the #7 row accurate. Tracking here so neither PR goes quiet.
inference-bot commented 2026-11-04 01:19:43 +00:00
Author
Owner
Copy link
Copy source

Both follow-ups are landed, and both are @solo.ist's work — they did the writing, in October, and waited a week for the repositories to settle under the PRs.

1. "Working with the agent" — merged and live.
co-op/docs#6 was rebased onto current main (the day's changes to README, the footer source link, and the move of operator material out of the site) and merged as 98cd517 (rebase merge; the member's two commits keep their authorship). The page is in the nav and linked from the README index and getting-started, and it is live:
https://docs.inference.coop/working-with-the-agent/
Fail-proof checks: the old operator-token-runbook.md reference in the page now points at the runbook's new home in co-op/ops-docs (the file left the published site), and the removed "documentation lives in a public git repository" notice is not reintroduced.

2. The credential inventory — moved to co-op/ops-docs, now merged there.
co-op/docs#7 patched operator-token-runbook.md, which no longer lives in co-op/docs — it was moved to the git-only co-op/ops-docs as deliberately non-published operator material. That move makes a credential inventory more appropriate, so the change was ported there rather than merged into the published site:
co-op/ops-docs#1 — "operator-token-runbook: add a credential inventory (from co-op/docs#7, by solo.ist)" — co-op/ops-docs#1 — merged as 63d1415.
It is committed with solo.ist's authorship (Angel Marino <amarino@solo.ist>); names and roles only, no secret values. co-op/docs#7 is closed unmerged, pointing here.
Two points raised after that PR's last review are reflected in what landed: the old OC_PERSONAL_TOKEN is recorded as already revoked (confirmed 2026-10-27), and the LibreChat RAG service key (rag-service-embeddings, added 2026-10-27) is a row.

Closing this — the two documents exist, in the right places. Thank you, @solo.ist.

Both follow-ups are landed, and both are @solo.ist's work — they did the writing, in October, and waited a week for the repositories to settle under the PRs. **1. "Working with the agent" — merged and live.** co-op/docs#6 was rebased onto current `main` (the day's changes to README, the footer source link, and the move of operator material out of the site) and merged as **98cd517** (rebase merge; the member's two commits keep their authorship). The page is in the nav and linked from the README index and getting-started, and it is live: https://docs.inference.coop/working-with-the-agent/ Fail-proof checks: the old `operator-token-runbook.md` reference in the page now points at the runbook's new home in co-op/ops-docs (the file left the published site), and the removed "documentation lives in a public git repository" notice is not reintroduced. **2. The credential inventory — moved to co-op/ops-docs, now merged there.** co-op/docs#7 patched `operator-token-runbook.md`, which no longer lives in co-op/docs — it was moved to the git-only **co-op/ops-docs** as deliberately non-published operator material. That move makes a credential inventory *more* appropriate, so the change was ported there rather than merged into the published site: **co-op/ops-docs#1** — "operator-token-runbook: add a credential inventory (from co-op/docs#7, by solo.ist)" — https://git.inference.coop/co-op/ops-docs/pulls/1 — merged as **63d1415**. It is committed with solo.ist's authorship (`Angel Marino <amarino@solo.ist>`); names and roles only, no secret values. co-op/docs#7 is closed unmerged, pointing here. Two points raised after that PR's last review are reflected in what landed: the old `OC_PERSONAL_TOKEN` is recorded as already revoked (confirmed 2026-10-27), and the LibreChat RAG service key (`rag-service-embeddings`, added 2026-10-27) is a row. Closing this — the two documents exist, in the right places. Thank you, @solo.ist.
Sign in to join this conversation.
No Branch/Tag Specified
Labels
Clear labels
Community
Compute
Design
Finance
Governance
Infrastructure
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
inference-admin (Admin) inference-bot (InferenceBot)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: co-op/support#31