完全なチュートリアル
エンドツーエンドのウォークスルー: サインアップからウェブサイトでのヘルパーの動作まで
このチュートリアルでは、AI Anywhereをウェブサイトに統合する完全なプロセスを案内します。最後まで進めば、ユーザーにインテリジェントなテキストアシスタンスを提供する完全に機能するヘルパーが完成します。
ヘルパーを使用する2つの方法
すべてのヘルパーは2つの方法で利用可能です:
- ヘルパーページ(コード不要): You get a shareable Helper Page link instantly. Open it from the dashboard by going to your Helper and clicking the "Helper Page" button (on the Helper's edit or detail page). Share the link with anyone; no snippet or integration required.
- サイトに埋め込む: 小さなスクリプトとアンカーをウェブサイトに追加して、ヘルパーボタンがテキストエリアの横に表示されるようにします。ユーザーはページを離れることなく支援を受けられます。
このチュートリアルは埋め込みオプションに焦点を当てています。Helperページを使用するには、ダッシュボードでHelperを作成し、「Helperページ」をクリックしてリンクを開くか共有します。
アカウントを作成
まず、AI Anywhereアカウントにサインアップする必要があります。
- 次に移動: AI Anywhere ホームページ
- クリック "始める" ヘッダーのボタン
- お好みのソーシャルアカウント(Google、GitHubなど)でサインアップしてください
- You'll be automatically logged into your dashboard
最初のヘルパーを作成
次に、ユーザーがコンタクトフォームメッセージを書くのを支援するヘルパーを作成しましょう。
- ダッシュボードに移動 "新しいヘルパー"
- ヘルパーに「」のような説明的な名前を付けてください
"お問い合わせフォームの例" - このヘルパーが属するグループを選択してください
- クリック "ヘルパーを保存"
ヘルパーを設定
ヘルパーを作成または編集する際に設定するもの:
- ヘルパーアンサー: Enter a well-written example of what you want users to write. For a contact form, this might be a complete, professional message that includes all necessary information. The example should be complete with mock names, specific details, and realistic content (e.g., "Hello, I'm John Smith writing to inquire about your web development services. I'm particularly interested in building an e-commerce platform for my business. Could you please provide more information about your pricing and timeline? Thank you for your time.").
- キーワードおよび/またはルール: ユースケースに重要なキーワードやルールを追加してください(例:「連絡」、「問い合わせ」、「質問」、「サポート」)。
- ボタンテーマ設定 サイトのデザインに合わせて、ヘルパーボタンの外観(色、テキスト)をカスタマイズします。
統合コードを取得
テキストエリア、フォーム、入力フィールドのCSSセレクタを見つけて、AI Anywhereヘルパーをウェブサイトに統合する方法を学びましょう。
- ヘルパー設定で、 "スニペットを生成" ボタンをクリックします
- 2つのコードスニペットが表示されます:
- スクリプトタグ: サイトに貼り付け
- アンカースパン: ヘルパートークンを含む
- 両方のスニペットをコピーしてください - 次のステップで必要になります
スニペットは2つの部分で構成されています:
<!-- スクリプトタグ(<head>に配置) -->
<script src="https://ai-anywhere.ai/sdk/v1/loader.js" data-site="your-site-id"></script>
<!-- 例:テキストエリアの横にヘルパーボタンが表示されます -->
<span data-helper-anchor data-helper-token="your-helper-token"></span>
<head> セクションはすべてのページで同じです。ヘルパートークンを含むアンカースパンは、ヘルパーを表示したい各テキストエリアの隣に配置します。
HTMLにスクリプトを追加
ヘルパースクリプトを読み込む
- ウェブサイトのHTMLファイル(またはテンプレート)を開いて、次を見つけてください
- 見つける
<head>セクション - セクション。スニペットを閉じタグの直前に貼り付けてください
</head>タグ。
このように見えるはずです:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>お問い合わせ:</title>
<!-- ヘルパースクリプトの埋め込み -->
<script src="https://ai-anywhere.ai/sdk/v1/loader.js" data-site="your-site-id"></script>
</head>
<head> セクションは、メタタグの後、他のスクリプトの前に配置します。これにより、ヘルパーが早期に読み込まれます。
フォームにヘルパーアンカーを追加
次に、ヘルパーボタンを表示したいテキストエリアの隣にアンカースパンを追加します。
- 連絡フォーム(またはヘルパーを配置したいフォーム)を見つける
- ユーザーがメッセージを入力するテキストエリアを見つける
- テキストエリアの直後(または近くの場所)にアンカースパンを追加します
こちらは両方の部分を示す完全な例です:
<form id="contact-form">
<div>
<label for="name">名前</label>
<input type="text" id="name" name="name" required>
</div>
<div>
<label for="email">メール:</label>
<input type="email" id="email" name="email" required>
</div>
<div>
<label for="message">あなたのメッセージ:</label>
<textarea id="message" name="message" rows="6" required></textarea>
<!-- ヘルパーボタンはこの要素の隣に表示されます。 -->
<span data-helper-anchor data-helper-token="your-helper-token"></span>
</div>
<button type="submit">連絡メッセージ:</button>
</form>
ヘルパーをテスト
すべてが正しく動作していることを確認しましょう。
- ヘルパーを保存
- ウェブサイトを開いて
- 連絡フォームのあるページに移動します
- ページのテキストエリアの横にヘルパーボタンがあるか確認してください
私たちが保存するもの
- 例:テキストエリアの横にヘルパーボタンが表示されます
- ボタンは設定した正しいスタイリング(色、テキスト、サイズ)を持っています
- ボタンをクリックすると、ヘルパーインターフェースが開きます
- テキストを入力してヘルパーボタンをクリックすると、提案が表示されます
トラブルシューティング
ヘルパーボタンが
- Check your browser's developer console (F12) for any JavaScript errors
- スクリプトタグが
<head>セクション - アンカースパンが存在し、正しいヘルパートークンを含んでいることを確認してください
- キャッシュされたファイルをクリアするには、ページをハードリフレッシュしてください(Ctrl+Shift+R または Cmd+Shift+R)。
- サイトIDとヘルパートークンが正しいことを確認してください
ヘルパーをカスタマイズ(オプション)
ラベルを「ヘルパー」に設定するか、ブランドに合わせてカスタマイズします。
カスタマイズできる内容
- 外観をカスタマイズ ヘルパーボタンの色とテキストを変更します。
- ヘルパーアンサー: ユーザーに達成してほしい内容を示す高品質な例文を貼り付けてください。
- キーワード: 提案の精度を向上させるためにキーワードを追加または削除する
- 総ヘルパー数: 異なるフォームやテキストエリア用に追加のヘルパーを作成する
カスタマイズ
- ダッシュボードに移動
- 選択 "ヘルパー", 編集したい特定のヘルパーを選択します
- クリック "編集" ボタンをクリックします
- 変更を保存
- 変更を保存
本番環境にデプロイ
すべてをローカルでテストしたら、本番サイトにデプロイする時です。
デプロイ前のチェックリスト
- ローカル/ステージング環境でヘルパーをテスト済み
- ヘルパーボタンが次の要素の横に表示されるはずです:
- 異なるブラウザでテストする:
- モバイルデバイスでテスト済み
- ヘルパーの提案が有用で正確であることを確認済み
遅延したデプロイ
- 更新されたHTMLファイルをウェブサーバーにアップロードする
- スクリプトタグが
<head>ヘルパーボタンを配置したい場所にアンカーを追加 - アンカースパンがテキストエリアの隣に正しく配置されていることを確認する
- ライブサイトでヘルパーをテストする
- 問題やエラーがないか監視する
- 同じスクリプトタグ(サイトID付き)はすべてのページで使用できます
- 各テキストエリアには異なるトークンを持つ独自のヘルパーを持たせることができます
- 異なるフォームフィールドに対して異なる設定で複数のヘルパーを初期化します。
設定ガイド
AI Anywhereをウェブサイトに統合しました!ヘルパーは現在ライブで、ユーザーをサポートする準備ができています。
次は何をしますか?
- について学ぶ 各設定オプションを分解してみましょう:
- 探索する テーマ & カスタマイズ 色の選択がブランドに合っていることを確認する
- タイプミスを確認: コード例 さまざまなユースケースに対応するため
- について読む セキュリティ & プライバシー 機能
- 問題が発生した場合は、こちらをご覧ください トラブルシューティングガイド