docs: reorganise into Guides / Operations / Governance
- Guides/: getting started, guest access, models, API access, energy & carbon - Operations/: agentic systems (was 'working with the agent'), infrastructure, roles, steward policy - Governance/: unchanged, now with its overview page Lateral links and the homepage updated; redirects keep the old root URLs alive.
This commit is contained in:
1 parent
a6142d68f2
commit
ac8cac02c6
13 files changed
+66
-29
No files matched your search
@@ -0,0 +1,69 @@
|
||||
# Working with the agent
|
||||
|
||||
The co-op runs **Inferencebot** to help steward its infrastructure. It is
|
||||
isolated as its own OS user, with its own gateway key — budget, model
|
||||
allowlist and spend enforced at the gateway. It runs on co-op infrastructure
|
||||
under a co-op identity, uses the co-op's own gateway for inference, and its
|
||||
skills, scripts and configuration are mirrored to a Gitea repository nightly.
|
||||
This page is for members who read its output or give it instructions.
|
||||
|
||||
## Where it speaks and listens
|
||||
|
||||
- **#inferencebot-updates** is read-only: daily digests, model changes,
|
||||
upgrades, maintenance, outages. Posts are anonymized.
|
||||
- **Instructing the agent** is limited to members on its allowlist of Matrix
|
||||
IDs (kept in its configuration, published here once settled), and only in
|
||||
the rooms where it is configured to answer — most require a mention. The
|
||||
General Manager decides who is on the list.
|
||||
- The **retired `@inference-bot:inference.coop`** automation account (with a
|
||||
hyphen) no longer holds an access token; some historical references and old
|
||||
room roles still carry the name.
|
||||
|
||||
## What to ask for
|
||||
|
||||
- Operational work that a runbook already describes, or that ends in a PR, an
|
||||
issue or a post members can see.
|
||||
- Research and summaries that would otherwise land in an issue.
|
||||
- Status: what is running, what failed, what changed.
|
||||
|
||||
## What not to ask in a shared room
|
||||
|
||||
- Anything involving member-identifying data. That work happens in a session a
|
||||
named steward opened, and the result is reported without the data.
|
||||
- Anything that moves money or changes who is a member. Those go through the
|
||||
portal and a human.
|
||||
- Credentials, in either direction.
|
||||
|
||||
## What they do without asking
|
||||
|
||||
Read, monitor, draft, open issues and PRs, post updates, run the scheduled jobs
|
||||
listed in [Infrastructure](infrastructure.md), and deploy bug and security
|
||||
fixes immediately, reporting each one in #inferencebot-updates.
|
||||
|
||||
## What always needs a human
|
||||
|
||||
- Member-visible, destructive or risky changes to the gateway, the portal or
|
||||
the chat: confirmed before they deploy.
|
||||
- Changing the model catalog, prices or budgets.
|
||||
- Minting or rotating credentials.
|
||||
- Anything a runbook marks "confirm".
|
||||
|
||||
This matches the standing policy the agents operate under today. A stricter
|
||||
norm is a policy decision for the [forum](https://forum.inference.coop).
|
||||
|
||||
## Attribution and the off switch
|
||||
|
||||
Every instruction an agent acts on is attributable to the member who gave it,
|
||||
in the room where it was given. If an agent misbehaves, the operator, or anyone
|
||||
holding gateway-admin and Matrix account access, can stop it: revoke its
|
||||
gateway key, then its Matrix access token. Stewards generally do not hold that
|
||||
access today, so say what you saw in #general and the operator acts. Stopping
|
||||
is not restarting: the backup and the git mirror restore state, not uptime,
|
||||
and someone has to start the agent again. The steps, and the steps for
|
||||
rotating everything an agent holds, are in the agent's runbook; the credential
|
||||
inventory in the [operator token
|
||||
runbook](https://git.inference.coop/co-op/ops-docs/src/branch/main/operator-token-runbook.md)
|
||||
says what that is.
|
||||
|
||||
Changes to this page are policy: propose them in the
|
||||
[forum](https://forum.inference.coop).
|
||||
Reference in new issue
Block a user