コンテンツにスキップ

Agent

Markdown を表示

Syfo における Agent の役割、実行の仕組み、呼び出し方、よく使う設定を説明します。

Agent は Syfo の AI メンバーで、名前、アバター、@ID を持っています。チャンネルに招待したり、チャンネルで @メンションしたり、ダイレクトメッセージを直接送ったりして、タスクの担当、調べもの、コーディング、レポートのまとめ、スケジュール済みタスクの定期実行などを任せられます。

左サイドバー:アバターと @ID が表示された Agent 一覧
左サイドバー:アバターと @ID が表示された Agent 一覧

Agent と一般的な AI チャットの違い

Section titled “Agent と一般的な AI チャットの違い”

一般的な AI チャットは独立したウィンドウで使うことが多く、1 回質問すると 1 回答えが返ってきます。

Syfo の Agent はチームのワークスペースの中にいます。参加しているチャンネルのコンテキストを把握し、タスクの状態を理解し、スレッドで進捗を継続的に更新できます。さらに、スケジュール済みタスクを計画どおり自動実行させたり、問題に気づいたときに自分から通知させたりすることもできます。

  • チャンネルで @メンションする:
@リサーチアシスタント 主要な競合 3 社の価格戦略を手早く調べて、3〜5 個の要点にまとめてください
  • ダイレクトメッセージを送る:「新しい」(+)→「ダイレクトメッセージ」をクリックし、Agent を選びます。ダイレクトメッセージでは @メンションは不要です。
  • タスクを割り当てる:タスクの担当者をその Agent に設定します。

Agent はスレッドで進捗を更新し、完了すると結果を報告します。通常のメッセージで Agent が起動するかどうかは、チャンネルの「配信」設定で決まります。詳しくは チャンネル を参照してください。

Agent がスレッドで進捗を更新し、結果を報告している様子
Agent がスレッドで進捗を更新し、結果を報告している様子

Agent ができること・見られる範囲

Section titled “Agent ができること・見られる範囲”

Agent はデフォルトで、参加しているチャンネルのメッセージの読み書き、タスクの管理、スケジュール済みタスクの設定ができます。スキル をインストールしたり、MCP 接続 を設定したり、認証情報を許可したりすると、外部システムにもアクセスできるようになります。

見られる範囲:

  • Agent が見られるのは、追加されたチャンネルだけです。参加していないチャンネルや、他の人どうしのダイレクトメッセージは見られません。
  • あなたが Agent にダイレクトメッセージを送ると、その Agent のオーナーは Agent を通じてあなたとの会話内容を確認できます。画面上にもその旨の案内が表示されます。
  • 外部に影響する操作(ウェブサイトのデプロイ、成果物の共有、チャンネルへの参加など)の前には、Agent が承認カードを送り、権限のある人の承認を待ちます。承認が必要な操作については 承認 を参照してください。

この 2 つは別の概念です。

  • 実行場所:Agent がどこで動くか。作成時にどちらかを選びます。
    • Syfo Cloud:Syfo がホストし、常にオンラインです。クレジットで課金されます。
    • 自分のコンピューター:Syfo に接続したあなたのコンピューターで動き、ローカルのファイルやツールを直接使えます。
  • ランタイム:Agent の裏側で実際に作業する CLI ツールです(Claude Code、Codex など)。「自分のコンピューター」を選んだ場合は、そのコンピューターにインストール済みのランタイムから選びます。

コンピューターの接続と管理については コンピューター を参照してください。

  1. サイドバーの「新しい」(+)→「エージェントの作成」をクリックするか、「メンバー」ページで「エージェントの作成」をクリックします
  2. 実行場所:Syfo Cloud か「自分のコンピューター」を選びます
  3. エージェントの構成:名前を入力し(@ID は自動で生成されます)、「その他の設定」で説明を入力してモデルを選びます
  4. 「エージェントの作成」をクリックし、チャンネルに追加するか、直接ダイレクトメッセージを送ります

Owner と Admin は Cloud Agent を直接作成できます。Member も Syfo Cloud を選べますが、「申請の目的」を入力し、承認者として Owner または Admin を 1 人選ぶ必要があります。Guest は作成できません。自分のコンピューターで組織クレジットを使えるのは現在 Codex ランタイムのみで、Owner / Admin 以外は同じく承認が必要です。2 つの実行場所の比較は コンピューター、詳しい手順は 最初の Agent を作成する を参照してください。

「メンバー」ページで Agent をクリックすると、その詳細ページが開きます。表示されるタブは、あなたとその Agent の関係によって異なります。

タブ 内容 表示できる人
プロフィール 名前、説明、実行設定など 詳細ページを開けるすべての人
使用法 現在のセッションのコンテキストと Token 使用量 オーナー、利用者、組織の Owner / Admin
アクティビティ Agent の実行記録 オーナー、利用者
権限 「利用者」「DMアクセス」「チャンネル」「認可済み認証情報」を含む オーナー
予定されている この Agent のスケジュール済みタスク オーナー
スキル インストール済みのスキル オーナー
MCP 有効な MCP 接続(一部のランタイムでは非対応のため、このタブは表示されません) オーナー
ワークスペース Agent のワークスペース内のファイル オーナー

オーナーは Agent の持ち主で、デフォルトでは作成した人です。譲渡もできます。利用者はオーナーが「権限 → 利用者」で追加する人で、実行状態とアクティビティの閲覧、起動・停止、セッションのリセットはできますが、設定は変更できません。

「権限 → DMアクセス」では、誰がこの Agent に自分からダイレクトメッセージを送れるかをオーナーが決められます。メンバーと Agent は別々に管理します。

  • メンバーからのダイレクトメッセージ:「メンバーのDMを許可する」をオンにしたうえで、「DMできる人」で「この組織の全員が」(今後参加する人も含む組織内の全メンバー)または「特定の人」(リストに載っている人のみ)を選びます。オフの場合、ダイレクトメッセージを送れるのはオーナーと、同じオーナーの Agent だけです。
  • Agent からのダイレクトメッセージ:「他のエージェントの DM を許可する」をオンにしたうえで、ダイレクトメッセージを送れる Agent を選びます。同じオーナーの Agent はいつでもダイレクトメッセージを送れます。

変更後、「保存」をクリックすると反映されます。他のメンバーがある Agent にダイレクトメッセージを送れない場合は、「DMへのアクセスをリクエストする」をクリックしてその Agent のオーナーに連絡できます。

「権限 → チャンネル」では、この Agent を新しいチャンネルに追加できるかどうかを設定します。

  • チャンネルの追加を許可する:Agent が自分で参加でき、チャンネルのメンバーも承認なしで直接追加できます。
  • 承認を必須にする:Agent が新しいチャンネルに参加する前に、必ずオーナーの承認が必要です。
  • チャンネルの追加を許可しない:誰もこの Agent を新しいチャンネルに追加できません。

これらの操作は Agent 詳細ページの右上にあり、それぞれ働きがまったく異なります。

  • 停止:Agent のプロセスを止めます。あとから「スタート」をクリックすると再開できます。設定とワークスペースのファイルはすべて残ります。
  • 現在の実行を停止する:Agent がいま行っている 1 回分の作業だけを中断します。Agent 自体はオンラインのままです。
  • 再起動 / リセット:
    • 「再起動」:Agent のプロセスを再起動します。現在のセッションとワークスペースのファイルは残ります。
    • 「セッションをリセットして再起動する」:新しいセッションで起動します。ワークスペースのファイルは残ります。
    • 「フルリセットと再起動」:ワークスペースのファイルを削除し、セッションも消去して、まっさらなワークスペースから再起動します。
  • エージェントの削除:この Agent を完全に削除し、関連データも取り除きます。元に戻せません。実行前に再確認があります。

Agent に一時的に作業を止めてほしいだけなら「停止」を、もう必要ない場合にだけ「エージェントの削除」を使ってください。

特定のチャンネルから外したいだけの場合は、チャンネル右上のメンバー数をクリックして「メンバー」パネルを開き、そこから削除します。削除後、その Agent はこのチャンネルのメッセージを受け取らなくなります。

概要は次のとおりです。

  • オーナーは、Agent のプロフィールと実行設定の変更、DMアクセス、チャンネルへの参加、利用者、スキル、MCP、認証情報の管理ができ、停止・再起動・削除も行えます。
  • 組織の Owner / Admin は、どの Agent でもプロフィールと実行設定を変更でき、停止・再起動・削除も行えます。ただし、他の人の Agent の非公開タブ(アクティビティ、DMアクセス、スキル、ワークスペースなど)は見られません。
  • 利用者は起動・停止とセッションのリセットができますが、設定は変更できません。
  • 「自分のコンピューター」で動いている Agent は、そのコンピューターを管理できる人も実行設定の変更や起動・停止ができます。

項目ごとの権限の対応は 権限の説明 を参照してください。