使用 Anthropic Claude 构建 Teams.ai 应用

使用 @youdotcom-oss/teams-anthropic 将 Claude 模型（Opus、Sonnet、Haiku）集成到 Microsoft Teams.ai 应用中。可选集成 You.com MCP 服务以实现网页搜索与内容提取功能。

选择您的路径

路径 A：基础配置（推荐用于快速上手）

• 在 Teams.ai 中使用 Anthropic Claude 模型
• 支持聊天、流式响应、函数调用
• 无需额外依赖

路径 B：集成 You.com MCP（适用于需要网页搜索能力的场景）

• 包含路径 A 的全部功能
• 通过 You.com 实现网页搜索与内容提取
• 实时获取最新信息

决策点

请确认：您的 Teams 应用是否需要网页搜索与内容提取功能？

• 否 → 使用 路径 A：基础配置（更简单、启动更快）
• 是 → 使用 路径 B：集成 You.com MCP

路径 A：基础配置

在 Teams.ai 应用中使用 Anthropic Claude 模型，无需引入额外依赖。

A1. 安装包

npm install @youdotcom-oss/teams-anthropic @anthropic-ai/sdk @microsoft/teams.ai

A2. 获取 Anthropic API 密钥

从 console.anthropic.com 获取您的 API 密钥

# 添加至 .env 文件
ANTHROPIC_API_KEY=your-anthropic-api-key

A3. 确认：新建应用还是已有应用？

• 新建 Teams 应用：直接使用下方完整模板
• 已有应用：将 Claude 模型添加至现有配置中

A4. 基础模板

适用于 NEW 应用：

import { App } from '@microsoft/teams.apps';
import { AnthropicChatModel, AnthropicModel } from '@youdotcom-oss/teams-anthropic';

if (!process.env.ANTHROPIC_API_KEY) {
  throw new Error('ANTHROPIC_API_KEY environment variable is required');
}

const model = new AnthropicChatModel({
  model: AnthropicModel.CLAUDE_SONNET_4_5,
  apiKey: process.env.ANTHROPIC_API_KEY,
  requestOptions: {
    max_tokens: 2048,
    temperature: 0.7,
  },
});

const app = new App();

app.on('message', async ({ send, activity }) => {
  await send({ type: 'typing' });

  const response = await model.send(
    { role: 'user', content: activity.text }
  );

  if (response.content) {
    await send(response.content);
  }
});

app.start().catch(console.error);

适用于 EXISTING 应用：

在您已有的 import 语句中添加：

import { AnthropicChatModel, AnthropicModel } from '@youdotcom-oss/teams-anthropic';

替换您当前使用的模型实例：

const model = new AnthropicChatModel({
  model: AnthropicModel.CLAUDE_SONNET_4_5,
  apiKey: process.env.ANTHROPIC_API_KEY,
});

A5. 选择您的模型

// 最强能力 —— 推荐用于复杂任务
AnthropicModel.CLAUDE_OPUS_4_5

// 智能性与响应速度均衡（推荐）
AnthropicModel.CLAUDE_SONNET_4_5

// 快速高效
AnthropicModel.CLAUDE_HAIKU_3_5

A6. 测试基础配置

npm start

在 Teams 中发送一条消息，验证 Claude 是否正常响应。

路径 B：集成 You.com MCP

为基于 Claude 的 Teams 应用添加网页搜索与内容提取能力。

B1. 安装包

npm install @youdotcom-oss/teams-anthropic @anthropic-ai/sdk @microsoft/teams.ai @microsoft/teams.mcpclient

B2. 获取 API 密钥

• Anthropic API 密钥：console.anthropic.com
• You.com API 密钥：you.com/platform/api-keys

# 添加至 .env 文件
ANTHROPIC_API_KEY=your-anthropic-api-key
YDC_API_KEY=your-you-com-api-key

B3. 确认：新建应用还是已有应用？

• 新建 Teams 应用：直接使用下方完整模板
• 已有应用：在现有 Claude 配置基础上添加 MCP 集成

B4. MCP 模板

适用于 NEW 应用：

import { App } from '@microsoft/teams.apps';
import { ChatPrompt } from '@microsoft/teams.ai';
import { ConsoleLogger } from '@microsoft/teams.common';
import { McpClientPlugin } from '@microsoft/teams.mcpclient';
import {
  AnthropicChatModel,
  AnthropicModel,
  getYouMcpConfig,
} from '@youdotcom-oss/teams-anthropic';

// 校验环境变量
if (!process.env.ANTHROPIC_API_KEY) {
  throw new Error('ANTHROPIC_API_KEY environment variable is required');
}

if (!process.env.YDC_API_KEY) {
  throw new Error('YDC_API_KEY environment variable is required');
}

// 配置日志记录器
const logger = new ConsoleLogger('mcp-client', { level: 'info' });

// 创建集成 MCP 的 prompt
const prompt = new ChatPrompt(
  {
    instructions: 'You are a helpful assistant with access to web search and content extraction. Use these tools to provide accurate, up-to-date information.',
    model: new AnthropicChatModel({
      model: AnthropicModel.CLAUDE_SONNET_4_5,
      apiKey: process.env.ANTHROPIC_API_KEY,
      requestOptions: {
        max_tokens: 2048,
      },
    }),
  },
  [new McpClientPlugin({ logger })],
).usePlugin('mcpClient', getYouMcpConfig());

const app = new App();

app.on('message', async ({ send, activity }) => {
  await send({ type: 'typing' });

  const result = await prompt.send(activity.text);
  if (result.content) {
    await send(result.content);
  }
});

app.start().catch(console.error);

适用于已集成 Claude 的 EXISTING 应用：

若您已完成路径 A 的配置，请按以下步骤添加 MCP 集成：

1. 安装 MCP 依赖：

   npm install @microsoft/teams.mcpclient
   

2. 添加导入语句：

   import { ChatPrompt } from '@microsoft/teams.ai';
   import { ConsoleLogger } from '@microsoft/teams.common';
   import { McpClientPlugin } from '@microsoft/teams.mcpclient';
   import { getYouMcpConfig } from '@youdotcom-oss/teams-anthropic';
   

3. 校验 You.com API 密钥：

   if (!process.env.YDC_API_KEY) {
     throw new Error('YDC_API_KEY environment variable is required');
   }
   

4. 用 ChatPrompt 替换原有模型配置：

   const logger = new ConsoleLogger('mcp-client', { level: 'info' });
   
   const prompt = new ChatPrompt(
     {
       instructions: 'Your instructions here',
       model: new AnthropicChatModel({
         model: AnthropicModel.CLAUDE_SONNET_4_5,
         apiKey: process.env.ANTHROPIC_API_KEY,
       }),
     },
     [new McpClientPlugin({ logger })],
   ).usePlugin('mcpClient', getYouMcpConfig());
   

5. 使用 prompt.send() 替代 model.send()：

   const result = await prompt.send(activity.text);
   

B5. 测试 MCP 集成

npm start

向 Claude 提出一个需借助网页搜索才能回答的问题，例如：

• “当前人工智能领域有哪些最新进展？”
• “搜索 React 官方文档”
• “提取 https://example.com 的网页内容”

可用的 Claude 模型

高级功能

流式响应

const response = await model.send(
  { role: 'user', content: 'Write a short story' },
  {
    onChunk: async (delta) => {
      // 每个 token 到达时立即流式输出
      process.stdout.write(delta);
    },
  }
);

函数调用

const response = await model.send(
  { role: 'user', content: 'What is the weather in San Francisco?' },
  {
    functions: {
      get_weather: {
        description: 'Get the current weather for a location',
        parameters: {
          location: { type: 'string', description: 'City name' },
        },
        handler: async (args: { location: string }) => {
          // 此处填入您的 API 调用逻辑
          return { temperature: 72, conditions: 'Sunny' };
        },
      },
    },
  }
);

对话记忆

import { LocalMemory } from '@microsoft/teams.ai';

const memory = new LocalMemory();

// 首条消息
await model.send(
  { role: 'user', content: 'My name is Alice' },
  { messages: memory }
);

// 第二条消息 —— Claude 将记住上下文
const response = await model.send(
  { role: 'user', content: 'What is my name?' },
  { messages: memory }
);
// 返回结果："Your name is Alice."

验证清单

路径 A 清单

• 已安装包：@youdotcom-oss/teams-anthropic
• 已设置环境变量：ANTHROPIC_API_KEY
• 已通过 AnthropicChatModel 配置模型
• 已选定模型（Opus / Sonnet / Haiku）
• 已使用基础消息测试应用

路径 B 清单

• 已完成路径 A 所有项目
• 已安装额外包：@microsoft/teams.mcpclient
• 已设置环境变量：YDC_API_KEY
• 日志记录器已配置
• 已通过 getYouMcpConfig() 配置 ChatPrompt
• 已使用网页搜索类查询测试应用

常见问题

路径 A 相关问题

“Cannot find module @youdotcom-oss/teams-anthropic”

npm install @youdotcom-oss/teams-anthropic @anthropic-ai/sdk

“ANTHROPIC_API_KEY environment variable is required”

• 密钥获取地址：https://console.anthropic.com/
• 在 .env 文件中添加：ANTHROPIC_API_KEY=your-key-here

“Invalid model identifier”

• 请使用枚举值：AnthropicModel.CLAUDE_SONNET_4_5
• 请勿使用字符串字面量：'claude-sonnet-4-5-20250929'

路径 B 相关问题

“YDC_API_KEY environment variable is required”

• 密钥获取地址：https://you.com/platform/api-keys
• 在 .env 文件中添加：YDC_API_KEY=your-key-here

“MCP connection fails”

• 请访问 https://you.com/platform/api-keys 确认 API 密钥有效
• 检查网络连接状态
• 查阅日志输出获取详细错误信息

“Cannot find module @microsoft/teams.mcpclient”

npm install @microsoft/teams.mcpclient

getYouMcpConfig() 工具函数

自动配置 You.com MCP 连接：

• URL：https://api.you.com/mcp
• 认证方式：使用 YDC_API_KEY 生成的 Bearer Token
• User-Agent：包含包版本号用于遥测统计

// 方式一：使用环境变量（推荐）
getYouMcpConfig()

// 方式二：自定义 API 密钥
getYouMcpConfig({ apiKey: 'your-custom-key' })

资源

• 包源码：https://github.com/youdotcom-oss/dx-toolkit/tree/main/packages/teams-anthropic
• You.com MCP 文档：https://documentation.you.com/developer-resources/mcp-server
• Anthropic API 控制台：https://console.anthropic.com/
• You.com API 密钥管理：https://you.com/platform/api-keys