Configure Agent TARS

WARNING

Agent TARS 配置选项可能会随着版本更新而变化。升级 Agent TARS 版本时，请参考响应的发布日志了解潜在的配置变更。

Agent TARS 支持两种主要的配置方法：

CLI flags：适用于快速实验
Configuration files：推荐用于长期使用

这些配置方法允许你自定义 Agent TARS 行为以满足不同的需求。

CLI Flags

agent-tars --help      # view all sub commands and flags
agent-tars [...flags]  # launch Agent TARS with some flags.

更多详情请查看 CLI。

配置文件

支持的文件格式

Agent TARS 会自动在当前目录中查找以下配置文件（按优先级排序）：

agent-tars.config.ts (TypeScript，推荐)
agent-tars.config.yaml (YAML)
agent-tars.config.json (JSON)

你也可以使用 --config 参数指定一个或多个配置文件路径：

agent-tars --config ./my-config.json

TypeScript（推荐）

TypeScript 配置提供完整的类型检查和代码补全支持，使其成为最推荐的配置方法：

agent-tars.config.ts

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

export default defineConfig({
  // Model configuration
  model: {
    provider: 'anthropic',
    id: 'claude-3-7-sonnet-latest',
    apiKey: process.env.ANTHROPIC_API_KEY,
  },
  
  // Browser control mode
  browser: {
    control: 'hybrid', // 'hybrid', 'visual-grounding', 'dom'
  },

  // ... other configurations
});

JSON

agent-tars.config.json

{
  "model": {
    "provider": "anthropic",
    "id": "claude-3-7-sonnet-latest",
    "apiKey": "your-api-key-here"
  },

  "browser": {
    "control": "hybrid"
  }
}

YAML

agent-tars.config.yaml

model:
  provider: anthropic
  id: claude-3-7-sonnet-latest
  apiKey: your-api-key-here
  
browser:
  control: hybrid

多配置文件

Agent TARS 支持合并多个配置文件，后面的配置将覆盖前面的配置：

agent-tars --config ./base-config.json --config ./override.yaml

这对于管理不同环境的配置非常有用，例如基础配置和环境特定的覆盖配置。

远程配置

Agent TARS 支持从远程 URL 加载配置：

agent-tars --config https://example.com/agent-tars-config.json

这对于团队共享配置或动态配置非常有用。

#Configure Agent TARS

#CLI Flags

#配置文件

#支持的文件格式

#TypeScript（推荐）

#JSON

#YAML

#多配置文件

#远程配置