Skip to content

docs: document adding models not in the catalog - #896

Open
braginini wants to merge 2 commits into
mainfrom
feature/agent-network-pricing
Open

docs: document adding models not in the catalog#896
braginini wants to merge 2 commits into
mainfrom
feature/agent-network-pricing

Conversation

@braginini

@braginini braginini commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Summary by CodeRabbit

  • Documentation
    • Added guidance for AWS Bedrock cross-region inference profiles, including geography-specific model IDs and custom pricing.
    • Expanded model and pricing documentation to cover cache pricing, self-hosted defaults, and uncataloged models.
    • Documented Agent Network pricing defaults configuration, reload behavior, error handling, and dashboard overrides.

@vercel

vercel Bot commented Jul 31, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Jul 31, 2026 3:02pm

Request Review

@coderabbitai

coderabbitai Bot commented Jul 31, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 3fa34e6d-51fb-4531-9102-6ae7f90b5f37

📥 Commits

Reviewing files that changed from the base of the PR and between d984ccd and e32d760.

📒 Files selected for processing (1)
  • src/pages/selfhosted/maintenance/configuration-files.mdx
🚧 Files skipped from review as they are similar to previous changes (1)
  • src/pages/selfhosted/maintenance/configuration-files.mdx

📝 Walkthrough

Walkthrough

The documentation now covers Agent Network model pricing, cache rates, self-hosted pricing defaults, uncatalogued models, and AWS Bedrock cross-region inference profiles.

Changes

Agent Network pricing documentation

Layer / File(s) Summary
Model pricing and uncatalogued models
src/pages/agent-network/providers.mdx
Documents input, output, cache-read, and cache-creation rates, provider-specific billing, self-hosted defaults, and manual model pricing.
Self-hosted pricing defaults
src/pages/selfhosted/maintenance/configuration-files.mdx
Documents the pricing defaults file, reload behavior, error handling, and dashboard override precedence.
Bedrock cross-region profiles
src/pages/agent-network/integrations/bedrock.mdx
Documents geography-prefixed inference profiles, manual catalog entry, and custom pricing configuration.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

  • netbirdio/docs#886: Covers related Agent Network pricing and prompt-cache documentation.

Poem

A rabbit checks each pricing rate,
Cache fields keep the totals straight.
Bedrock profiles show their place,
Self-hosted defaults load with grace.
Clearer docs now fill the space.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly describes the main documentation change for adding models that are not in the catalog.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch feature/agent-network-pricing

Warning

There were issues while running some tools. Please review the errors and either fix the tool's configuration or disable the tool if it's a critical failure.

🔧 ESLint

If the error stems from missing dependencies, add them to the package.json file. For unrecoverable errors (e.g., due to private dependencies), disable the tool in the CodeRabbit configuration.

src/pages/selfhosted/maintenance/configuration-files.mdx

Oops! Something went wrong! :(

ESLint: 9.39.2

TypeError: Converting circular structure to JSON
--> starting at object with constructor 'Object'
| property 'configs' -> object with constructor 'Object'
| property 'flat' -> object with constructor 'Object'
| ...
| property 'plugins' -> object with constructor 'Object'
--- property 'react' closes the circle
Referenced from:
at JSON.stringify ()
at file:///node_modules/@eslint/eslintrc/lib/shared/config-validator.js:308:45
at Array.map ()
at ConfigValidator.formatErrors (file:///node_modules/@eslint/eslintrc/lib/shared/config-validator.js:299:23)
at ConfigValidator.validateConfigSchema (file:///node_modules/@eslint/eslintrc/lib/shared/config-validator.js:330:84)
at ConfigArrayFactory._normalizeConfigData (file:///node_modules/@eslint/eslintrc/lib/config-array-factory.js:676:19)
at ConfigArrayFactory._loadConfigData (file:///node_modules/@eslint/eslintrc/lib/config-array-factory.js:641:21)
at ConfigArrayFactory._loadExtendedShareableConfig (file:///node_modules/@eslint/eslintrc/lib/config-array-factory.js:946:21)
at ConfigArrayFactory._loadExtends (file:///node_modules/@eslint/eslintrc/lib/config-array-factory.js:814:25)
at ConfigArrayFactory._normalizeObjectConfigDataBody (file:///node_modules/@eslint/eslintrc/lib/config-array-factory.js:752:25)


Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@src/pages/agent-network/providers.mdx`:
- Around line 135-137: Replace the sentence beginning “Self-hosters can seed”
with the grammatically correct wording “Self-hosters can use a pricing file to
seed the catalog defaults for these fields.” Preserve the existing
pricingDefaultsFile link.

In `@src/pages/selfhosted/maintenance/configuration-files.mdx`:
- Around line 408-410: Update the server.agentNetwork.pricingDefaultsFile
documentation to state that Bedrock pricing keys must use normalized model IDs
rather than pasted full IDs. Document removing ARN wrappers,
us./eu./apac./global. prefixes, and -vN[:N] or date-version suffixes, including
the example normalization from eu.anthropic.claude-sonnet-5 to
anthropic.claude-sonnet-5.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 4c6117e7-b4ca-400b-a152-4544a46c0405

📥 Commits

Reviewing files that changed from the base of the PR and between cb6aa7b and d984ccd.

⛔ Files ignored due to path filters (2)
  • public/docs-static/img/agent-network/providers/agent-network-custom-model.png is excluded by !**/*.png
  • public/docs-static/img/agent-network/providers/agent-network-provider-metadata.png is excluded by !**/*.png
📒 Files selected for processing (3)
  • src/pages/agent-network/integrations/bedrock.mdx
  • src/pages/agent-network/providers.mdx
  • src/pages/selfhosted/maintenance/configuration-files.mdx

Comment on lines +135 to +137
Self-hosters can seed the catalog defaults these fields prefill from with a
pricing file. See
[`server.agentNetwork.pricingDefaultsFile`](/selfhosted/maintenance/configuration-files#agent-network-settings).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Rewrite the pricing-file sentence for clarity.

Line 53 uses pre-fills, while this line uses prefill. The current sentence is also ungrammatical. Use: “Self-hosters can use a pricing file to seed the catalog defaults for these fields.”

Static analysis flagged the inconsistent variants.

🧰 Tools
🪛 LanguageTool

[uncategorized] ~135-~135: Do not mix variants of the same word (‘prefill’ and ‘pre-fill’) within a single text.
Context: ... seed the catalog defaults these fields prefill from with a pricing file. See [`server....

(EN_WORD_COHERENCY)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@src/pages/agent-network/providers.mdx` around lines 135 - 137, Replace the
sentence beginning “Self-hosters can seed” with the grammatically correct
wording “Self-hosters can use a pricing file to seed the catalog defaults for
these fields.” Preserve the existing pricingDefaultsFile link.

Source: Linters/SAST tools

Comment thread src/pages/selfhosted/maintenance/configuration-files.mdx
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.

1 participant