GAIA 超级特工SDK

在数秒内,而不是数周内建立GAIA-Benchmark-ready超级AI代理公司

配有18+工具和可互换供应商的生产准备超级AI代理商
建于 AI SDK v6 ToolLooopAgent & ToolSDK.ai 上 动作推理

快速启动 • 妇女 特征 • 妇女 GAIA 基准 • 妇女 文档

* 特性

为什么是GAIA探员?

我们的使命

授权开发人员在几分钟内,而不是几个月内建立世界一流的"超级AI代理".

无论是为您的产品创建生产准备的AI助手,还是在GAIA基准中竞争,GAIA Agent提供您需要的企业级基础.

节省时间: 从基础设施设置数周起 —— 三行代码

结果 : 一个世界一流的,生产准备的超级特工 对抗顶级AI系统

GAIA基准是什么?

这个 GAIA 基准 是一个综合性的评价套件,旨在测试AI代理在包括推理,搜索,代码执行,和浏览器自动化等一系列广泛任务中的能力.

📖 更多信息:GAIA

QQ 快速启动

安装

npm install @gaia-agent/sdk ai @ai-sdk/openai zod

基本用途

import { createGaiaAgent } from '@gaia-agent/sdk';

// Create the agent - reads from environment variables
const agent = createGaiaAgent();

const result = await agent.generate({
  prompt: 'Calculate 15 * 23 and search for the latest AI papers',
});

console.log(result.text);

环境设置

创建一个 .env 文件 :

# Required
OPENAI_API_KEY=sk-...

# Default providers (at least one required)
TAVILY_API_KEY=tvly-...      # Search
E2B_API_KEY=...              # Sandbox
STEEL_API_KEY=steel_live_... # Browser

📖 完整的环境变量指南

QQ 内置工具

📖 完整工具文档 –
📖 供应商比较
📖 动作 + 规划指南 新来

交换提供者

用一行切换提供者 :

import { createGaiaAgent } from '@gaia-agent/sdk';

const agent = createGaiaAgent({
  providers: {
    search: 'exa',              // Use Exa instead of Tavily
    sandbox: 'sandock',         // Use Sandock instead of E2B
    browser: 'browseruse',      // Use BrowserUse instead of Steel
  },
});

或通过环境变量设定 :

GAIA_AGENT_SEARCH_PROVIDER=exa
GAIA_AGENT_SANDBOX_PROVIDER=sandock
GAIA_AGENT_BROWSER_PROVIDER=browseruse

GAIA 基准

运行正式的GAIA基准,加强成果跟踪:

# Basic benchmark
pnpm benchmark                  # Run validation set
pnpm benchmark --limit 10       # Test with 10 tasks

# Resume interrupted runs
pnpm benchmark --resume         # Continue from checkpoint

# Filter by capability
pnpm benchmark:files            # Tasks with file attachments
pnpm benchmark:code             # Code execution tasks
pnpm benchmark:search           # Web search tasks
pnpm benchmark:browser          # Browser automation tasks

# Stream mode (real-time thinking)
pnpm benchmark:random --stream  # Watch agent think in real-time

# Wrong answers collection
pnpm benchmark:wrong            # Retry only failed tasks

QQ 错误的回答收藏

自动跟踪和重试失败的任务 :

# 1. Run benchmark (auto-creates wrong-answers.json)
pnpm benchmark --limit 20

# 2. View wrong answers
cat benchmark-results/wrong-answers.json

# 3. Retry only failed tasks
pnpm benchmark:wrong --verbose

# 4. Keep retrying until all pass
pnpm benchmark:wrong
# → "🎉 No wrong answers! All previous tasks passed."

📖 错误的答案指南
📖 恢复特性指南
📖 基准模块
📖 GAIA 设置指南 −

增强基准结果

基准结果现在包括全部任务细节:

{
  "taskId": "abc123",
  "question": "What year was X founded?",
  "level": 2,
  "files": ["image.png"],
  "answer": "1927",
  "expectedAnswer": "1927",
  "correct": true,
  "durationMs": 5234,
  "steps": 3,
  "toolsUsed": ["search", "browser"],
  "summary": {
    "totalToolCalls": 5,
    "uniqueTools": ["search", "browser", "calculator"],
    "hadError": false
  },
  "stepDetails": [ /* ... */ ]
}

容易分析和调试

基准结果

不同任务类别的最新基准业绩:

📖 见逐项任务的详细结果

说明: 基准结果在每个基准运行后自动更新.

测试

使用 Vitest 运行单元测试 :

pnpm test                # Run all tests
pnpm test:watch          # Watch mode
pnpm test:coverage       # Coverage report

📖 测试指南 –

高级用途

自定义工具

import { createGaiaAgent, getDefaultTools } from '@gaia-agent/sdk';
import { tool } from 'ai';
import { z } from 'zod';

const agent = createGaiaAgent({
  tools: {
    ...getDefaultTools(),
    weatherTool: tool({
      description: 'Get weather',
      inputSchema: z.object({ city: z.string() }),
      execute: async ({ city }) => ({ temp: 72, condition: 'sunny' }),
    }),
  },
});

工具SDK 集成

将数千项工具从 工具SDK.ai 生态系统:

import { createGaiaAgent, getDefaultTools } from '@gaia-agent/sdk';
import { ToolSDKApiClient } from 'toolsdk/api'; // npm install toolsdk

// Initialize ToolSDK client
const toolSDK = new ToolSDKApiClient({ apiKey: process.env.TOOLSDK_AI_API_KEY });

// Load tools from ToolSDK packages
const emailTool = await toolSDK.package('@toolsdk.ai/mcp-send-email', {
  RESEND_API_KEY: process.env.RESEND_API_KEY,
}).getAISDKTool("send-email");

const agent = createGaiaAgent({
  tools: {
    ...getDefaultTools(),
    emailTool
  },
});

const result = await agent.generate({
  prompt: 'Help me search for the latest AI news and send it to [email protected]',
});

📖 工具SDK 包件 −

扩展 GAIA 代理类

import { GAIAAgent } from '@gaia-agent/sdk';

class ResearchAgent extends GAIAAgent {
  constructor() {
    super({
      instructions: 'Research assistant specialized in AI papers',
      additionalTools: { /* custom tools */ },
    });
  }
}

📖 高级使用指南
📖 API 参考

页:1

捐款

这个项目使用国家防范机制自动出版。 当更改合并为 main数字 :

1. QQ 测试自动运行
2. 版本出错到下个补丁(如:0.1.0-0.1.1)
3. QQ 更改日志创建于 changelog/
4. 向国家预防机制公布
5. 已创建 Git 标签

手动版本的出错(小/主要)见 文档/NPM PUBLISH SETUP.md。 。 。 .

许可证

Apache 许可证 2.0