integrate-atlas-chat
cognitedata/builder-skills
Integrate streaming Atlas Agent chat UI into Flows apps with automatic component and hook setup.
What is integrate-atlas-chat?
Adds a production-ready chat interface for Atlas agents to Flows applications. Use this skill whenever you need to build a chat UI that streams responses from Atlas agents—it handles all the integration boilerplate so you don't have to manually wire useAtlasChat hooks and components.
- Installs Atlas chat dependencies and configuration into your Flows app
- Sets up streaming chat component structure for agent responses
- Wires useAtlasChat hook integration automatically
- Configures agent external ID binding
- Handles component lifecycle and message state management
- Prepares app for downstream tool and Python setup
How to install integrate-atlas-chat
npx skills add https://github.com/cognitedata/builder-skills --skill integrate-atlas-chat- Flows app project initialized
- Atlas agent created with an external ID
- Access to Cognite documentation and builder-skills repository
How to use integrate-atlas-chat
- 1.Run: npx skills add https://github.com/cognitedata/builder-skills --skill integrate-atlas-chat
- 2.Provide your Atlas agent's external ID when prompted
- 3.Review the generated chat component and hook integration in your app
- 4.Verify the streaming chat UI renders correctly in your Flows app
- 5.Next: run create-client-tool skill for each tool your agent needs
- 6.Finally: run setup-python-tools skill if your agent uses Python tools
Use cases
- Building a conversational interface for an Atlas agent in a Flows application
- Adding real-time streaming chat responses from AI agents to an existing app
- Setting up a multi-turn chat UI that integrates with Atlas agent tools
- Creating a chat-based workflow where users interact with agents through a UI
- Establishing the foundation for a complete agent chat application before adding custom tools
- Flows app developers building agent-powered chat interfaces
- Teams integrating Atlas agents into existing applications
- Developers creating conversational AI experiences with streaming responses
- Full-stack engineers setting up end-to-end agent chat workflows
integrate-atlas-chat FAQ
Use this skill whenever you're building a chat UI for Atlas agents in a Flows app. It's a required first step before adding tools or Python integrations.
It installs the useAtlasChat hook, chat component structure, streaming configuration, and wires everything to your agent's external ID automatically.
Not recommended. The skill handles complex boilerplate and ensures proper hook wiring. Manual implementation risks missing critical setup steps.
(1) integrate-atlas-chat, (2) create-client-tool for each tool, (3) setup-python-tools if needed.
See the full guide at https://docs.cognite.com/cdf/flows/guides/ai_agent_integration
Full instructions (SKILL.md)
Source of truth, from cognitedata/builder-skills.
name: integrate-atlas-chat description: "MUST be used whenever building a chat UI with Atlas agents in a Flows app. Do NOT manually write useAtlasChat integration code — this skill handles installation, component structure, and hook wiring. Triggers: useAtlasChat, atlas chat, streaming chat, agent chat, chat interface, chat component, chat UI. For a full chat app, run skills in order: (1) integrate-atlas-chat, (2) create-client-tool (per tool), (3) setup-python-tools (if Python tools needed)." allowed-tools: Read, Glob, Grep, Edit, Write, Bash metadata: argument-hint: "[agent-external-id]"
Integrate Atlas Agent Chat
Follow the guide at https://docs.cognite.com/cdf/flows/guides/ai_agent_integration to add a streaming Atlas Agent chat UI to this Flows app.
Agent external ID: $ARGUMENTS
Related skills
More from cognitedata/builder-skills and the wider catalog.

integrate-file-viewer
Integrate CogniteFileViewer into Flows apps to preview CDF files (PDFs, images, text) with zero manual setup.

integrate-fusion-agent
Integrate your Flows/Dune app with Fusion's built-in PAIA agent panel using @cognite/app-sdk.

integrate-todo-list
Add structured task tracking to Flows apps with Atlas chat integration.

migrate-app-to-flows
Orchestrate full migration of legacy Dune apps to Flows app hosting infrastructure.

performance
Find and fix performance issues in Flows apps—re-renders, inefficient queries, pagination, and memory leaks.

pull-changes-resolve-conflicts
Safely integrate branch changes by analyzing conflicts before resolving, preserving intentional work.