Skip to main content
はじめに

クイックスタート

インストールを完了し、コンソールを開き、Waker を作成して最初のタスクを送信します。システム要件、macOS / Linux / Windows へのインストール、サインイン、サービス管理、FAQ を扱います。

この章の目標： インストールを完了し、コンソールを開き、Waker を作成して最初のタスクを送信します。すでに Web Console を開ける場合は、最初の Waker を作成するに進んでください。

システム要件とインストール前の確認

項目推奨
オペレーティングシステムmacOS 13.0 以降、主要な Linux ディストリビューション、Windows 10 以降
メモリ4 GB 以上を推奨
ディスク容量500 MB 以上の空き容量
ネットワークモデルサービス、コードリポジトリ、Connectors へのアクセスが必要です。企業ネットワークでは、関連するアウトバウンド HTTPS 接続を許可する必要があります
インストール前に、現在のユーザーがプログラムをインストールし、バックグラウンドサービスを起動し、対象の作業ディレクトリにアクセスできることを確認してください。

インストール

  • macOS
  • Linux
  • Windows
macOS では、パッケージインストーラーまたはコマンドラインでインストールできます。

オプション 1: パッケージインストーラー

  1. QoderWake website を開きます。
  2. "MacOS" を選択し、チップに応じて "ARM64 (Apple Silicon)" または "X64 (Intel)" を選択します。
  3. .dmg をダウンロードして開き、QoderWake を "Applications" にドラッグします。
  4. "Applications" から QoderWake を開き、求められたらアカウント認可を完了します。サービスが起動して Web Console が開くまで待ちます。

オプション 2: コマンドライン

ターミナルを開き、次を実行します。
curl -fsSL https://qoder-ide.oss-ap-southeast-1.aliyuncs.com/qoderwake/install.sh | bash
実行中はターミナルを閉じないでください。認可ページが表示されたら認可を完了し、ターミナルに戻って完了を待ちます。確認:
  • ブラウザで Web Console が開くか、ターミナルにコンソールのアドレスが表示されます。
  • 新しいターミナルで qoderwake status を実行すると、サービスのステータスが返されます。
ターミナルで qoderwake が見つからないと表示された場合は、新しいターミナルを開いてください。それでも動作しない場合は、フルパスを使用します。
~/.qoderwake/bin/qoderwake login
パッケージ名はバージョンごとに変わるため、必ず公式 Web サイトからダウンロードしてください。インストール時にすでにサインイン、サービスの起動、Web Console の起動が完了している場合、以下のサインインおよび起動コマンドを繰り返す必要はありません。直接 Waker の作成に進んでください。

サインイン、アカウント確認、サインアウト

ブラウザ認可

次のコマンドを実行します。 
qoderwake login
qoderwake whoami
ブラウザで認可を完了します。ブラウザが開かない場合は、ターミナルに表示されたアドレスをコピーしてください。認可がタイムアウトした場合は、再度 login を実行します。 確認: qoderwake whoami に現在のアカウントが表示され、クラウドまたはリモート機能でサインインを求められなくなります。

トークンによるサインイン

GUI デスクトップが利用できない、またはブラウザ認可ができない場合は、Personal Access Token（PAT）でサインインします。 
QODER_PERSONAL_ACCESS_TOKEN="your-token" \
  ~/.qoderwake/bin/qoderwake login --method token
ファイルからトークンを読み込むこともできます。 
qoderwake login --method file --token-file /path/to/token
サインイン後、qoderwake whoami を実行します。
実際のトークンをスクリーンショット、タスクメッセージ、リポジトリに保存しないでください。

アカウントの切り替えまたはサインアウト

現在のサインイン状態をクリアするには、次を実行します。 
qoderwake logout
アカウントを切り替えるには、logout、login、whoami を順番に実行し、Web Console を更新します。サインインしていない場合でもローカルモードは利用できますが、クラウドおよびリモート機能には有効なアカウントが必要です。

サービスを起動してコンソールを開く

起動して開く

サービスが実行されていない場合: 
qoderwake start --open
サービスがすでに実行中の場合は、Web Console を開きます。 
qoderwake portal
portal は実際のポートを読み取ります。デフォルトのアドレスは http://127.0.0.1:19820 です。ポートが使用中の場合は、自動的に増加します。 ブラウザを開かずに実際のアドレスを表示するには: 
qoderwake portal --no-open
確認: ブラウザで Web Console が開くか、portal --no-open で表示されたアドレスにアクセスできます。

ステータス確認、再起動、停止

qoderwake status
qoderwake restart --open
qoderwake stop
qoderwake stop --force
コマンド使用する場面期待される結果
qoderwake statusサービスが実行中かどうかわからない場合現在のサービスステータスと関連情報を返します
qoderwake restart --openページが異常な場合、または設定やバージョンを更新した場合サービスが再起動し、コンソールが再度開きます
qoderwake stopバックグラウンドサービスを通常終了する場合サービスは停止しますが、サインイン状態は保持されます
qoderwake stop --force通常の停止が機能しない場合強制停止します。実行中のタスクが中断される可能性があります
停止または再起動の前に、Chat タスク、Autonomous Work、WakerFlows が進行中でないか確認してください。強制停止すると、現在の実行が中断される可能性があります。

最初の Waker を作成する

1

Waker Management を開く

qoderwake portal を実行し、"Waker Management" を開いて "New Waker" を選択します。
2

マーケットプレイスでロールを選択する

ジョブに最も近いプリセットロールを選択します。該当するロールがない場合は、"Custom Waker" を選択します。
ロールマーケットプレイスでプリセットロールを選択するか、カスタム Waker を作成する
3

ロールを確認する

ロールカードを開き、コア機能、作業スタイル、作業方法、含まれる Skills を確認してから、"Create Waker" を選択します。
4

詳細を入力する

名前を入力し、"What I own" とランタイム環境を確認します。最初のタスクに必要な Skills、Knowledge Base、Connectors だけを残します。
Waker の名前、責任範囲、ランタイム、リソースを入力する
5

Waker を作成する

"Create Waker" を選択します。
確認:
  • 新しい Waker が Waker リストに表示されます。
  • カードに正しい名前、説明、環境、ステータスが表示されます。
"Create Waker" をクリックできない場合は、ロールが選択されているか、名前が入力されているか、すべての必須項目が入力されているかを順に確認してください。

最初の Chat タスクを送信する

1

Chat に入る

新しい Waker カードで "Create Chat Task" をクリックし、Chat ページに正しい Waker が表示されていることを確認します。
2

作業ディレクトリを選択する

ファイルを扱う場合は、正しい作業ディレクトリを選択します。必要に応じて添付ファイルを追加するか、@ を使ってコンテキストを参照します。
3

ドライランタスクを送信する

モデルを "Auto" のままにし、次のような読み取り専用のドライランタスクを送信します。
現在のディレクトリにある README のみを読み取り、ファイルは変更しないでください。
プロジェクトの目的と起動方法を 5 つ以内の箇条書きでまとめてください。
情報が不足している場合は、その旨を明記してください。
4

認可プロンプトを処理する

タスクを送信します。認可または確認のプロンプトが表示された場合は、続行する前に操作の詳細を確認してください。
5

結果を確認する

最終応答を待ち、結果が選択したディレクトリから取得され、要求の範囲を超えていないことを確認します。
最初のタスクを送信する前に Waker、ワークスペース、モデルを選択する
確認:
  • Waker が処理中の状態になり、最終的に結果を返します。
  • 結果は選択したディレクトリまたは添付ファイルから取得され、タスクの範囲を超えません。
これらの手順を完了すると、インストール、サービス、アカウント、Waker、Chat タスクのフローが確認されます。

クイックスタート FAQ

症状最初に確認すること推奨される対処
ターミナルで qoderwake が見つからないと表示される新しいターミナルでコマンドパスが読み込まれているかターミナルを開き直します。必要に応じて ~/.qoderwake/bin/qoderwake を使用します
ブラウザが自動的に開かないターミナルにアドレスが表示されたかアドレスをブラウザにコピーするか、qoderwake portal --no-open を実行します
デフォルトのアドレスにアクセスできないサービスが実行中で、実際のポートが変更されていないかqoderwake status と qoderwake portal を実行します
クラウドまたはリモート機能を利用できない現在のアカウントが有効かqoderwake whoami を実行します。必要に応じて再度サインインします
Waker がローカルファイルにアクセスできない正しい作業ディレクトリが選択されているか入力エリアに戻り、ディレクトリを選択してタスクを再試行します
はじめに
作業管理
従業員リソース
ベストプラクティス
操作設定
コマンドライン
サポート