@genkit-ai/anthropic

中文文档
0.7.0发布于 2026/11/04Apache-2.0TypeScriptESM + CJS近 30 天下载 4.2万

Genkit AI框架插件用于Anthropic API.

中文使用文档
文档目录14 节
  1. 支持的模型
  2. 安装
  3. 使用量
  4. 初始化
  5. 基本实例
  6. 多式联运提示
  7. 扩展思维
  8. 文件引用
  9. 快速缓存
  10. Beta API 限制
  11. 在流动中
  12. 直接使用模型( 不包括 Genkit 实例)
  13. 鸣谢
  14. 贷项

Genkit Anthropic 人工智能插件

@genkit-ai/anthropic 是 Athropic 插件,用于 精灵。 。 。 . 它取代了早期的社区套装 genkitx-anthropic 现由Google维护.

用编码代理? 先安装基因组JS技能.

npx skills add genkit-ai/skills --skill developing-genkit-js

它教你的代理人 现任Genkit JS APIs 和普通的gitchas. 其他语言的来源、人工安装和技能: 技能/技能。 。 。 .

支持的模型

该插件支持最近的Anthropic模型, 如 克劳德·海库 4.5, (中文(简体) ), 克劳德·索内 4.5,以及 克劳德·奥普斯 4.5。此外,该插件 支持所有 非退休的旧型号。 。 。 .

安装

使用您最喜欢的软件包管理器在您的工程中安装插件 :

  • npm install @genkit-ai/anthropic
  • yarn add @genkit-ai/anthropic
  • pnpm add @genkit-ai/anthropic

使用量

初始化

import { genkit } from "genkit";
import { anthropic } from "@genkit-ai/anthropic";

const ai = genkit({
  plugins: [anthropic({ apiKey: process.env.ANTHROPIC_API_KEY })],
  // specify a default model for generate here if you wish:
  model: anthropic.model("claude-sonnet-4-5"),
});

基本实例

生成文本的最简单方法是使用 generate 方法 :

const response = await ai.generate({
  model: anthropic.model("claude-haiku-4-5"),
  prompt: "Tell me a joke.",
});

console.log(response.text);

多式联运提示

// ...initialize Genkit instance (as shown above)...

const response = await ai.generate({
  prompt: [
    { text: "What animal is in the photo?" },
    { media: { url: imageUrl } },
  ],
});
console.log(response.text);

扩展思维

Claude 4.5模型可以暴露其内部推理. 按请求启用 与Anthropic思想配置并读取反应中的推理:

const response = await ai.generate({
  prompt: "Walk me through your reasoning for Fermat’s little theorem.",
  config: {
    thinking: {
      enabled: true,
      budgetTokens: 4096, // Must be >= 1024 and less than max_tokens
    },
  },
});

console.log(response.text); // Final assistant answer
console.log(response.reasoning); // Summarized thinking steps

当思维被启用时,通过插件发送的请求机构包括 thinking 有效载荷({ type: 'enabled', budget_tokens: … }安东尼的 API 期望和流出的回应 reasoning 当它们到达的时候 你可以使思维链 递增.

文件引用

Claude可以引用你提供的文件的特定部分,这样很容易追踪到 答复中的信息来自何处。 使用 anthropicDocument() 帮助创建可读文档。 详情见 Anthropic 引用文件。 。 。 .

import { anthropic, anthropicDocument } from "@genkit-ai/anthropic";

const response = await ai.generate({
  model: anthropic.model("claude-sonnet-4-5"),
  messages: [
    {
      role: "user",
      content: [
        anthropicDocument({
          source: {
            type: "text",
            data: "The grass is green. The sky is blue. Water is wet.",
          },
          title: "Basic Facts",
          citations: { enabled: true },
        }),
        { text: "What color is the grass? Cite your source." },
      ],
    },
  ],
});

// Access citations from response parts
const citations = response.message?.content?.flatMap(
  (part) => part.metadata?.citations || [],
) ?? [];

console.log("Citations:", citations);

重要内容: 必须在请求中对所有文件或 没有 无法将文档与启用和禁用的引用相混合 同样的要求.

支持的文档源类型 :

  • text - 纯文本文档(返回) char_location 引用)
  • base64 - 基准64编码PDF(返回) page_location 引用)
  • url - 可通过URL访问的PDF(返回) page_location 引用)
  • content - 自定义包含文字/图像的内容块(返回) content_block_location 引用)
  • file - 来自 Anthropic 文件 API 的文件引用,仅β API (返回) page_location 引用)

在答复部分的元数据中退回引用,并包括信息 关于文档索引、所引用文本和位置(特征索引、页) 数字,或视来源类型而定的块索引.

快速缓存

您可以通过添加来缓存提示 cache_control 元数据到提示。 使用 cacheControl() 用于类型安全缓存配置的助手 。 您可以缓存系统 信息、用户信息、工具和媒体.

import { anthropic, cacheControl } from "@genkit-ai/anthropic";

const response = await ai.generate({
  model: anthropic.model("claude-sonnet-4-5"),
  system: {
    text: longSystemPrompt,
    metadata: { ...cacheControl() }, // default: ephemeral
  },
  messages: [
    {
      role: "user",
      content: [{ text: "What is the main idea of the text?" }],
    },
  ],
});

// Or with explicit TTL:
metadata: { ...cacheControl({ ttl: '1h' }) }

// Or using the type directly:
import { type AnthropicCacheControl } from "@genkit-ai/anthropic";
metadata: { cache_control: { type: 'ephemeral', ttl: '5m' } as AnthropicCacheControl }

注意: 缓存只有在提示超过一定符号长度时才使用. 这个 符号长度在 Athropic API 文档。 。 。 .

Beta API 限制

Β-API表面提供实验特性,但有些 此插件尚未支持服务器管理的工具块 。 以下内容: 如果遇到β API 特性, 将产生错误 :

  • web_fetch_tool_result
  • code_execution_tool_result
  • bash_code_execution_tool_result
  • text_editor_code_execution_tool_result
  • mcp_tool_result
  • mcp_tool_use
  • container_upload

请注意: server_tool_use 财务报告和审定财务报表 web_search_tool_result 获得支助和工作 与稳定与β API同时.

在流动中

import { z } from "genkit";

// ...initialize Genkit instance (as shown above)...

export const jokeFlow = ai.defineFlow(
  {
    name: "jokeFlow",
    inputSchema: z.string(),
    outputSchema: z.string(),
  },
  async (subject) => {
    const llmResponse = await ai.generate({
      prompt: `tell me a joke about ${subject}`,
    });
    return llmResponse.text;
  },
);

直接使用模型( 不包括 Genkit 实例)

插件支持 Genkit 插件 API v2, 它允许您使用模型 直接初始化整个源基框架:

import { anthropic } from "@genkit-ai/anthropic";

// Create a model reference directly
const claude = anthropic.model("claude-sonnet-4-5");

// Use the model directly
const response = await claude({
  messages: [
    {
      role: "user",
      content: [{ text: "Tell me a joke." }],
    },
  ],
});

console.log(response);

您也可以使用插件创建模型引用 model() 方法 :

import { anthropic } from "@genkit-ai/anthropic";

// Create model references
const claudeHaiku45 = anthropic.model("claude-haiku-4-5");
const claudeSonnet45 = anthropic.model("claude-sonnet-4-5");
const claudeOpus45 = anthropic.model("claude-opus-4-5");

// Use the model reference directly
const response = await claudeSonnet45({
  messages: [
    {
      role: "user",
      content: [{ text: "Hello!" }],
    },
  ],
});

这种办法有助于:

  • 需要原始模型访问的框架开发者
  • 单独测试模型
  • 在非Genkit 应用中使用 Genkit 模型

鸣谢

此插件以社区工作为基础 genkitx-anthropic 由Bloom Labs Inc. 编著. 它们的Apache 2.0 许可执行提供了 此软件包的基础.

贷项

此插件由 Google 维护, 并向社区确认 来自 布鲁姆实验室股份有限公司。 。 。 .

版本与发布记录

@genkit-ai/anthropic 共发布 15 个版本,首次发布于 2026/01/23;过去 12 个月发布了 15 个版本。

版本发布日期距今
0.7.0latest2026/11/0412 天前
0.6.02026/10/2225 天前
0.6.0-rc.3next2026/10/2225 天前
0.6.0-rc.22026/10/2126 天前
0.6.0-rc.12026/10/091 个月前
0.6.0-rc.02026/10/091 个月前

关于 @genkit-ai/anthropic 的常见问题

@genkit-ai/anthropic 是什么?

Genkit AI框架插件用于Anthropic API.

如何安装 @genkit-ai/anthropic?

在项目目录运行 npm install @genkit-ai/anthropic,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:genkit(^1.44.0)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@genkit-ai/anthropic 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@genkit-ai/anthropic 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@genkit-ai/anthropic 可以商用吗?

@genkit-ai/anthropic 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@genkit-ai/anthropic 的下载量有多少?

根据 npm 官方下载统计,@genkit-ai/anthropic 在 2026/10/16 – 2026/11/14 这 30 天内被下载 42,152 次,日均约 1,405 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@genkit-ai/anthropic 还在维护吗?

最新版本 0.7.0 发布于 2026/11/04(12 天前);至今共发布 15 个版本,其中过去 12 个月发布了 15 个;首次发布于 2026/01/23。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。