mcpField
I
integrate-atlas-chat

integrate-atlas-chat

github.com/cognitedataエージェントワークフロー61.9k 回インストール1 日前に更新
リポジトリ

integrate-atlas-chat について

ホストのAtlasサイドバーが利用できず、ユーザーが承認した場合に、アプリ内へAtlas Agentチャットを組み込む例外用スキルです。ホストとの互換性を先に確認し、既存の製品UIを維持します。

主な機能

  1. 01埋め込みチャットには明示的な承認が必要
  2. 02ホストのサイドバー動作を事前確認
  3. 03Atlasチャット統合ガイドに沿った実装
  4. 04既存の製品UIの維持

活用シーン

  1. 01スタンドアロンアプリへのAtlasチャット埋め込み
  2. 02ホストサイドバーとアプリ内チャットの選択

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/cognitedata/builder-skills --skill integrate-atlas-chat

インストール後、Claude Code で/integrate-atlas-chatを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

code/
client.ts
index.ts
pyodide-react.ts
pyodide-runtime.ts
pyodide.ts
python.ts
react.ts
session.test.ts
session.ts
types.ts
validation.test.ts
validation.ts

詳細

Atlas Agent Chat を統合する（例外的な方法）

停止してください。 以下のすべてに該当しない限り、integrate-fusion-agent（Atlas／EOS サイドバー）を使用してください。

  1. ユーザーが「Atlas を追加」や「チャットを追加」ではなく、アプリ内／埋め込み型のチャットを求めている
  2. ホストの Atlas サイドバーを使用できない。これを判定するマニフェストフィールドはありません。アプリを調査してください。
    • @cognite/app-sdk と connectToHostApp ／ useHostApp が Fusion／EOS 内で解決される → サイドバーを使用できます。続行しないでください
    • スタンドアロン専用（ホストへの接続が常に拒否され、アプリが Fusion 内で読み込まれることがない） → アプリ内チャットが許可されます
    • 不明な場合は質問してください。デフォルトではサイドバーを使用します。
  3. ユーザーがこの標準外の方法を受け入れている

そのうえで、https://docs.cognite.com/cdf/flows/guides/ai_agent_integration に従い、$ARGUMENTS 用に useAtlasChat を接続してください。製品 UI はそのままにし、アプリをチャット画面に置き換えないでください。

DMS の行に対して send() ／チャット補完をマッピングしないでください。項目ごとの補完が必要な場合は、ユーザーの操作 1 回につき 5 件、上限 50 件とし、space:externalId:lastUpdatedTime をキーにキャッシュしてください。integrate-fusion-agent を参照してください。

コメント

Markdown 対応