Neurolink Demo

NeuroLink AI工具包 - 交互式演示

• \🚀 下一步行动\
• 📞 支持

🧠 表示“大脑”或“思考”。 完整的工作演示，展示与9大主要AI供应商集成的NeuroLink SDK

🚀 快速入门

1. 安装依赖项

cd neurolink-demo
pnpm install

2. 配置环境

复制 .env.example to .env 并添加您的API密钥：

cp .env.example .env

编辑 .env 使用您的凭据：

# OpenAI Configuration
OPENAI_API_KEY=sk-your-openai-key-here
OPENAI_MODEL=gpt-4o

# AWS Bedrock Configuration
AWS_ACCESS_KEY_ID=your_aws_access_key
AWS_SECRET_ACCESS_KEY=your_aws_secret_key
AWS_SESSION_TOKEN=your-session-token  # If using temporary credentials
AWS_REGION=us-east-2
BEDROCK_MODEL=arn:aws:bedrock:us-east-2:225681119357:inference-profile/us.anthropic.claude-3-7-sonnet-20250219-v1:0

# Google Vertex AI Configuration (choose one authentication method)
GOOGLE_VERTEX_PROJECT=your_project_id
GOOGLE_VERTEX_LOCATION=us-east5

# Method 1: Service Account File (Recommended for Production)
GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json

# Method 2: Service Account JSON String (Good for Containers/Cloud)
# GOOGLE_SERVICE_ACCOUNT_KEY={"type":"service_account","project_id":"your-project",...}

# Method 3: Individual Environment Variables (Good for CI/CD)
# GOOGLE_AUTH_CLIENT_EMAIL=service-account@project.iam.gserviceaccount.com
# GOOGLE_AUTH_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\nMIIE...\n-----END PRIVATE KEY-----"

# Google AI Studio Configuration
GOOGLE_AI_API_KEY=AIza-your-google-ai-api-key
GOOGLE_AI_MODEL=gemini-2.5-pro

# Anthropic Configuration
ANTHROPIC_API_KEY=sk-ant-your-anthropic-key
ANTHROPIC_MODEL=claude-3-5-sonnet-20241022

# Azure OpenAI Configuration
AZURE_OPENAI_API_KEY=your_azure_api_key
AZURE_OPENAI_ENDPOINT=https://your-resource.openai.azure.com
AZURE_OPENAI_DEPLOYMENT=your-deployment-name
AZURE_MODEL=gpt-4o

# Hugging Face Configuration
HUGGINGFACE_API_KEY=hf_your_huggingface_token
HUGGINGFACE_MODEL=microsoft/DialoGPT-medium

# Ollama Configuration (Local AI)
OLLAMA_BASE_URL=http://localhost:11434
OLLAMA_MODEL=llama2

# Mistral AI Configuration
MISTRAL_API_KEY=your_mistral_api_key
MISTRAL_MODEL=mistral-small

# Demo Configuration
PORT=9876
DEFAULT_PROVIDER=openai
ENABLE_STREAMING=true
ENABLE_FALLBACK=true

3. 启动演示服务器

pnpm start

4. 打开演示界面

参观 http://localhost:9876 翻译为中文是：“本地主机的9876端口”。不过，通常我们不会直接这样翻译网址，而是根据上下文或用途来解释其意义。例如，可以说“访问本地开发服务器的URL是http://localhost:9876” 在您的浏览器中

🎯 你将看到的内容

交互式网页界面

• 🚀 基本示例提供者测试、模式验证、性能基准测试
• 💼 商业应用场景邮件生成、数据分析、文档摘要
• 🎨 创意工具创意写作、翻译、内容创意
• 👨‍💻 开发者工具代码生成、API文档、调试分析
• 📊 监控使用分析和提供商状态

真实人工智能集成

• 使用多个AI供应商进行实时文本生成
• 自动选择最佳可用供应商
• 实时性能指标
• 带有模式验证的结构化数据生成
• 跨业务和创意领域的互动示例

📋 可用的API端点

核心端点

• GET / - 交互式演示网页界面
• GET /api/status - 提供者配置和健康检查
• POST /api/generate - 带提供商选择的文本生成
• POST /api/schema - 带验证的结构化数据生成
• POST /api/benchmark - 不同供应商之间的性能比较

商业用例

• POST /api/business/email - 专业邮件生成
• POST /api/business/analyze-data - CSV数据分析与见解
• POST /api/business/summarize - 文档摘要

创意工具

• POST /api/creative/writing - 创意内容生成
• POST /api/creative/translate - 多语言翻译
• POST /api/creative/ideas - 为不同格式的内容构思创意

开发者工具

• POST /api/developer/code - 跨语言代码生成
• POST /api/developer/api-doc API文档生成
• POST /api/developer/debug - 错误分析和调试协助

分析（或数据分析）

• GET /api/analytics - 使用统计和性能指标

🖥️ CLI 集成示例

使用NeuroLink CLI与演示服务器

# Start the demo server in one terminal
pnpm start

# In another terminal, use the CLI to interact with the same providers:

# Basic text generation using CLI
npx @neuroslink/neurolink generate "Write a haiku about programming"

# Compare with server API
curl -X POST http://localhost:9876/api/generate \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Write a haiku about programming", "provider": "auto"}'

# Check provider status with CLI
npx @neuroslink/neurolink status --verbose

# Batch process multiple prompts with CLI
echo -e "Explain AI\nWrite a poem\nGenerate code" > prompts.txt
npx @neuroslink/neurolink batch prompts.txt --output cli-results.json

# Stream real-time generation
npx @neuroslink/neurolink stream "Tell me a story about robots"

CLI与API的对比

# CLI approach (simple, scriptable)
npx @neuroslink/neurolink generate "Hello world" --format json

# API approach (programmatic integration)
curl -X POST http://localhost:9876/api/generate \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Hello world", "provider": "auto"}'

🧪 使用 curl 进行测试

基础文本生成

curl -X POST http://localhost:9876/api/generate \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Write a haiku about artificial intelligence", "provider": "auto"}'

模式验证

curl -X POST http://localhost:9876/api/schema \
  -H "Content-Type: application/json" \
  -d '{"type": "user-profile"}'

商业电子邮件生成

curl -X POST http://localhost:9876/api/business/email \
  -H "Content-Type: application/json" \
  -d '{"type": "marketing", "context": "New AI product launch"}'

性能基准

curl -X POST http://localhost:9876/api/benchmark \
  -H "Content-Type: application/json" \
  -d '{}'

提供商状态检查

curl http://localhost:9876/api/status

🎬 完整的视觉文档生态系统

🌐（这个符号本身没有直接的中文翻译，它通常代表“互联网”或“全球网络”的概念，在中文中可以表述为“🌐 互联网”或“🌐 全球网络”，但具体翻译时往往根据上下文省略符号，直接用文字描述其含义。） 网络演示视觉内容 ✅

📸 交互式网页界面截图

🎥 演示视频 _(5,681+个真实AI生成的标记)_

• 基本示例 - 文本生成，俳句创作，讲故事（529个标记）
• 商业用例 - 邮件生成、分析、摘要（1,677个标记）
• 创意工具 - 故事、翻译、创意想法（1,174个词元）
• 开发者工具 - React代码，API文档，调试帮助（2,301个标记）
• 监测与分析 - 实时提供商状态和性能

🖥️ 电脑 CLI集成视觉内容 ✅

📸 专业的命令行界面（CLI）截图 _（最新更新：2025年6月10日）_

🎥 CLI 演示视频 _（实际命令执行）_

• CLI 概述 - 帮助，状态，提供商选择命令
• 提供商状态 - 提供者连接性测试
• 文本生成 - 使用不同供应商进行文本生成
• 自动选择 - 自动提供商选择
• 流媒体（或直播） - 实时流媒体
• 高级功能 - 详细的诊断信息和提供者选项

🔧 修理工具或螺丝刀的符号，常用于表示需要修理或调整的物品或情境。 MCP（模型上下文协议）集成 ✅

📸 MCP CLI 截图 _（生成于2025年1月10日）_

🎥 MCP演示视频 _（与真实MCP服务器集成）_

• 服务器管理演示 - 安装、配置和测试MCP服务器（约45秒）

注正在开发额外的MCP演示视频。服务器管理演示展示了MCP的核心集成功能。

MCP特性展示了扩展NeuroLink功能的外部服务器连接性、工具发现以及工作流集成能力。

🎯（靶心） 完整的视觉生态系统优势

• ✅ 无需安装 - 在安装前查看所有功能的运行情况
• ✅ 真实的人工智能内容 - 所有截图和视频均展示的是实际的人工智能生成内容
• ✅ 专业品质 - 1920x1080分辨率，适合文档记录
• ✅ 全面覆盖 - 每个主要功能都进行了视觉化记录
• ✅ CLI + Web 集成 - 两个接口均附有全面文档
• ✅ 生产验证 - 展示了实际使用模式

📊 表格/数据图表 视觉内容指标

• 📸 总截图数11次专业捕获（网页：6次，命令行界面：5次）
• 🎥 总视频数10个演示视频（网页版：5个，命令行界面版：5个）
• 🤖 由AI生成的内容视频创建过程中使用了5,681+个标记（或代币）
• 📁 组织具有描述性名称的结构化文件夹
• 🎨 质量全程专业1920x1080分辨率

🧪 测试指南

测试类别的概述

1. 提供者配置测试

目的验证所有提供商是否已正确配置

pnpm run test:config

2. API 集成测试

目的使用真实凭据测试实际的API调用

pnpm run test:api

3. 降级机制测试

目的验证自动提供商回退功能

pnpm run test:fallback

4. 性能基准测试

目的比较各供应商的响应时间

pnpm run test:performance

5. 流式测试

目的测试实时流媒体功能

pnpm run test:streaming

综合测试套件

运行所有测试

pnpm test

单项测试类别

# Configuration validation
pnpm run test:config

# API functionality
pnpm run test:api

# Error handling
pnpm run test:errors

# Performance metrics
pnpm run test:performance

# Web interface
pnpm run test:web

测试用例描述

1. 提供者配置测试

• ✅ 环境变量验证
• API凭证验证
• ✅ 提供者初始化
• ✅ 认证方法检测

2. API集成测试

• ✅ 使用真实提示进行文本生成
• ✅ 响应格式验证
• ✅ 使用统计验证
• ✅ 针对特定模型的参数测试

3. 错误处理测试

• ✅ 无效凭证处理
• ✅ 网络超时场景
• ✅ 限流响应
• ✅ 异常请求处理

4. 流式测试

• ✅ 实时文本流
• ✅ 流中断处理
• ✅ 数据块组装验证
• ✅ 连接稳定性测试

5. 性能测试

• ✅ 响应时间测量
• ✅ 供应商对比指标
• ✅ 并发请求处理
• ✅ 内存使用监控

自定义测试场景

使用特定提供商进行测试

# Test OpenAI only
PROVIDER=openai pnpm test

# Test Bedrock only
PROVIDER=bedrock pnpm test

# Test Vertex AI only
PROVIDER=vertex pnpm test

使用自定义提示进行测试

# Test with long prompts
PROMPT_TYPE=long pnpm test

# Test with complex prompts
PROMPT_TYPE=complex pnpm test

# Test with multilingual prompts
PROMPT_TYPE=multilingual pnpm test

📡 API 文档

基本URL

http://localhost:9876

终点（或结局指标）

GET /

描述交互式网页界面 回应HTML演示页面

GET /api/status

描述提供者状态和配置 回应：

{
  "timestamp": "2025-06-04T10:17:00Z",
  "providers": {
    "openai": {
      "available": true,
      "model": "gpt-4o",
      "configured": true
    },
    "bedrock": {
      "available": true,
      "model": "anthropic.claude-3-sonnet-20240229-v1:0",
      "configured": true
    },
    "vertex": {
      "available": true,
      "model": "gemini-2.5-pro",
      "configured": true
    }
  },
  "bestProvider": "bedrock"
}

POST（邮政服务/发布） /api/generate

描述使用指定的提供商生成文本 请求好的

{
  "provider": "openai|bedrock|vertex|auto",
  "prompt": "Your prompt here",
  "maxTokens": 500,
  "temperature": 0.7
}

回应:

{
  "success": true,
  "content": "Generated text response",
  "provider": "openai",
  "model": "gpt-4o",
  "responseTime": 1250,
  "usage": {
    "promptTokens": 15,
    "completionTokens": 42,
    "totalTokens": 57
  }
}

POST（邮政服务） /api/stream

描述实时流式文本生成 请求与……相同 /api/generate 回应服务器发送事件流

POST（邮寄） /api/test-fallback

描述测试自动提供商回退功能 请求：

{
  "prompt": "Test prompt for fallback"
}

回应:

{
  "timestamp": "2025-06-04T10:17:00Z",
  "attempts": [
    {
      "provider": "openai",
      "status": "failed",
      "error": "Rate limit exceeded"
    },
    { "provider": "bedrock", "status": "success", "responseTime": 890 }
  ],
  "success": true,
  "finalResult": {
    "provider": "bedrock",
    "content": "Generated content"
  }
}

POST（邮政/帖子/发布） /api/benchmark

描述不同供应商之间的性能对比 回应:

{
  "timestamp": "2025-06-04T10:17:00Z",
  "results": {
    "openai": {
      "success": true,
      "responseTime": 1200,
      "model": "gpt-4o",
      "contentLength": 156
    },
    "bedrock": {
      "success": true,
      "responseTime": 890,
      "model": "anthropic.claude-3-sonnet-20240229-v1:0",
      "contentLength": 142
    },
    "vertex": {
      "success": false,
      "error": "Authentication failed"
    }
  }
}

POST（邮政） /api/schema

描述测试结构化输出生成 回应:

{
  "success": true,
  "structuredData": {
    "name": "Alice Johnson",
    "age": 28,
    "occupation": "Software Engineer",
    "hobbies": ["reading", "hiking", "photography"]
  },
  "provider": "auto-selected"
}

🔧 故障排除

提供者配置问题

OpenAI 配置

• 确保从https://platform.openai.com/api-keys获取有效的API密钥
• 检查账户是否有余额以及是否可以访问GPT-4
• 验证无速率限制或使用限制

AWS Bedrock 设置

• 配置具有Bedrock访问权限的AWS凭证
• 确保账户拥有Claude模型的权限
• 为Anthropic模型使用完整的推理配置文件ARN格式
• 检查AWS区域配置是否与模型可用性相匹配

Google Vertex AI 设置

• 在Google Cloud Console中启用Vertex AI API
• 配置具有适当权限的服务帐户
• 确保项目计费已启用
• 验证您所在地区的模型访问权限

常见错误信息

“提供商不可用”

• 检查API密钥配置
• 验证网络连接
• 确认账户权限

“指定了无效的模型”

• 为每个提供商使用正确的模型名称
• 检查您所在地区的模型可用性
• 验证账户对特定模型的访问权限

“自动选择失败”

• 确保至少有一个提供者已正确配置
• 检查配置中的提供者优先级顺序
• 验证回退机制已启用

性能问题

响应时间慢

• 检查网络连接
• 验证提供商区域设置
• 考虑换用更快的服务提供商进行测试

高代币使用率

• 调整maxTokens参数
• 使用更具体的提示
• 为重复请求实现响应缓存

📊 演示统计追踪

该演示包含内置的分析追踪功能：

• 请求计数总API调用次数
• 代币使用情况累积代币消耗量
• 供应商表现响应时间和成功率
• 错误追踪失败的请求和错误模式
• 使用模式最受欢迎的终端节点和功能

🎯 生产方面的考虑因素

这个演示展示了可用于生产的模式：

安全

• 环境变量配置
• 错误处理和验证
• 速率限制方面的考虑
• API密钥管理

演出

• 提供商回退机制
• 响应缓存策略
• 最优模型选择
• 代币使用优化

监测

• 使用分析和报告
• 提供商健康检查
• 错误记录和警报通知
• 性能指标跟踪

🌟 展示的关键特性

1. 多供应商支持（9家供应商）

• OpenAI（开放人工智能研究所） - GPT-4o 和 GPT-4-turbo 模型
• 亚马逊Bedrock - 通过AWS提供的Claude 3模型
• Google Vertex AI（谷歌顶点人工智能） - 双子座Pro模型
• Google AI Studio（谷歌人工智能工作室） - Gemini 1.5 Pro，提供免费层级
• Anthropic（公司名，可译为“安萨提克”或根据具体语境保留原名） - Claude 3.5 Sonnet 直接API
• Azure OpenAI（注：此处“Azure”与“OpenAI”均为专有名词，直接保留原样翻译，若需结合上下文或品牌宣传语等进行意译，则需具体情境来确定） - 企业级Azure部署
• Hugging Face（通常翻译为“拥抱脸”，但在此上下文中，它是一个公司或平台的名称，直接音译为“哈ugging Face”或保持原英文名称更为常见，以避免歧义） - 10万+开源模型
• Ollama（注：这是一个专有名词，通常不直接翻译，但根据语境可理解为“奥拉玛”或保持原样作为项目/技术名称） - 本地人工智能，完全隐私保护
• Mistral AI（米斯特拉尔人工智能） - 符合欧洲GDPR标准的人工智能
• 跨所有提供商的智能自动选择

2. 综合用例

• 商业应用（电子邮件、数据分析、总结）
• 创意工具（写作、翻译、创意构思）
• 开发者实用工具（代码生成、文档编写、调试）
• 高级功能（模式验证、批处理）

3. 生产就绪模式

• 强大的错误处理
• 性能监控
• 使用分析
• 提供商回退机制

4. 互动学习

• 实时人工智能生成
• 即时反馈和结果
• 性能对比
• 最佳实践示例

🚀 接下来步骤

1. 运行演示启动服务器并探索所有功能
2. 使用真实API进行测试配置您的凭据并查看实时AI生成效果
3. 检查代码模式审查服务器实现以获取集成示例
4. 记录视觉内容用于创建屏幕截图和视频演示
5. 集成SDK将学到的模式应用到自己的项目中

📞 支持

如果您遇到问题：

1. 查看上面的故障排除部分
2. 验证您的环境配置
3. 使用状态端点测试单个提供商
4. 查看控制台日志以获取详细的错误信息
5. 确保所有依赖项都已正确安装

______________________________________________________________________

🧠 NeuroLink SDK 演示 - 通过展示与实际应用场景及生产就绪模式的整合，彰显统一AI提供商的强大实力。