Cấu hình

Tìm hiểu cách cấu hình TOSE CLI theo nhu cầu của bạn.

File cấu hình

TOSE CLI lưu trữ cấu hình trong file JSON tại:

~/.tose/config.json

Cấu trúc

{
  "apiKey": "tose_sk_xxxxxxxxxxxxx",
  "workspaceId": "ws_123456",
  "baseUrl": "https://api.tose.sh"
}

Các trường

Trường	Kiểu	Mô tả	Bắt buộc
apiKey	string	TOSE API key	Có
workspaceId	string	ID workspace mặc định	Không
baseUrl	string	URL API cơ sở	Không

API Key

Lấy API Key

1. Đăng nhập vào TOSE Dashboard
2. Điều hướng đến Settings > API Keys
3. Nhấp Create New API Key
4. Sao chép key (bắt đầu bằng tose_sk_)

Thiết lập API Key

Qua gợi ý tương tác

tose up
# Nhập API key khi được nhắc

Qua cấu hình thủ công

mkdir -p ~/.tose
cat > ~/.tose/config.json << 'EOF'
{
  "apiKey": "tose_sk_your_key_here"
}
EOF

Bảo mật

1. Không commit key

   # .gitignore
   .env
   .tose/

2. Sử dụng biến môi trường

   export TOSE_API_KEY="tose_sk_xxxxx"

3. Rotate key thường xuyên

   • Tạo key mới mỗi 90 ngày

Cấu hình Workspace

Workspace mặc định

Đặt workspace mặc định để bỏ qua bước chọn:

{
  "apiKey": "tose_sk_xxxxx",
  "workspaceId": "ws_123456"
}

Xóa Workspace

rm ~/.tose/config.json
tose up  # Sẽ nhắc lại

Custom API URL

Ghi đè URL API mặc định:

Qua file cấu hình

{
  "apiKey": "tose_sk_xxxxx",
  "baseUrl": "https://custom-api.tose.sh"
}

Qua biến môi trường

export TOSE_API_URL="https://custom-api.tose.sh"
tose up

Quản lý cấu hình

Xem cấu hình hiện tại

cat ~/.tose/config.json

Sao lưu cấu hình

cp ~/.tose/config.json ~/.tose/config.json.backup

Reset cấu hình

rm ~/.tose/config.json
tose up  # Tạo cấu hình mới

Nhiều cấu hình

Cho nhiều tài khoản:

# Lưu cấu hình
cp ~/.tose/config.json ~/.tose/config.personal.json
cp ~/.tose/config.json ~/.tose/config.work.json

# Chuyển đổi cấu hình
cp ~/.tose/config.work.json ~/.tose/config.json

Khắc phục sự cố

File cấu hình không tìm thấy

mkdir -p ~/.tose

Lỗi quyền

chmod 700 ~/.tose
chmod 600 ~/.tose/config.json

JSON không hợp lệ

Xác thực JSON:

cat ~/.tose/config.json | python -m json.tool

API Key không hoạt động

1. Xác minh key bắt đầu bằng tose_sk_
2. Kiểm tra key chưa bị thu hồi
3. Thử tạo key mới

Cấu hình nâng cao

CI/CD

Ví dụ cho GitHub Actions:

- name: Setup TOSE Config
  env:
    TOSE_API_KEY: ${{ secrets.TOSE_API_KEY }}
  run: |
    mkdir -p ~/.tose
    echo "{\"apiKey\":\"$TOSE_API_KEY\"}" > ~/.tose/config.json

Schema cấu hình

interface ToseConfig {
  // Bắt buộc: API key
  apiKey: string

  // Tùy chọn: ID workspace mặc định
  workspaceId?: string

  // Tùy chọn: Custom API base URL
  baseUrl?: string
}

Tài liệu liên quan

• Cài đặt
• Bắt đầu
• Biến môi trường
• Xác thực API