Skip to content

docs: define Resources/Agent/Model Server in the glossary (#1205 friction #9, #395)#1634

Merged
wprazuch merged 2 commits into
mainfrom
wprazuch/resources-server-glossary
Jun 24, 2026
Merged

docs: define Resources/Agent/Model Server in the glossary (#1205 friction #9, #395)#1634
wprazuch merged 2 commits into
mainfrom
wprazuch/resources-server-glossary

Conversation

@wprazuch

@wprazuch wprazuch commented Jun 17, 2026

Copy link
Copy Markdown
Contributor

What

The key-terminology glossary (fern/.../about/concepts/key-terminology.mdx) defined Verifier, Policy Model, etc. but not the three FastAPI server types — so "Resources Server" was never actually defined (#395: the name is nebulous). Added clear Architecture-Terms entries:

  • Resources Serveris the environment: per-task state + tools + verify() → reward. "Read it as the environment + verifier service."
  • Agent Server (Responses API Agent) — the harness that drives the model through the task.
  • Model Server (Responses API Model) — wraps an LLM endpoint behind the Responses API.

Each ties the term to its directory (resources_servers/, responses_api_agents/, responses_api_models/). Mirrored into latest and v0.3.0.

Why

Epic #1205 friction 9 (naming confusion), RFC milestone M6e. Docs-only.

@copy-pr-bot

copy-pr-bot Bot commented Jun 17, 2026

Copy link
Copy Markdown

This pull request requires additional validation before any workflows can run on NVIDIA's runners.

Pull request vetters can view their responsibilities here.

Contributors can view more details about this message here.

@github-actions

github-actions Bot commented Jun 17, 2026

Copy link
Copy Markdown

@wprazuch wprazuch force-pushed the wprazuch/ng-test-concurrency branch from 2fdee46 to eebfcf8 Compare June 22, 2026 13:45
@wprazuch wprazuch requested a review from a team as a code owner June 22, 2026 13:45
@wprazuch wprazuch force-pushed the wprazuch/resources-server-glossary branch from 895718f to 32ade49 Compare June 24, 2026 07:01
@wprazuch wprazuch changed the base branch from wprazuch/ng-test-concurrency to wprazuch/cli-clean-base June 24, 2026 07:02
@wprazuch wprazuch closed this Jun 24, 2026
@wprazuch wprazuch reopened this Jun 24, 2026
@wprazuch wprazuch force-pushed the wprazuch/resources-server-glossary branch 2 times, most recently from 875e1de to a907b3a Compare June 24, 2026 07:18
@wprazuch wprazuch changed the base branch from wprazuch/cli-clean-base to martas/1434 June 24, 2026 07:18
@wprazuch wprazuch force-pushed the wprazuch/resources-server-glossary branch from a907b3a to 3e47abc Compare June 24, 2026 07:21
@wprazuch wprazuch requested a review from marta-sd June 24, 2026 08:40
Comment thread fern/versions/latest/pages/about/concepts/key-terminology.mdx Outdated
Comment thread fern/versions/latest/pages/about/concepts/key-terminology.mdx Outdated
@wprazuch wprazuch force-pushed the wprazuch/resources-server-glossary branch from 3e47abc to de8fead Compare June 24, 2026 09:42
@wprazuch wprazuch changed the base branch from martas/1434 to main June 24, 2026 09:42
@wprazuch wprazuch force-pushed the wprazuch/resources-server-glossary branch from de8fead to c4ccdc9 Compare June 24, 2026 09:54
wprazuch added 2 commits June 24, 2026 11:58
Epic #1205 friction #9 (FEP-1023 / M6e), issue #395 ('Resources Server' is
nebulous): the key-terminology glossary defined Verifier/Policy Model but not
the three FastAPI server types. Add clear entries for Resources Server (= the
environment + verifier service), Agent Server, and Model Server, tying each to
its directory. Mirrored into latest + v0.3.0.

Signed-off-by: Wojciech Prazuch <wprazuch@nvidia.com>
Per review: do not equate the resources server with "the environment" (in Gym an environment is a
resources server + agent + dataset(s)), and surface multiple built-in agent harnesses
(simple_agent, aviary_agent, ...) instead of featuring simple_agent alone.

Signed-off-by: Wojciech Prazuch <wprazuch@nvidia.com>
@wprazuch wprazuch force-pushed the wprazuch/resources-server-glossary branch from c4ccdc9 to 19f69a0 Compare June 24, 2026 09:58
@wprazuch wprazuch merged commit 07dfc48 into main Jun 24, 2026
10 checks passed
@wprazuch wprazuch deleted the wprazuch/resources-server-glossary branch June 24, 2026 09:59
ritaneves pushed a commit that referenced this pull request Jun 25, 2026
…tion #9, #395) (#1634)

## What

The key-terminology glossary
(`fern/.../about/concepts/key-terminology.mdx`) defined `Verifier`,
`Policy Model`, etc. but **not** the three FastAPI server types — so
"Resources Server" was never actually defined
([#395](#395): the name is
nebulous). Added clear Architecture-Terms entries:

- **Resources Server** — *is* the environment: per-task state + tools +
`verify()` → reward. "Read it as the environment + verifier service."
- **Agent Server (Responses API Agent)** — the harness that drives the
model through the task.
- **Model Server (Responses API Model)** — wraps an LLM endpoint behind
the Responses API.

Each ties the term to its directory (`resources_servers/`,
`responses_api_agents/`, `responses_api_models/`). Mirrored into
`latest` and `v0.3.0`.

## Why

Epic [#1205](#1205) friction 9
(naming confusion), RFC milestone M6e. Docs-only.

---------

Signed-off-by: Wojciech Prazuch <wprazuch@nvidia.com>
Signed-off-by: Rita Fernandes Neves <rfernandesne@nvidia.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants