Back to Continue

Tetrate Agent Router Service

docs/customize/model-providers/top-level/tetrate_agent_router_service.mdx

2.1.0-vscode4.6 KB
Original Source

The Tetrate Agent Router Service provides a unified Gateway for accessing various AI models with fast inference capabilities.

This gateway acts as an intelligent router that can distribute requests across multiple model providers, offering enterprise-grade reliability and performance optimization.

<Tip> Want to get started quickly? Sign up for the [Tetrate Agent Router Service](https://router.tetrate.ai/) to get an API key, then follow the configuration examples below. </Tip>

Setup

<Steps> <Step title="Sign in or sign up"> Visit the [Agent Router Service portal](https://router.tetrate.ai/) and create an account to get your API key </Step> <Step title="Get your API key"> Go to the [API keys page](https://router.tetrate.ai/api-keys) to get your key </Step> <Step title="Configure Continue"> - Choose a configuration method below. - If you use the Continue VS Code extension, install version `>=1.2.3`. </Step> </Steps>

Configuration Methods

<CardGroup cols={1}> <Card title="In Local Agent Configuration" icon="folder" vertical> Define models directly in your local agent configuration. </Card> <Card title="Using Local Model Blocks" icon="file-lines" vertical> Create a local model block for reuse across agents. </Card> </CardGroup>

Configuration Examples

<Info> **Click a tab** to see an example. </Info> <Tabs> <Tab title="In Local Agent Configuration">

When to use: Simple local setups (like using the VS Code extension) when you don't need shared or published blocks.

Use a Tetrate model block in your local agent configuration:

yaml
name: Local Agent
version: 1.0.0
schema: v1
models:
  - uses: tetrate/claude-sonnet-4
    with:
      TETRATE_API_KEY: ${{ secrets.TETRATE_API_KEY }}
context:
  - provider: code
  - provider: docs
  - provider: diff
  - provider: terminal
  - provider: problems
  - provider: folder
  - provider: codebase

Or define the model directly:

yaml
name: Local Agent
version: 1.0.0
schema: v1
models:
  - name: Claude Sonnet 4
    provider: tars
    model: claude-4-sonnet-20250514
    apiKey: ${{ secrets.TETRATE_API_KEY }}
    roles:
      - chat
      - edit
      - apply
    capabilities:
      - tool_use
context:
  - provider: code
  - provider: docs
  - provider: diff
  - provider: terminal
  - provider: problems
  - provider: folder
  - provider: codebase
</Tab> <Tab title="Using Local Model Blocks"> **When to use**: Reuse configurations across agents and keep them local or in GitHub.

The Local Model Block: <Info> Name the file my-claude-4-model.yaml so you can reference it in the Agent. </Info>

yaml
name: Claude Sonnet 4
version: 1.0.1
schema: v1
models:
  - name: Claude Sonnet 4
    provider: tars
    model: claude-4-sonnet-20250514
    apiKey: ${{ inputs.TETRATE_API_KEY }}
    roles:
      - chat
      - edit
      - apply
    capabilities:
      - tool_use

Reference it as my-claude-4-model in your Agent configuration:

yaml
name: Simple Agent
version: 1.0.0
schema: v1
models:
  - uses: my-claude-4-model
    with:
      TETRATE_API_KEY: ${{ secrets.TETRATE_API_KEY }}
context:
  - uses: continuedev/diff-context
  - uses: continuedev/terminal-context
  - uses: continuedev/file-context
<Tip> Learn more about [model blocks](/reference#models). </Tip> </Tab> </Tabs>

Troubleshooting Common Issues

<CardGroup cols={2}> <Card title="Invalid API key" icon="key" vertical> Verify your API key is active and has no extra spaces. </Card> <Card title="Model not found" icon="ban" href="https://router.tetrate.ai/models" vertical> Confirm the model ID matches the Tetrate catalog. </Card> <Card title="Slow responses" icon="code" vertical> Check your network or try a less-loaded model. Contact Tetrate support if issues persist. </Card> <Card title="Configuration not loading" icon="file-lines" vertical> Validate YAML syntax and review error messages in Continue. </Card> </CardGroup>

Join the Community

Connect with Tetrate and other builders for help and discussion.

<CardGroup cols={1}> <Card title="Join the Tetrate Community" icon="slack" href="https://join.slack.com/t/tetrate-agent-router/shared_invite/zt-399tv7hjm-6YMXztGywTOQrMIolvEBNg"> Get answers, insights, and best practices for secure, scalable infrastructure </Card> </CardGroup>