よくある質問

導入検討、初期設定、日常の利用、料金、権限、ツール拡張に関するよくある質問です。各質問に短い結論と詳しい説明へのリンクを載せています。

Syfo と既存ツール

すでに Feishu（飛書）/ WeCom（企業微信）/ Slack を使っています。なぜ Syfo が必要ですか？

Syfo では、すべてのコミュニケーションを移行する必要はありません。Syfo が向いているのは、「議論がアクションにつながり、AI が実行に関わり、プロセスと結果をチームで共有する必要がある」仕事です。Agent はチャンネルの中にいて、コンテキストを把握し、タスクを引き受け、ステータスを更新し、結果を届けます。必要に応じて、Agent はコマンドラインツールや統合を通じて Feishu のドキュメントや多次元表（Bitable）などを読み書きし、結果を既存のシステムに書き戻すこともできます。詳しくは Syfo とはを参照してください。

社内システムがたくさんあります。Syfo とどう連携しますか？

業務システムを Syfo に移す必要はありません。まずは明確なツールの入り口から始め、Agent が API、コマンドラインツール、MCP、スキルを通じて必要な情報を読み取り、安定した操作を実行できるようにします。そのうえで、権限に応じて範囲を少しずつ広げていきます。詳しくは MCP 接続、統合、スキルを参照してください。外部システムからチャンネルにイベントを送りたい場合は、Webhook を参照してください。

Agent はブラウザで画面を操作するしかないのですか？

いいえ。ブラウザ自動化は最後の手段です。本番環境では API、コマンドラインツール、MCP、スキルを優先してください。そうすればテストも監査もでき、画面のデザインが変わってもフローが壊れません。

オンプレミス（プライベート）での導入はできますか？

ご相談いただけます。営業担当にお問い合わせのうえ、ご検討ください。詳しくはセキュリティと権限を参照してください。

Agent の作成と設定

Agent の作成はどこから始めればよいですか？

まず実際のユースケースを 1 つ選び、そこから必要なチャンネル、Agent、ツールを逆算します。空のプロンプトから始めないでください。作成手順は最初の Agent を作成する、計画の立て方はチームへの導入を参照してください。

Agent を新しく作るべきときと、既存の Agent を再利用すべきときは？

同じ種類のタスクで対象が変わるだけなら、再利用します。役割、権限、外部システム、機密データの範囲が明らかに異なる場合は、新しく作ります。まずは 1 つの Agent で試し、役割が本当に分かれてきたら分割しましょう。詳しくはチャンネルとコラボレーションを参照してください。

ローカルのコンピューターと Syfo Cloud の違いは何ですか？

自分のコンピューターでは、手元のリポジトリ、ツール、ログイン状態をそのまま使えますが、電源を切ったりネットワークが切れたりすると Agent は一時停止します。Syfo Cloud は常にオンラインで、組織クレジットで課金されます。Owner と Admin は直接作成でき、一般メンバーは申請が必要です。詳しくはコンピューターと実行場所を参照してください。

自分のコンピューターに Claude Code / Codex をインストール済みで、スキルや MCP も設定してあります。Syfo にはどう接続しますか？

まずこのコンピューターを Syfo に接続し（「コンピューター → コンピューターを追加する」）、次にこのコンピューター上で Agent を作成します。これで Agent は手元の既存設定を使えるようになります。Syfo Cloud 上の Agent はあなたのコンピューターの設定を引き継がないため、別途インストールが必要です。インストール済みのスキルは Agent 詳細ページの「スキル」タブで、MCP は「MCP」タブで確認できます。詳しくはコンピューターと実行場所、スキル、MCP 接続を参照してください。

料金

自分のコンピューターで Agent を動かすと料金はかかりますか？

Agent がコンピューター上のランタイムに設定された自分のアカウントやキーを使っている場合、Syfo のクレジットは消費されません。「モデルの支払い」で「組織クレジット」を選んだ場合にのみ、組織の残高からモデル料金が差し引かれます。詳しくは使用量と請求を参照してください。

クレジットは何に使われますか？

主に 4 種類です。Syfo Cloud と組織クレジット払いのモデル呼び出し（LLM）、Powerpack、ホステッドの計算リソース、そしてウェブサイトのホスティングです。詳しくは使用量と請求を参照してください。

クレジットを使い切るとどうなりますか？

クレジットを消費する Agent は一時停止し、Powerpack の呼び出しは実行されず、ウェブサイトは猶予期間の終了後にアクセスできなくなります。チャージすると自動的に再開します。残高が少なくなると、Owner と Admin に事前に通知が届きます。詳しくは使用量と請求を参照してください。

「使用法」と「サブスクリプションとクレジット」が表示されないのはなぜですか？

この 2 つの項目は、組織の Owner と Admin にのみ表示されます。Owner または Admin に連絡してください。

チャンネルとコラボレーション

1 つのチャンネルに Agent は何体入れるべきですか？

最初は少なめにし、必要に応じて増やします。継続的なプロジェクトでは、まず「複数の人 + 常駐 Agent 1 体」でフローを確立し、さらに役割が必要になったら職責ごとに追加します。詳しくはチャンネルとコラボレーションを参照してください。

複数の Agent がいると混乱しませんか？

混乱します。だからこそ、最初から多くの Agent を同じチャンネルに入れないでください。誰がタスクを分解し、誰が実行し、誰がチェックし、どの操作に人の確認が必要かを先に決めておきましょう。詳しくはチャンネルとコラボレーションとメッセージ配信を参照してください。

スケジュール済みタスクを特定の Agent に割り当てたのに、チャンネル内のすべての Agent に届いたのはなぜですか？

スケジュール済みタスクを該当するスレッドやタスクの中に置いた場合は、対象の Agent にだけ通知されます。チャンネルのメインのメッセージフローに投稿した場合は、チャンネルの配信設定に従ってチャンネル内の Agent に通知されます。スケジュール済みタスクを作成するときは実行する Agent を明示し、その後の議論は同じタスクまたはスレッドの中で行ってください。詳しくはスケジュール済みタスクとメッセージ配信を参照してください。

Agent が後続の質問を同じタスクにまとめてしまうのはなぜですか？

同じスレッドやタスクの中で質問を続けると、Agent は同じ件の補足だと判断します。新しいタスクを始めたい場合は、チャンネルのメインのメッセージフローに戻って改めて @メンションするか、「これは新しいタスクです」とはっきり伝えてください。詳しくはタスクを参照してください。

ファイルと成果物の違いは何ですか？

ファイルは作業途中の資料で、スクリーンショット、ログ、参考ドキュメントなどです。成果物は最終的なアウトプットで、レポート、デプロイ先 URL、最終版の PDF などです。詳しくはファイルと成果物を参照してください。

通知を調整して、邪魔されないようにするには？

チャンネルごとに「すべてのメッセージ」「@メンションとフォロー中のスレッド」「ミュート」を個別に設定できます。また、「設定 → 通知」で「この組織をミュートする」をオンにすることもできます。詳しくは通知を参照してください。

Agent の動作とチューニング

Agent に作業を始めてもらうには？

チャンネルで Agent を @メンションし、目的、インプット、出力形式、完了条件をはっきり伝えます。

@リサーチアシスタント このチャンネルで今週お客様が挙げた製品の問題を整理し、P1/P2/P3 に分類して、推奨アクションを提示してください。

フォローアップが必要な作業は、Agent がタスクに変換します。詳しくはタスクを参照してください。

Agent がずっと作業中のまま返信しません。どうすればよいですか？

何度も @メンションするのはやめましょう。まず Agent 詳細ページの「アクティビティ」タブで、何をしているかを確認します。タスク自体が長い、メッセージが順番待ちになっている、あるいは動作しているコンピューターがオフラインになっている、ランタイムに問題が起きている、といった可能性があります。長時間進展がない場合は、Agent のオーナーまたは組織の管理者に Agent を再起動してもらうか、動作しているコンピューターを確認してください。詳しくはコンピューターと実行場所を参照してください。

Agent の応答に 1〜2 分かかることがあるのはなぜですか？

Agent は常駐セッションで、複数のチャンネルやタスクで同時に作業していることがあります。前のツール呼び出しが終わっていないと、後から届いたメッセージは順番待ちになります。業務ごとにチャンネルを分ける、1 つの Agent を 1〜2 つのモジュールに専念させる、手が空いているときにセッションをリセットする、といった工夫で応答が速くなります。詳しくはベストプラクティスを参照してください。

Agent が問題にぶつかるたびに止まって確認を待つのはなぜですか？

多くの場合、作業の境界がはっきり決まっていないか、セッションが長すぎる・忙しすぎることが原因です。「どの操作は自分で進めてよく、どの操作は必ず確認が必要か」を Agent の長期記憶に書き込んでください。詳しくはベストプラクティスを参照してください。

ちょっとした修正でも Agent がブランチを作り、リポジトリ全体を読み込みます。これは正常ですか？

たいていは、作業の進め方がまだ調整できていないだけです。Agent に次のように伝えましょう。小さな修正は現在のブランチで直接行い、中規模以上の修正はフィーチャーブランチを使い、複数の Agent が同じリポジトリを同時に変更するときは git worktree を使い、まず関連ファイルを特定してから範囲を広げること。詳しくはベストプラクティスを参照してください。

Agent が間違えたらどうすればよいですか？

スレッドの中で問題を直接指摘し、新しい制約を伝えます。たとえば「お客様がはっきり言った問題だけを残し、あなたの推測は加えないでください」のように伝えます。リスクの高い操作では、まず確認用の情報を出させ、人が承認してから実行させてください。詳しくは承認を参照してください。

Agent を一時停止、削除、リセットするには？

チャンネルから外すと、Agent はそのチャンネルのメッセージを受け取らなくなります。リセットや再起動は、Agent のオーナーまたは組織の管理者が行います。詳しくは権限を参照してください。

開発の過程がブラックボックスのようです。何が変わったのか、どうロールバックするのかを知るには？

1 つの画面で Syfo の会話と Agent の「アクティビティ」タブを見て、もう 1 つの画面でエディターやターミナルを使って git diff とコミット履歴を確認します。バージョン管理とロールバックは git に任せ、Agent にはどのファイルを変更したか、なぜ変更したか、どう検証するかを説明させましょう。

権限とセキュリティ

Agent は私のプライベートなデータを見られますか？

Agent は公開チャンネルを閲覧できます。プライベートチャンネルとダイレクトメッセージは、メンバーでなければ見られません。ほかのメンバー同士のダイレクトメッセージは Agent には見えません。外部システムには別途権限付与が必要です。詳しくはセキュリティと権限を参照してください。

特定の Agent にダイレクトメッセージを送れないのはなぜですか？

デフォルトでは、Agent のオーナーだけがその Agent にダイレクトメッセージを送れます。オーナーは Agent 詳細ページの「権限」→「DMアクセス」で「メンバーのDMを許可する」をオンにできます。あなたは「DMへのアクセスをリクエストする」をクリックしてオーナーに依頼できます。詳しくはセキュリティと権限を参照してください。

特定のチャンネルが見えないのはなぜですか？

プライベートチャンネルは、招待されたメンバーにしか表示されません。チャンネル内のメンバーやチャンネルのオーナーに連絡して、追加してもらってください。詳しくは権限を参照してください。

Syfo Cloud Agent を作成できないのはなぜですか？

Owner と Admin は直接作成できます。一般メンバーは申請を記入し、承認者として Owner または Admin を 1 人選ぶ必要があります。組織に利用可能なクレジットがない場合も作成できません。詳しくはコンピューターと実行場所を参照してください。

Agent が外部システムを使うとき、認証情報はどこに置きますか？

「設定 → Vault」に保存し、Agent ごとに個別に権限を付与します。チャンネルに直接貼り付けないでください。詳しくはパスワード保管庫を参照してください。

モデルの呼び出しはどの経路を通りますか？

モデルベンダーの公式経路、または大手事業者の正規の経路を通ります。リクエスト内容は対応するモデルプロバイダーに送信されます。詳しくはセキュリティと権限を参照してください。

人が確認しなければならない操作は？

外部への送信、支払い、本番リリース、データの削除、権限の変更、そしてロールバックが難しいあらゆる操作です。詳しくは承認を参照してください。

ツールと拡張

Agent にタスクを定期的に自動実行させられますか？

はい。時間とやることを Agent に直接伝えてください。

@リサーチアシスタント 毎朝 9 時に、前日の #product-team チャンネルでの議論をブリーフィングにまとめて、ここに投稿してください。

スケジュール済みタスクを実行するには、その時刻に Agent がオンラインである必要があります。長期間安定して実行したい場合は、Syfo Cloud をおすすめします。詳しくはスケジュール済みタスクを参照してください。

Agent は画像や動画を生成できますか？

はい。組織で Powerpack を有効にし、Agent が動作するコンピューターにインストールすると、Agent は画像、動画、ナレーション、BGM を生成・編集できるようになり、EC やソーシャルメディアのデータも調べられます。使用量は組織クレジットで課金されます。

Agent にウェブサイトを公開してもらえますか？

はい。Agent がビルドとデプロイを担当し、公開前に承認カードを送信します。ウェブサイトの Owner または組織の管理者が承認します。詳しくはウェブサイトを参照してください。