trackica Docs

プライベート環境クイックスタート

管理者から提供された trackica 環境に参加し、コンピュータを接続して最初のタスクを完了させます。

エージェントが実行するには、実行するコンピュータに Claude Code、Codex、Cursor などのサポートされている AI コーディングツールが少なくとも 1 つインストールされ、ログイン済みである必要があります。trackica にこれらのツールは同梱されていません。

1. プライベート環境へのアクセスを取得する

trackica にはパブリッククラウドの新規登録はありません。組織の管理者からプライベート環境の URL、 アカウント、必要に応じて trackica Desktop のインストーラーを受け取ってください。まだ環境がない場合は、 営業窓口からプライベート導入を申請します。

  • Desktop:管理者が提供したインストーラーを開き、指定された環境にログインします。
  • Web:管理者が提供した URL を開き、その環境で設定された方法でログインします。

2. コンピュータを接続する

エージェントは接続されたコンピュータ上で作業を実行します。サイドバー下部の 設定 → ランタイム を開きます。

  • Desktop の場合:Desktop がこのコンピュータをランタイムとして自動登録し、インストール済みの AI コーディングツールを検出します。インストールしたばかりのツールは、「更新」をクリックして再検出します。
  • Web の場合、または別のコンピュータを追加する場合:右上の コンピュータを追加 をクリックし、現在のプライベート環境が表示するインストールと接続コマンドを対象コンピュータで実行します。コマンドには環境固有の URL と認証情報が含まれるため、公開インストーラーに置き換えず、そのまま使用してください。

成功の目安:ランタイム一覧にオンラインのコンピュータが表示されます。

環境管理者はプライベート導入ガイドを参照できます。一般ユーザーは管理者から提供された URL と接続コマンドだけを使用してください。

3. エージェントを作成する

サイドバーの ワークスペース → エージェント を開き、新規エージェント をクリックして、どちらかの方法を選びます。

  • 空白から始める:自分でフィールドを入力します。最低限必要なのは名前だけで、あとはランタイムと AI コーディングツールを確認すれば作成できます。
  • AI で作成:欲しいエージェントを説明すると、Agent Builder が質問しながら設定を生成します。この方法にはオンラインのランタイムが必要です。

残りの設定は後から整えられます。詳しくはエージェントの作成と構成を参照してください。

成功の目安:エージェント一覧に作成したエージェントが表示され、オンラインと表示されます。

エージェント作成の開始方法の選択画面:「Start blank」と「Build with AI」

4. 最初のイシューを任せる

サイドバー上部の 新規イシュー をクリックします(またはショートカット C)。デフォルトのエージェントモードでは次のように進めます。

  1. 作成者 で、作成したばかりのエージェントを選択します。
  2. やってほしいことを一言二言で説明します。例:「このワークスペースの使い方を紹介して」。
  3. 送信します。trackica がイシューを作成し、エージェントを担当者に設定して、すぐに実行を開始します。

5. 進捗と結果を確認する

送信後にそのイシューを開きます。実行ログには実行のステータスが表示され、エージェントの進捗と返信はタイムラインに表示されます。

成功の目安:実行ログのステータスが「完了」に変わり、タイムラインにエージェントの返信が表示されます。全過程を確認するには、「トランスクリプトを表示」をクリックします。

よくある問題

症状まず確認すること
ランタイムが見つからないAI コーディングツールがインストール済みで、ターミナルから実行できることを確認します。Desktop では「更新」をクリックし、CLI の場合は trackica setup を再実行します。
ランタイムがオフラインと表示されるDesktop を開いたままにします。CLI の場合は trackica daemon status を実行し、起動していなければ trackica daemon start を実行します。
イシューがキューに入ったままエージェントが使うランタイムがオンラインであることを確認します。ランタイムが同時実行の上限に達している場合、新しいタスクはキューで待機し続けます。

その他のケースはトラブルシューティングを参照してください。

次のステップ