cognitedata avatar

Integrate Fusion Agent

Wires your Flows or Dune app into Fusion's built-in PAIA agent panel using @cognite/app-sdk. It handles three pieces: opening the agent sidebar from a button, sending contextual messages to inject app state into the chat, and registering an agent server so PAIA can read your app's resources and call actions back into it. The skill sets up the correct lifecycle with graceful fallback when running outside Fusion, uses Comlink proxy patterns that won't break React state, and scaffolds a clean separation between action definitions and registration hooks. Saves you from reading the SDK docs and gets the boilerplate right the first time.

skills.sh installs
1.7K
GitHub stars
6
last updated
Aug 21, 2026

Install

$ npx -y skills add cognitedata/builder-skills --skill integrate-fusion-agent --agent claude-code

Installs into .claude/skills of the current project.

Files

Integrate Atlas / EOS Sidebar

Default AI path: the platform Atlas sidebar (EOS / Fusion PAIA) via @cognite/app-sdk. Do not embed useAtlasChat, vendor atlas-agent, or call third-party LLM APIs.

integrate-atlas-chat only if the user explicitly requires in-app chat and connectToHostApp cannot provide the sidebar (standalone app; always rejects). There is no manifest field for this.

Implement only what is needed:

  1. Open — Topbar Atlas button; sendAgentLayoutMode for in-app triggers
  2. Message — sendAgentMessage to inject context
  3. Server — resources (app state) and actions (tools)

Step 0 — Read the app

  • package.json — package manager, @cognite/app-sdk
  • src/App.tsx — structure, existing SDK usage

Ask which of the three capabilities are needed. Do not offer an in-app chat unless they already insisted.


Step 1 — Install

pnpm add @cognite/app-sdk (or npm/yarn). Minimum 0.3.1.


Step 2 — Connect to the host

connectToHostApp rejects outside Fusion (standalone vite dev). Catch that; hide agent triggers when api is null.

Sponsors

Details

Repository
github.com/cognitedata/builder-skills
Categories
Backend & APIs, Documentation, AI & Agent Building
First seen
Jul 14, 2026

More from cognitedata/builder-skills

All 26
1onmax avatarnuxt-studioonmax/nuxt-skillsConfigure and operate the self-hosted Nuxt Studio editor for Nuxt Content. Use when working with nuxt-studio installation, editor customization, OAuth or custom1.7Kskills.sh installs
2adobe avatarbuilding-blocksadobe/skillsUse this when implementing code changes in AEM Edge Delivery Services (EDS, Franklin, Helix), whether new or modified blocks, core functionality (scripts.js, st1.7Kskills.sh installs
3antvis avataricon-retrievalantvis/chart-visualization-skillsSearch icons through HTTP API and retrieve SVG strings with curl.1.7Kskills.sh installs
4adobe avatarcontent-driven-developmentadobe/skillsApply a Content Driven Development process to AEM Edge Delivery Services development. Use for ALL code changes - new blocks, block modifications, CSS styling, b1.6Kskills.sh installs
5hieutrtr avatare2e-testinghieutrtr/ai1-skillsEnd-to-end testing patterns with Playwright for full-stack Python/React applications. Use when writing E2E tests for complete user workflows (login, CRUD, navig1.6Kskills.sh installs
6astronomer avatarmanaging-astro-local-envastronomer/agentsManage local Airflow environment with Astro CLI (Docker and standalone modes). Use when the user wants to start, stop, or restart Airflow, view logs, query the 1.6Kskills.sh installs