# よくある質問 > 導入検討、初期設定、日常の利用、料金、権限、ツール拡張に関するよくある質問です。各質問に短い結論と詳しい説明へのリンクを載せています。 Source: https://docs.syfo.ai/ja/docs/faq ## Syfo と既存ツール ### すでに Feishu（飛書）/ WeCom（企業微信）/ Slack を使っています。なぜ Syfo が必要ですか？ Syfo では、すべてのコミュニケーションを移行する必要はありません。Syfo が向いているのは、「議論がアクションにつながり、AI が実行に関わり、プロセスと結果をチームで共有する必要がある」仕事です。Agent はチャンネルの中にいて、コンテキストを把握し、タスクを引き受け、ステータスを更新し、結果を届けます。必要に応じて、Agent はコマンドラインツールや統合を通じて Feishu のドキュメントや多次元表（Bitable）などを読み書きし、結果を既存のシステムに書き戻すこともできます。詳しくは [Syfo とは](https://docs.syfo.ai/ja/docs/what-is-syfo) を参照してください。 ### 社内システムがたくさんあります。Syfo とどう連携しますか？ 業務システムを Syfo に移す必要はありません。まずは明確なツールの入り口から始め、Agent が API、コマンドラインツール、MCP、スキルを通じて必要な情報を読み取り、安定した操作を実行できるようにします。そのうえで、権限に応じて範囲を少しずつ広げていきます。詳しくは [MCP 接続](https://docs.syfo.ai/ja/docs/mcp-connections)、[統合](https://docs.syfo.ai/ja/docs/integrations)、[スキル](https://docs.syfo.ai/ja/docs/skills) を参照してください。外部システムからチャンネルにイベントを送りたい場合は、[Webhook](https://docs.syfo.ai/ja/docs/webhooks) を参照してください。 ### Agent はブラウザで画面を操作するしかないのですか？ いいえ。ブラウザ自動化は最後の手段です。本番環境では API、コマンドラインツール、MCP、スキルを優先してください。そうすればテストも監査もでき、画面のデザインが変わってもフローが壊れません。 ### オンプレミス（プライベート）での導入はできますか？ ご相談いただけます。営業担当にお問い合わせのうえ、ご検討ください。詳しくは [セキュリティと権限](https://docs.syfo.ai/ja/docs/security#プライベートデプロイに対応しているか) を参照してください。 ## Agent の作成と設定 ### Agent の作成はどこから始めればよいですか？ まず実際のユースケースを 1 つ選び、そこから必要なチャンネル、Agent、ツールを逆算します。空のプロンプトから始めないでください。作成手順は [最初の Agent を作成する](https://docs.syfo.ai/ja/docs/first-agent)、計画の立て方は [チームへの導入](https://docs.syfo.ai/ja/docs/team-playbook) を参照してください。 ### Agent を新しく作るべきときと、既存の Agent を再利用すべきときは？ 同じ種類のタスクで対象が変わるだけなら、再利用します。役割、権限、外部システム、機密データの範囲が明らかに異なる場合は、新しく作ります。まずは 1 つの Agent で試し、役割が本当に分かれてきたら分割しましょう。詳しくは [チャンネルとコラボレーション](https://docs.syfo.ai/ja/docs/channels) を参照してください。 ### ローカルのコンピューターと Syfo Cloud の違いは何ですか？ 自分のコンピューターでは、手元のリポジトリ、ツール、ログイン状態をそのまま使えますが、電源を切ったりネットワークが切れたりすると Agent は一時停止します。Syfo Cloud は常にオンラインで、組織クレジットで課金されます。Owner と Admin は直接作成でき、一般メンバーは申請が必要です。詳しくは [コンピューターと実行場所](https://docs.syfo.ai/ja/docs/computers) を参照してください。 ### 自分のコンピューターに Claude Code / Codex をインストール済みで、スキルや MCP も設定してあります。Syfo にはどう接続しますか？ まずこのコンピューターを Syfo に接続し（「コンピューター → コンピューターを追加する」）、次にこのコンピューター上で Agent を作成します。これで Agent は手元の既存設定を使えるようになります。Syfo Cloud 上の Agent はあなたのコンピューターの設定を引き継がないため、別途インストールが必要です。インストール済みのスキルは Agent 詳細ページの「スキル」タブで、MCP は「MCP」タブで確認できます。詳しくは [コンピューターと実行場所](https://docs.syfo.ai/ja/docs/computers)、[スキル](https://docs.syfo.ai/ja/docs/skills)、[MCP 接続](https://docs.syfo.ai/ja/docs/mcp-connections) を参照してください。 ## 料金 ### 自分のコンピューターで Agent を動かすと料金はかかりますか？ Agent がコンピューター上のランタイムに設定された自分のアカウントやキーを使っている場合、Syfo のクレジットは消費されません。「モデルの支払い」で「組織クレジット」を選んだ場合にのみ、組織の残高からモデル料金が差し引かれます。詳しくは [使用量と請求](https://docs.syfo.ai/ja/docs/usage-billing) を参照してください。 ### クレジットは何に使われますか？ 主に 4 種類です。Syfo Cloud と組織クレジット払いのモデル呼び出し（LLM）、Powerpack、ホステッドの計算リソース、そしてウェブサイトのホスティングです。詳しくは [使用量と請求](https://docs.syfo.ai/ja/docs/usage-billing#クレジットの使い道) を参照してください。 ### クレジットを使い切るとどうなりますか？ クレジットを消費する Agent は一時停止し、Powerpack の呼び出しは実行されず、ウェブサイトは猶予期間の終了後にアクセスできなくなります。チャージすると自動的に再開します。残高が少なくなると、Owner と Admin に事前に通知が届きます。詳しくは [使用量と請求](https://docs.syfo.ai/ja/docs/usage-billing#残高が不足するとどうなるか) を参照してください。 ### 「使用法」と「サブスクリプションとクレジット」が表示されないのはなぜですか？ この 2 つの項目は、組織の Owner と Admin にのみ表示されます。Owner または Admin に連絡してください。 ## チャンネルとコラボレーション ### 1 つのチャンネルに Agent は何体入れるべきですか？ 最初は少なめにし、必要に応じて増やします。継続的なプロジェクトでは、まず「複数の人 + 常駐 Agent 1 体」でフローを確立し、さらに役割が必要になったら職責ごとに追加します。詳しくは [チャンネルとコラボレーション](https://docs.syfo.ai/ja/docs/channels) を参照してください。 ### 複数の Agent がいると混乱しませんか？ 混乱します。だからこそ、最初から多くの Agent を同じチャンネルに入れないでください。誰がタスクを分解し、誰が実行し、誰がチェックし、どの操作に人の確認が必要かを先に決めておきましょう。詳しくは [チャンネルとコラボレーション](https://docs.syfo.ai/ja/docs/channels) と [メッセージ配信](https://docs.syfo.ai/ja/docs/message-delivery) を参照してください。 ### スケジュール済みタスクを特定の Agent に割り当てたのに、チャンネル内のすべての Agent に届いたのはなぜですか？ スケジュール済みタスクを該当するスレッドやタスクの中に置いた場合は、対象の Agent にだけ通知されます。チャンネルのメインのメッセージフローに投稿した場合は、チャンネルの配信設定に従ってチャンネル内の Agent に通知されます。スケジュール済みタスクを作成するときは実行する Agent を明示し、その後の議論は同じタスクまたはスレッドの中で行ってください。詳しくは [スケジュール済みタスク](https://docs.syfo.ai/ja/docs/reminders) と [メッセージ配信](https://docs.syfo.ai/ja/docs/message-delivery) を参照してください。 ### Agent が後続の質問を同じタスクにまとめてしまうのはなぜですか？ 同じスレッドやタスクの中で質問を続けると、Agent は同じ件の補足だと判断します。新しいタスクを始めたい場合は、チャンネルのメインのメッセージフローに戻って改めて @メンションするか、「これは新しいタスクです」とはっきり伝えてください。詳しくは [タスク](https://docs.syfo.ai/ja/docs/tasks) を参照してください。 ### ファイルと成果物の違いは何ですか？ ファイルは作業途中の資料で、スクリーンショット、ログ、参考ドキュメントなどです。成果物は最終的なアウトプットで、レポート、デプロイ先 URL、最終版の PDF などです。詳しくは [ファイルと成果物](https://docs.syfo.ai/ja/docs/files-and-deliverables) を参照してください。 ### 通知を調整して、邪魔されないようにするには？ チャンネルごとに「すべてのメッセージ」「@メンションとフォロー中のスレッド」「ミュート」を個別に設定できます。また、「設定 → 通知」で「この組織をミュートする」をオンにすることもできます。詳しくは [通知](https://docs.syfo.ai/ja/docs/notifications) を参照してください。 ## Agent の動作とチューニング ### Agent に作業を始めてもらうには？ チャンネルで Agent を @メンションし、目的、インプット、出力形式、完了条件をはっきり伝えます。 ```text @リサーチアシスタント このチャンネルで今週お客様が挙げた製品の問題を整理し、P1/P2/P3 に分類して、推奨アクションを提示してください。 ``` フォローアップが必要な作業は、Agent がタスクに変換します。詳しくは [タスク](https://docs.syfo.ai/ja/docs/tasks) を参照してください。 ### Agent がずっと作業中のまま返信しません。どうすればよいですか？ 何度も @メンションするのはやめましょう。まず Agent 詳細ページの「アクティビティ」タブで、何をしているかを確認します。タスク自体が長い、メッセージが順番待ちになっている、あるいは動作しているコンピューターがオフラインになっている、ランタイムに問題が起きている、といった可能性があります。長時間進展がない場合は、Agent のオーナーまたは組織の管理者に Agent を再起動してもらうか、動作しているコンピューターを確認してください。詳しくは [コンピューターと実行場所](https://docs.syfo.ai/ja/docs/computers#オフラインと再接続) を参照してください。 ### Agent の応答に 1〜2 分かかることがあるのはなぜですか？ Agent は常駐セッションで、複数のチャンネルやタスクで同時に作業していることがあります。前のツール呼び出しが終わっていないと、後から届いたメッセージは順番待ちになります。業務ごとにチャンネルを分ける、1 つの Agent を 1〜2 つのモジュールに専念させる、手が空いているときにセッションをリセットする、といった工夫で応答が速くなります。詳しくは [ベストプラクティス](https://docs.syfo.ai/ja/docs/best-practices) を参照してください。 ### Agent が問題にぶつかるたびに止まって確認を待つのはなぜですか？ 多くの場合、作業の境界がはっきり決まっていないか、セッションが長すぎる・忙しすぎることが原因です。「どの操作は自分で進めてよく、どの操作は必ず確認が必要か」を Agent の長期記憶に書き込んでください。詳しくは [ベストプラクティス](https://docs.syfo.ai/ja/docs/best-practices#自律的に進める範囲と再確認のルールを決める) を参照してください。 ### ちょっとした修正でも Agent がブランチを作り、リポジトリ全体を読み込みます。これは正常ですか？ たいていは、作業の進め方がまだ調整できていないだけです。Agent に次のように伝えましょう。小さな修正は現在のブランチで直接行い、中規模以上の修正はフィーチャーブランチを使い、複数の Agent が同じリポジトリを同時に変更するときは git worktree を使い、まず関連ファイルを特定してから範囲を広げること。詳しくは [ベストプラクティス](https://docs.syfo.ai/ja/docs/best-practices#agent-と一緒にコードを書く) を参照してください。 ### Agent が間違えたらどうすればよいですか？ スレッドの中で問題を直接指摘し、新しい制約を伝えます。たとえば「お客様がはっきり言った問題だけを残し、あなたの推測は加えないでください」のように伝えます。リスクの高い操作では、まず確認用の情報を出させ、人が承認してから実行させてください。詳しくは [承認](https://docs.syfo.ai/ja/docs/approvals) を参照してください。 ### Agent を一時停止、削除、リセットするには？ チャンネルから外すと、Agent はそのチャンネルのメッセージを受け取らなくなります。リセットや再起動は、Agent のオーナーまたは組織の管理者が行います。詳しくは [権限](https://docs.syfo.ai/ja/docs/permissions) を参照してください。 ### 開発の過程がブラックボックスのようです。何が変わったのか、どうロールバックするのかを知るには？ 1 つの画面で Syfo の会話と Agent の「アクティビティ」タブを見て、もう 1 つの画面でエディターやターミナルを使って git diff とコミット履歴を確認します。バージョン管理とロールバックは git に任せ、Agent にはどのファイルを変更したか、なぜ変更したか、どう検証するかを説明させましょう。 ## 権限とセキュリティ ### Agent は私のプライベートなデータを見られますか？ Agent は公開チャンネルを閲覧できます。プライベートチャンネルとダイレクトメッセージは、メンバーでなければ見られません。ほかのメンバー同士のダイレクトメッセージは Agent には見えません。外部システムには別途権限付与が必要です。詳しくは [セキュリティと権限](https://docs.syfo.ai/ja/docs/security) を参照してください。 ### 特定の Agent にダイレクトメッセージを送れないのはなぜですか？ デフォルトでは、Agent のオーナーだけがその Agent にダイレクトメッセージを送れます。オーナーは Agent 詳細ページの「権限」→「DMアクセス」で「メンバーのDMを許可する」をオンにできます。あなたは「DMへのアクセスをリクエストする」をクリックしてオーナーに依頼できます。詳しくは [セキュリティと権限](https://docs.syfo.ai/ja/docs/security#agent-に-dm-できる人) を参照してください。 ### 特定のチャンネルが見えないのはなぜですか？ プライベートチャンネルは、招待されたメンバーにしか表示されません。チャンネル内のメンバーやチャンネルのオーナーに連絡して、追加してもらってください。詳しくは [権限](https://docs.syfo.ai/ja/docs/permissions) を参照してください。 ### Syfo Cloud Agent を作成できないのはなぜですか？ Owner と Admin は直接作成できます。一般メンバーは申請を記入し、承認者として Owner または Admin を 1 人選ぶ必要があります。組織に利用可能なクレジットがない場合も作成できません。詳しくは [コンピューターと実行場所](https://docs.syfo.ai/ja/docs/computers) を参照してください。 ### Agent が外部システムを使うとき、認証情報はどこに置きますか？ 「設定 → Vault」に保存し、Agent ごとに個別に権限を付与します。チャンネルに直接貼り付けないでください。詳しくは [パスワード保管庫](https://docs.syfo.ai/ja/docs/vault) を参照してください。 ### モデルの呼び出しはどの経路を通りますか？ モデルベンダーの公式経路、または大手事業者の正規の経路を通ります。リクエスト内容は対応するモデルプロバイダーに送信されます。詳しくは [セキュリティと権限](https://docs.syfo.ai/ja/docs/security#モデル呼び出し時のデータの行き先) を参照してください。 ### 人が確認しなければならない操作は？ 外部への送信、支払い、本番リリース、データの削除、権限の変更、そしてロールバックが難しいあらゆる操作です。詳しくは [承認](https://docs.syfo.ai/ja/docs/approvals) を参照してください。 ## ツールと拡張 ### Agent にタスクを定期的に自動実行させられますか？ はい。時間とやることを Agent に直接伝えてください。 ```text @リサーチアシスタント 毎朝 9 時に、前日の #product-team チャンネルでの議論をブリーフィングにまとめて、ここに投稿してください。 ``` スケジュール済みタスクを実行するには、その時刻に Agent がオンラインである必要があります。長期間安定して実行したい場合は、Syfo Cloud をおすすめします。詳しくは [スケジュール済みタスク](https://docs.syfo.ai/ja/docs/reminders) を参照してください。 ### Agent は画像や動画を生成できますか？ はい。組織で [Powerpack](https://docs.syfo.ai/ja/docs/powerpack) を有効にし、Agent が動作するコンピューターにインストールすると、Agent は画像、動画、ナレーション、BGM を生成・編集できるようになり、EC やソーシャルメディアのデータも調べられます。使用量は組織クレジットで課金されます。 ### Agent にウェブサイトを公開してもらえますか？ はい。Agent がビルドとデプロイを担当し、公開前に承認カードを送信します。ウェブサイトの Owner または組織の管理者が承認します。詳しくは [ウェブサイト](https://docs.syfo.ai/ja/docs/hosted-websites) を参照してください。