よくある質問

最初の作成、制御された公開、日常運用でよくある質問です。

最初の Agent を作る

Template を使うべきですか、空白から始めるべきですか？

Template の仕事と境界が自分の状況に近い場合は Template を使います。Agent 作成前にすべての生成項目を確認します。

合う Template がない場合、または必要な動作が明確な場合は空白から始めます。どちらも同じ Agent Editor と検証フローに戻ります。

テスト前に Knowledge Base を完成させる必要がありますか？

いいえ。実際の状況に必要な最小の source of truth から始めます。

失敗した case が知識不足または古い情報を原因として示したときに content を追加します。すべての document を最初に upload すると、scope と診断が難しくなる場合があります。

Case は何件必要ですか？

すべての Agent に共通する固定件数はありません。

実際の状況一つと、いくつかの隣接する境界から始めます。制御された pilot の前に、頻度、失敗時の影響、ツール利用、handoff risk に応じて case set を増やします。正式な受け入れでは、version、case set、Standards、must-pass 条件の固定が必要な場合があります。

Test Suite の強い Standard とは何ですか？

曖昧な希望や一つの固定文ではなく、観察可能な要件を書きます。

結果が行うこと、避けること、Agent が handoff する条件を示します。別の reviewer が推測せず pass または fail を判断できるようにします。

公開とリリース

Agent を変更するたびに公開が必要ですか？

Draft の変更は利用者に影響しません。変更の準備ができたら、対象の Agent version を公開します。

チャネル設定も変更した場合は、チャネルを別に公開します。

Live URL は開くのに、利用できる Agent がないのはなぜですか？

最も一般的な原因は、チャネルは存在するが Agent version が公開されていないことです。

AIエージェント に戻り、対象 version を公開して live URL を再確認します。

Web チャネルと API access はどう使い分けますか？

ホストされた pilot または顧客体験を最も早く作る場合は Web チャネルを使います。

自社製品で client と連携動作を管理する場合は API access を使います。

会話と改善

利用者が人の返信を待っている場合はどうしますか？

有人返信待ち と表示された会話を開きます。

有人返信がオフの場合は CRMを開く を使い、対象の customer-Agent pair を 人対応にする に切り替えます。直接作成するか AI下書き を生成し、最終内容を確認して、利用可能な場合は元のチャネルから 送信 します。

AI下書きは自動で返信を送りますか？

いいえ。AI下書きは提案だけを作ります。

Workspace member が適用またはコピーし、返信を編集し、提案された form を確認して、最後に 送信 をクリックします。

誤った会話を再利用できる case にするには？

会話 で thread を開き、Add Case を使います。

必要な context を残し、確認可能な Standard を書き、原因を診断して、限定した変更後に case を再実行します。

一つの case に合格すれば Agent の準備は完了ですか？

いいえ。その実行で、確認した version が case 条件を満たしたことだけを示します。

リリース判断に応じて must-pass、boundary、tool、handoff、regression case を用意します。公開後も実際の会話を確認します。

データとアクセス

更新した Notion または Google Drive のファイルが Agent に反映されないのはなぜですか？

接続済み content を管理された snapshot として扱います。

元情報に重要な変更があったら接続済み copy を更新し、関連する case を再実行します。

Whitelist mode はいつ使いますか？

初期 pilot や限定した専門家レビューなど、rollout を制御する場合は Whitelist を使います。

許可する利用者は 顧客 で管理します。

Organization と Workspace の違いは何ですか？

Organization は広いチーム境界です。

Workspace は特定の Agent、チャネル、会話、顧客、運用担当者、データ境界を一緒に管理する場所です。

追加のヘルプ

実際の会話で再現する問題がある場合は、次を行います。

利用者の目の前の必要に対応する。
Add Case で状況を残す。
問題が期待動作、instructions、情報源、tool、scope のどこにあるか判断する。
関係する最小の変更を行う。
再公開前に影響する case を実行する。