The Open Framework for Building Agents
docs(eve): model configuration - fix direct Anthropic model IDs (#296)
Andrew Barba74fee29f97af
diff --git a/docs/agent-config.md b/docs/agent-config.mdindex e6752d6f8..486c26ae7 100644--- a/docs/agent-config.md+++ b/docs/agent-config.md@@ -33,10 +33,14 @@ import { anthropic } from "@ai-sdk/anthropic";import { defineAgent } from "eve";export default defineAgent({- model: anthropic("claude-opus-4.8"),+ model: anthropic("claude-opus-4-8"),});```+Direct provider model ids use the provider's native format. For Anthropic, the+version uses hyphens (`claude-opus-4-8`), while the Gateway id above uses a dot+(`anthropic/claude-opus-4.8`).+Model use is subject to the terms, data-processing commitments, retention behavior, and available controls of the selected provider and routing path. Review the [AI Gateway model catalog](https://vercel.com/ai-gateway/models) for gateway-routed models, and review the provider's terms when you configure a direct `LanguageModel`.## Reasoning effortdiff --git a/docs/guides/deployment.md b/docs/guides/deployment.mdindex c4ff4684f..2b55c44f3 100644--- a/docs/guides/deployment.md+++ b/docs/guides/deployment.md@@ -74,11 +74,11 @@ import { anthropic } from "@ai-sdk/anthropic";import { defineAgent } from "eve";export default defineAgent({- model: anthropic("claude-opus-4.8"),+ model: anthropic("claude-opus-4-8"),});```-With that shape, the model call goes directly to Anthropic and the runtime reads `ANTHROPIC_API_KEY`. The same pattern works for OpenAI after installing `@ai-sdk/openai`, using `openai("...")`, and setting `OPENAI_API_KEY`. This is the usual choice when self-deploying without any Vercel-managed services.+With that shape, the model call goes directly to Anthropic and the runtime reads `ANTHROPIC_API_KEY`. Direct Anthropic model ids use hyphens (`claude-opus-4-8`), unlike the dotted Gateway id (`anthropic/claude-opus-4.8`). The same pattern works for OpenAI after installing `@ai-sdk/openai`, using `openai("...")`, and setting `OPENAI_API_KEY`. This is the usual choice when self-deploying without any Vercel-managed services.## 4. Sandbox backenddiff --git a/docs/tutorial/first-agent.mdx b/docs/tutorial/first-agent.mdxindex 1d7423d05..773aa2be2 100644--- a/docs/tutorial/first-agent.mdx+++ b/docs/tutorial/first-agent.mdx@@ -10,7 +10,7 @@ Step 1 gets it talking. The scaffold bundles a small sample dataset, so your fir## Prerequisites- Node 24 or newer and npm.-- A model credential. The scaffold's default model goes through the [Vercel AI Gateway](../getting-started), so you need `AI_GATEWAY_API_KEY` (or `VERCEL_OIDC_TOKEN` pulled via `vercel link`). A direct provider model like `anthropic("claude-opus-4.8")` instead needs that provider's AI SDK package and key, here `@ai-sdk/anthropic` and `ANTHROPIC_API_KEY`.+- A model credential. The scaffold's default model goes through the [Vercel AI Gateway](../getting-started), so you need `AI_GATEWAY_API_KEY` (or `VERCEL_OIDC_TOKEN` pulled via `vercel link`). A direct provider model like `anthropic("claude-opus-4-8")` instead needs that provider's AI SDK package and key, here `@ai-sdk/anthropic` and `ANTHROPIC_API_KEY`.If you have not run eve before, complete [Getting Started](../getting-started) first. Without a credential, "Run the agent" below fails when the runtime tries to reach the model; the dev TUI's `/model` flow walks you through pasting a key or linking a project.