Discourse AI - Web アーティファクト

ドキュメント サイト管理
1

AI アーティファクトとは？

AI アーティファクトは、Discourse の投稿内で動的な Web ベースのコンポーネントを作成、埋め込み、対話することを可能にする強力なツールです。これらのコンポーネントにはカスタム HTML、CSS、JavaScript を含めることができ、以下のような多様なユースケースを実現します。

  • 双方向のクイズやフォームの埋め込み。
  • リッチなグラフィックやアニメーションによるデータの可視化。
  • 軽量な Web アプリケーションやツールの統合。
  • Web フレームワーク、JavaScript ライブラリなどの学習ツール。

AI アーティファクトは、セキュリティを確保したまま双方向性を追加することで、Discourse の投稿をシームレスに強化します。

サイト設定

管理者は以下の設定を構成できます。

1. 機能の有効化

  • 設定: discourse_ai_enabled
    • AI アーティファクトが機能するには、このグローバル設定が有効になっていることを確認してください。

2. セキュリティモード

  • 設定: ai_artifact_security
    • オプション:
      • disabled: アーティファクトシステムを無効化
      • lax: アーティファクトはユーザーの操作を必要とせず、投稿に自動的に表示されます。
      • hybrid: デフォルトではアーティファクトを実行するにはクリックが必要ですが、投稿作成者は埋め込みマークアップに data-ai-artifact-autorun を追加して、特定のアーティファクトを即座に実行させることができます。
      • strict: ユーザーはブラウザで「表示」または「実行」ボタンをクリックして、アーティファクトを明示的にアクティブにする必要があります。セキュリティを重視する環境ではこの設定が推奨されます（デフォルト）。

3. アーティファクト作成者のアクセス権

  • デフォルトでは、アーティファクト作成者エージェントはスタッフユーザーのみに制限されています。この制限により、信頼された人物のみがアーティファクトを作成でき、不適切または悪意のある使用のリスクを最小限に抑えます。
  • より広範なアクセスが必要な場合は、サイト管理者が手動で権限を構成する必要があります。

投稿での AI アーティファクトの使用

アーティファクトは、必要に応じてアーティファクト作成者エージェントによって自動的に作成されます。

上記のアーティファクトは GPT-4o と anime.js ライブラリを使用して生成されました

作成されると、それらはあなたとアーティファクト作成者エージェントのみにプライベートになります。AI 会話を共有できるユーザー（ai bot public sharing allowed groups に所属するユーザー）は、会話を共有することでアーティファクトを公開することもできます。

共有されたら、以下の HTML マークアップを使用して投稿内でレンダリングできます。

<div class="ai-artifact" data-ai-artifact-version="3" data-ai-artifact-id="71"></div>

（バージョンとアーティファクト ID は、あなたのバージョン管理されたアーティファクトです）

セキュリティ上の考慮事項

AI アーティファクトはカスタム作成された HTML、CSS、JavaScript を実行できるため、Discourse は堅牢な保護対策を実装しています。

1. iFrame 内のサンドボックス化

  • アーティファクトは、以下の潜在的に危険な操作を制限する sandbox 属性を持つ隔離された iframe コンテナ内でレンダリングされます。
    • クロスサイトスクリプティング（XSS）。
    • 外部サイトや API へのアクセス。

2. コンテンツセキュリティポリシー（CSP）

3. セキュリティモード

  • 厳格モード: アーティファクトが完全に信頼されていない環境では推奨されます。ユーザーはレンダリング前にブラウザでアーティファクトを手動でアクティブにする必要があります。

4. アクセスと権限

  • アーティファクトは以下のユーザーにのみ表示されます。
    • 作成者。
    • 関連する投稿を表示する権限を持つユーザー（例：プライベートメッセージ）。
  • 公開アーティファクトは、AI 会話を共有することで明示的にそのようにマークする必要があります。

5. 長さの制限

  • アーティファクト内の HTML、CSS、JavaScript のサイズは、それぞれ 64 KB に制限されています。これにより、コンポーネントが軽量に保たれ、ユーザーやシステムに負荷をかけないようにしています。

アーティファクトのストレージ

Web アーティファクトは、オプションでユーザーごとのデータを保存できます。そのためには、アーティファクト作成者に「ユーザーストレージを使用する」などの指示を出してください。

このシステムでは、以下のキーと値のペアを保存できます。

  • プライベート（管理者と特定のユーザーにのみ表示）
  • 公開（匿名を含むすべてのユーザーに表示）

キーと値のペアは、アーティファクトが作成された投稿に対して保護されていますが、アーティファクトを公開して共有すると、すべてのユーザーがキーを追加できるようになります。

ストレージを制御するには、以下の非表示設定を使用できます。

  • ai_artifact_kv_value_max_length（デフォルトでは項目は 5000 文字以下）
  • ai_artifact_max_keys_per_user_per_artifact（デフォルト 100）

よくある質問（FAQ）

誰が AI アーティファクトを作成できますか？

デフォルトでは、スタッフユーザー（管理者やモデレーターなど）のみが、アーティファクト作成者エージェントを通じてアーティファクトを作成できます。このエージェントは、HTML、CSS、JavaScript を使用した双方向の Web ウィジェットを設計するプロセスを簡素化します。

アーティファクトをクリックするとどうなりますか？

  • lax モードでは、アーティファクトは自動的に表示されます。
  • hybrid モードでは、デフォルトではクリックが必要ですが、埋め込みに data-ai-artifact-autorun が含まれている場合は自動実行されます。
  • strict モードでは、「実行」ボタンをクリックするとアーティファクトがアクティブになり、ブラウザに読み込まれます。

AI アーティファクトは安全ですか？

はい。AI アーティファクトは厳密に制御された環境で実行されます。

  • サンドボックス化されており、iframe メッセージングを介してのみ Discourse アプリケーションやユーザーコンテキストと直接対話することはできません。
  • 厳格モードにより、アクティブ化を制御できます。
  • アーティファクトはデフォルトでプライベートであり、グローバルアクセスを付与するには積極的に共有する必要があります。

アーティファクトのソースコードを確認できますか

はい。Discourse AI がアーティファクトを生成すると、完全なマークアップ、CSS、JavaScript が含まれます。

どの LLM がサポートされていますか？

アーティファクトは、設定している任意の LLM を使用して生成できますが、さまざまな LLM はアーティファクト作成に特化しており、より細かく調整されています。

o3、Anthropic Claude Sonnet 3.7 - 4.0、GPT-4.1、Gemini Pro 2.5 などで良好な結果が得られています。一般的に、より高度なモデルの方が優れた結果をもたらします。

アーティファクトの作成には試行錯誤の要素が大きく、実験が鍵となります。

「いいね！」 23
Announcing: AI Web Artifacts
Could AI artifacts be a blueprint how to enable H5P content in discourse?
AI Artifact User storage
Improving your results from the "Web Artifact Creator" bot with the Prompt Master bot
Button to delete reply becomes one to delete topic after deleting reply
Announcing: AI Web Artifacts
3

アーティファクトのプライバシー設定をもう少し細かく制御できるようになると、特定のグループとだけ共有できるようになり、非常に便利です。これは、現在のカテゴリ権限の仕組みと非常によく似ています :smiley:

4

グループをボットのPMに追加するとうまくいくかもしれません。

「いいね！」 1
5

試してみて、ここで報告します。私には、アーティファクトが1つのプライベートカテゴリーの1つのグループのみがアクセスできる必要があるニッチなユースケースがあります。

「いいね！」 1
6

Web Artifact Creator ボットをプライベートカテゴリの新しいトピックでメンションしました。このグループはそのカテゴリにアクセスできるため、私と特定のグループのみが閲覧できるアーティファクトを作成できます。しかし、アーティファクトの iframe ウィンドウには、ユーザーが特定のページにアクセスできない場合に表示されるデフォルトの「おっと！そのページは存在しないか、プライベートです。」しか表示されません。

そこで、誰がそのトピックを閲覧できるかを確認するためにデータエクスプローラークエリを作成しました。データベースによると、そのアーティファクトを 閲覧できるはずの グループのユーザーは、閲覧できると表示されています。

これはバグでしょうか？

私のSQLクエリ 
-- [params]
-- int :artifact_id = 22

WITH artifact_info AS (
  SELECT
    a.id,
    a.user_id as creator_id,
    a.post_id,
    p.topic_id,
    t.category_id,
    t.archetype,
    c.read_restricted,
    t.title as topic_title
  FROM ai_artifacts a
  LEFT JOIN posts p ON a.post_id = p.id
  LEFT JOIN topics t ON p.topic_id = t.id
  LEFT JOIN categories c ON t.category_id = c.id
  WHERE a.id = :artifact_id
),
users_with_access AS (
  -- クリエイターは常にアクセスできます
  SELECT
    ai.creator_id as user_id,
    'Creator' as access_reason
  FROM artifact_info ai

  UNION

  -- プライベートメッセージにアクセスできるユーザー
  SELECT
    tau.user_id,
    'Private Message Access' as access_reason
  FROM artifact_info ai
  JOIN topic_allowed_users tau ON ai.topic_id = tau.topic_id
  WHERE ai.archetype = 'private_message'

  UNION

  -- プライベートメッセージにアクセスできるグループのメンバー
  SELECT
    gu.user_id,
    'Private Message Group Access' as access_reason
  FROM artifact_info ai
  JOIN topic_allowed_groups tag ON ai.topic_id = tag.topic_id
  JOIN group_users gu ON tag.group_id = gu.group_id
  WHERE ai.archetype = 'private_message'

  UNION

  -- プライベートカテゴリにアクセスできるユーザー
  SELECT
    gu.user_id,
    'Category Group Access' as access_reason
  FROM artifact_info ai
  JOIN category_groups cg ON ai.category_id = cg.category_id
  JOIN group_users gu ON cg.group_id = gu.group_id
  WHERE ai.read_restricted = true
    AND ai.archetype != 'private_message'
    AND cg.permission_type IN (1, 2) -- 完全アクセスまたは作成/返信/表示
  
  UNION

  -- トピックが公開されている場合（制限がなく、プライベートメッセージではない場合）のすべてのユーザー
  SELECT
    u.id as user_id,
    'Public Access' as access_reason
  FROM artifact_info ai
  CROSS JOIN users u
  WHERE (ai.read_restricted = false OR ai.read_restricted IS NULL)
    AND (ai.archetype != 'private_message' OR ai.archetype IS NULL)
    AND u.active = true
)

SELECT
  u.id as user_id,
  u.username,
  u.name,
  u.trust_level,
  uwa.access_reason,
  ai.topic_title
FROM users_with_access uwa
JOIN users u ON uwa.user_id = u.id
CROSS JOIN artifact_info ai
WHERE u.active = true
ORDER BY u.username