#快速开始

#介绍

#先决条件

#Node.js

Agent TARS CLI 需要 Node.js 作为运行时，你需要安装 Node.js >= 22 版本，推荐使用 Node.js LTS 版本。

使用以下命令检查当前 Node.js 版本：

node -v

如果当前环境中没有安装 Node.js，或者安装的版本过低，你可以使用 nvm 进行安装。

以下是通过 nvm 安装的示例：

# 安装 Node.js LTS
nvm install --lts
# 切换到 Node.js LTS
nvm use --lts

#Chrome

默认情况下，Agent TARS CLI 启动并控制你的 本地浏览器，你需要安装 Chrome。

#安装

安装最新版本：

npm install @agent-tars/cli@latest -g

TIP

Agent TARS 正在快速开发中，其版本迭代遵循语义化版本。你可以使用 @next 安装当前的测试版本：

npm install @agent-tars/cli@next -g

当前版本信息：

标签	版本
Latest
Next

#快速开始

#1. 选择模型

Agent TARS 框架设计了一个 Model Provider 机制，允许你自由地使用不同的模型。

#概述

目前 Agent TARS 的模型兼容性状态如下：

#Seed 1.5 VL ByteDance

Seed1.5-VL 是一个强大且高效的视觉语言基础模型，设计用于高级通用多模态理解和推理，Seed1.5-VL 已部署在火山引擎上，模型 ID 为 doubao-1-5-thinking-vision-pro-250428，一旦你获得了 API_KEY，你可以使用下述命令启动 Agent TARS：

agent-tars \
--provider volcengine \
--model doubao-1-5-thinking-vision-pro-250428 \
--apiKey {apiKey}

#claude-3.7-sonnet Anthropic

Claude 3.7 Sonnet 是 Anthropic 在 2025 年 2 月发布的首个具有混合推理能力的 Claude 模型。一旦你获得了 API_KEY，你可以快速启动 Agent TARS：

agent-tars \
--provider anthropic \
--model claude-3-7-sonnet-latest \
--apiKey {apiKey}

#gpt-4o OpenAI

GPT-4o 是 OpenAI 推出的高智能旗舰模型，一旦你获得了 API_KEY，你可以用单个命令启动：

agent-tars \
--provider openai \
--model gpt-4o \
--apiKey {apiKey}

有关模型支持的更多详情，请查看 Model Provider。

#2. 开始你的第一个任务

当你使用 agent-tars 启动时：

agent-tars [...flags]

你将在控制台中看到以下输出：

在浏览器中打开控制台中的链接：http://localhost:8888 ，你可以看到 Web UI：

输入这个 Prompt：

Tell me the top 10 for Humanity's Last Exam

恭喜 🎉！此时，你已成功启动 Agent TARS！

#3. 创建 Global Workspace

虽然你可以使用 CLI 快速启动，但我们仍然建议创建一个 Global Workspace。这允许你通过配置文件维护配置，以及存储你的文件系统。让我们开始：

agent-tars workspace --init   # 按照提示完成创建
agent-tars workspace --open   # 打开工作区

接下来，你可以在 Global Workspace 中使用 TypeScript 维护配置，而不是处理 CLI 参数，并且受益于完整的类型检查：

// agent-tars.config.ts
import { defineConfig } from '@agent-tars/interface';

/**
 * @see {@link https://beta.agent-tars.com/api/config/agent.html}
 */
export default defineConfig({
  model: {
    provider: 'volcengine',
    // ... 其他配置
  },
  // ... 其他配置
});

有关完整配置详情，请前往配置，有关 Workspace 的使用细节，请前往Workspace。

#下一步