TeamDay.ai
← Docs

TeamDay をはじめる

TeamDay へようこそ！このクイックスタートガイドでは、約 15 分で動作開始します。終了すると、以下を行います：

  • ✅ 認証付き TeamDay アカウント
  • ✅ 最初の Personal Access Token (PAT)
  • ✅ 最初の API 呼び出しを実行
  • ✅ 最初の AI エージェントを作成

目次

ステップ 1: サインアップ

TeamDay に登録

オプション A: Google でサインアップ

  1. https://us.teamday.ai にアクセス
  2. 「Google でサインアップ」 をクリック
  3. Google アカウントを選択
  4. TeamDay がプロフィールにアクセスすることを認可

オプション B: GitHub でサインアップ

  1. https://us.teamday.ai にアクセス
  2. 「GitHub でサインアップ」 をクリック
  3. TeamDay アプリケーションを認可
  4. リクエストされた権限を付与

オプション C: メールでサインアップ

  1. https://us.teamday.ai にアクセス
  2. 「メールでサインアップ」 をクリック
  3. メールアドレスを入力
  4. 安全なパスワードを作成 (最小 8 文字)
  5. メールアドレスを確認

Screenshot

プロフィールを完成

サインアップ後、プロフィールを完成するよう求められます：

  1. 名前 - フルネーム
  2. 会社 (オプション) - 組織名
  3. 職務 (オプション) - 職務経歴書または職務

「続行」 をクリックして進みます。

Screenshot

ステップ 2: 組織を作成

組織は、チームアクセスと請求を管理するのに役立ちます。

組織をセットアップ

  1. 組織名 - わかりやすい名前を選択

    • 例: “Acme Corp”、“My Startup”、“Personal Projects”

  2. 組織 ID - API アクセス用の自動生成スラッグ

    • 例: acme-corp、my-startup
    • カスタマイズ可能 (小文字、ハイフンのみ)

  3. 請求プラン - 無料層で開始

    • 無料: 月 100 エージェント実行
    • Pro: 無制限実行 (月 $29)
    • Enterprise: カスタム価格

「組織を作成」 をクリックして続行します。

Screenshot

注: 後で設定から複数の組織を作成したり、既存の組織に参加したりできます。

ステップ 3: Personal Access Token を作成

Personal Access Tokens (PAT) により、API リクエストと CLI コマンドを認証できます。

API キーに移動

  1. 右上隅にある プロフィールアイコン をクリック
  2. 「設定」 を選択
  3. 左サイドバーで 「API キー」 をクリック

Screenshot

最初のトークンを作成

  1. 「+ 新しい Personal Access Token」 をクリック

  2. トークンを設定:

    • 名前: “Getting Started Token” (または任意のわかりやすい名前)
    • 有効期限: “90 日” を選択 (テスト用として推奨)
    • スコープ: 完全なアクセス (近日スコープが利用可能)

  3. 「トークンを作成」 をクリック

Screenshot

トークンを安全に保存

⚠️ 重要: トークンは 1 回だけ表示されます！

td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6

すぐに実行:

  1. トークンをクリップボードにコピー
  2. パスワード管理ツールまたは環境変数に安全に保存
  3. git にコミットしたり、公開で共有したりしないでください

環境変数に保存 (推奨):

# macOS/Linux - ~/.bashrc または ~/.zshrc に追加
export TEAMDAY_API_TOKEN="td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

# Windows PowerShell
$env:TEAMDAY_API_TOKEN="td_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"

シェルをリロード：

source ~/.bashrc  # または source ~/.zshrc

Screenshot

トークンを紛失した場合: トークンを取り消して新しいトークンを作成する必要があります。紛失したトークンを取得する方法はありません。

ステップ 4: 最初の API 呼び出しを実行

TeamDay API を呼び出して、トークンが機能することを確認します。

認証をテスト

cURL を使用:

curl -X GET "https://us.teamday.ai/api/v1/agents" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -H "Content-Type: application/json"

予想されるレスポンス:

{
  "data": [],
  "count": 0
}

空のリストが表示されます (まだエージェントを作成していないため)。

Screenshot

JavaScript を使用:

const TEAMDAY_TOKEN = process.env.TEAMDAY_API_TOKEN;

async function listAgents() {
  const response = await fetch('https://us.teamday.ai/api/v1/agents', {
    headers: {
      'Authorization': `Bearer ${TEAMDAY_TOKEN}`,
      'Content-Type': 'application/json'
    }
  });

  const data = await response.json();
  console.log('Agents:', data);
}

listAgents();

Python を使用:

import os
import requests

TEAMDAY_TOKEN = os.environ['TEAMDAY_API_TOKEN']

def list_agents():
    response = requests.get(
        'https://us.teamday.ai/api/v1/agents',
        headers={
            'Authorization': f'Bearer {TEAMDAY_TOKEN}',
            'Content-Type': 'application/json'
        }
    )
    print('Agents:', response.json())

list_agents()

API 呼び出しのトラブルシューティング

401 権限なし:

  • トークンが無効または期限切れ
  • トークンを正しくコピーしたことを確認
  • トークンが設定内に存在することを確認 → API キー

403 禁止:

  • トークンに必要な権限がない
  • 正しい組織にいることを確認

ネットワークエラー:

  • インターネット接続を確認
  • API URL が正しいことを確認: https://us.teamday.ai

ステップ 5: 最初のエージェントを作成

API を使用して AI エージェントを作成します。

API 経由でエージェントを作成

リクエスト:

curl -X POST "https://us.teamday.ai/api/v1/agents" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My First Agent",
    "systemPrompt": "You are a helpful assistant that can answer questions and help with tasks. Be concise and friendly.",
    "model": "claude-sonnet-4-6",
    "visibility": "private"
  }'

レスポンス:

{
  "id": "char_abc123xyz",
  "name": "My First Agent",
  "systemPrompt": "You are a helpful assistant...",
  "model": "claude-sonnet-4-6",
  "visibility": "private",
  "organizationId": "org_xyz789",
  "createdAt": "2025-01-15T10:00:00Z",
  "updatedAt": "2025-01-15T10:00:00Z"
}

エージェント ID を保存 (char_abc123xyz) - エージェントを実行するのに必要になります。

Screenshot

UI 経由でエージェントを作成

ビジュアルインターフェースを好みますか？

  1. サイドバーで 「エージェント」 に移動
  2. 「+ 新しいエージェント」 をクリック
  3. 詳細を入力：
    • 名前: “My First Agent”
    • モデル: “Claude 3.5 Sonnet” を選択
    • システムプロンプト: 上記の命令を入力
    • 可視性: “非公開” を選択
  4. 「エージェントを作成」 をクリック

Screenshot

エージェントをテスト

API 経由で実行:

curl -X POST "https://us.teamday.ai/api/v1/agents/char_abc123xyz/execute" \
  -H "Authorization: Bearer $TEAMDAY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Hello! What can you help me with?"
  }'

レスポンス:

{
  "executionId": "exec_456def",
  "message": "Hello! I'm your helpful assistant. I can help you with a variety of tasks including answering questions, providing information, helping with analysis, and more. What would you like assistance with today?",
  "usage": {
    "inputTokens": 245,
    "outputTokens": 89
  },
  "status": "completed"
}

Screenshot

UI 経由で実行:

  1. 「エージェント」 → 「My First Agent」 に移動
  2. 「チャット」 をクリック
  3. メッセージを入力: “Hello! What can you help me with?”
  4. Enter を押すか 送信 をクリック
  5. エージェントのレスポンスを表示

Screenshot

次のステップ

おめでとうございます！以下を正常に実行しました：

  • ✅ TeamDay アカウントを作成
  • ✅ 組織をセットアップ
  • ✅ Personal Access Token を生成
  • ✅ 最初の API 呼び出しを実行
  • ✅ 最初の AI エージェントを作成してテスト

推奨される次のステップ

1. より専門的なエージェントを作成

2. ワークスペースをセットアップ

3. GitHub に接続

  • エージェントがリポジトリと連携できるようにする
  • ガイド: Git 統合

4. MCP プラグインをインストール

  • ツールと統合を使用してエージェント機能を拡張
  • ガイド: MCP プラグイン

5. API を探索

学習リソース

ヘルプを取得

コミュニティ:

サポート:

経験をシェア

TeamDay での最初の経験についてお聞きしたいです！

  • Twitter でシェア: @teamdayai
  • フィードバックを残す: feedback at teamday.ai

ハッピービルディング!