사용 가이드로 건너뛰기
AI Elements작성자 vercel

AI Elements 스킬.

수정 가능한 React 컴포넌트로 AI 채팅 인터페이스를 만드세요.

  • AI 인터페이스
  • React
소스 검토 · ai-elementsSKILL.md
작업 수정 가능한 React 컴포넌트로 AI 채팅 인터페이스를 만드세요. 결과물 프로젝트에 설정된 컴포넌트 디렉터리에 추가되는 선택한 컴포넌트의 소스 파일. 시작 전 확인 문서에 명시된 전제 조건은 Node.js 18+, Next.js, AI SDK, shadcn/ui입니다.
편집 요약 · 소스 검토일 2026-11-02 · 생성된 예제가 아닙니다

01 기능 소개

수정 가능한 React 컴포넌트로 AI 채팅 인터페이스를 만드세요.

Vercel의 AI Elements 스킬로 수정 가능한 shadcn 기반 React 컴포넌트를 조합해 채팅 메시지, 도구 표시, 프롬프트 입력을 구성하세요.

소스 기반 워크플로실행 벤치마크 아님

작업 방식

AI Elements는 기존 Next.js 애플리케이션에 채팅 전용 컴포넌트를 추가하도록 에이전트를 안내합니다. 대화 화면, 메시지 내용, 도구 표시, 프롬프트 입력을 다룹니다. 컴포넌트가 자신의 리포지터리 안에 있으므로 제품 고유의 스타일과 상호작용 요건에 맞게 인터페이스를 조정할 수 있습니다.

소스는 이 컴포넌트를 AI SDK 및 shadcn/ui의 관례와 연결합니다. 예제는 어시스턴트 응답을 내부를 알 수 없는 하나의 위젯으로 취급하지 않고, 텍스트 부분을 중심으로 메시지의 기본 컴포넌트를 조합합니다. 모델 연동이 이미 되어 있고, 다음 과제가 사용자가 응답을 읽고 답할 일관된 화면을 제공하는 것일 때 유용합니다.

예상 산출물

  • 프로젝트에 설정된 컴포넌트 디렉터리에 추가되는 선택한 컴포넌트의 소스 파일.
  • 메시지와 응답의 기본 컴포넌트를 조합한 React 대화 화면.
  • 프로젝트에 맞춘 스타일과 아직 해결되지 않은 연동 문제에 대한 설명.
예시 브리프 보기

브리프에서 검토까지

  1. 01
    기존 애플리케이션 확인

    패키지 실행 도구, Next.js 구성, AI SDK 의존성, shadcn 설정을 살펴봅니다. 컴포넌트를 추가하기 전에 import 별칭과 전역 스타일을 확인합니다.

  2. 02
    필요한 UI 요소 추가

    프로젝트의 패키지 실행 도구에서 지원되는 컴포넌트 설치 도구를 사용합니다. 대화에 필요한 요소를 선택하고 리포지터리에 추가된 파일을 확인합니다.

  3. 03
    연결하고 조정

    소스 예제처럼 각 메시지의 역할을 Message에 연결하고 MessageContent를 중첩한 다음, 텍스트 부분을 MessageResponse로 렌더링합니다. 도구 실행 결과는 그에 맞는 별도 표시가 필요하며, 텍스트 전용 예제로 표시된다고 가정해서는 안 됩니다. 로컬 Tailwind 클래스를 조정하고 대화의 각 상태를 확인합니다.

02 활용 상황

언제 사용하면 좋을까요

문서에 명시된 전제 조건은 Node.js 18+, Next.js, AI SDK, shadcn/ui입니다.

적합한 경우

  • 수정 가능한 채팅 UINext.js 챗봇에 수정 가능한 메시지 및 입력 컴포넌트가 필요할 때 적합합니다.
  • 기존 shadcn 관례 활용팀이 기존 shadcn 관례 안에서 AI 인터페이스 코드를 조정하려 할 때 적합합니다.

확인할 한계

  • 애플리케이션 전제 조건문서에 명시된 전제 조건은 Node.js 18+, Next.js, AI SDK, shadcn/ui입니다.
  • 백엔드 연동UI 컴포넌트를 추가했다고 해서 모델 인증 정보, 스트리밍 엔드포인트, 도구 실행이 설정되었다는 뜻은 아닙니다.

준비할 입력

  • 프로젝트 구성애플리케이션의 패키지 설정과 컴포넌트 별칭.
  • 메시지 데이터 규격AI SDK 연동부가 제공하는 메시지와 도구 실행 결과의 구조.
  • 인터페이스 방향원하는 대화 레이아웃, 테마, 컴포넌트 선택.

03 핵심 결정

중요한 판단 기준

  1. 소스 코드를 프로젝트에서 직접 관리

    컴포넌트 코드는 제품 리포지터리에서 확인하고 수정할 수 있습니다.

  2. 조합 가능한 응답

    메시지의 기본 컴포넌트를 조합하면 응답에서 별도로 표시해야 할 부분을 다룰 수 있습니다.

  3. 기존 스타일 관례

    기존 Tailwind와 shadcn 관례가 연동을 위한 구체적인 출발점이 됩니다.

04 예시 브리프

목적을 좁힌 요청으로 시작하세요

아래 예시 브리프는 테스트되지 않았습니다. 사용하기 전에 스킬의 설정을 확인하세요.

소스와 설정 확인

애플리케이션의 패키지 설정과 컴포넌트 별칭.

업스트림 소스 파일
https://github.com/vercel/ai-elements/blob/ca8be600bfd01b3131f9bf6134b51602a71f4374/skills/ai-elements/SKILL.md

아래 참고 링크에서 원본 사용 지침을 확인할 수 있습니다. 사용 전에 리포지터리의 설정 요건을 확인하세요. 설치 명령어가 아닙니다.

결과물 하나부터 시작

스킬을 실행하기 전에 이 브리프의 범위, 소스 자료, 제약 조건을 상황에 맞게 조정하세요.

예시 브리프
ai-elements를 사용해 기존 Next.js 애플리케이션에 대화 화면을 만들어주세요. 먼저 패키지 실행 도구, shadcn 설정, 별칭, AI SDK 메시지 구조를 살펴보세요. 이 화면에 필요한 메시지, 응답, 프롬프트 입력 컴포넌트만 추가하세요. 문서에 나온 조합 방식으로 텍스트 부분을 표시하고 현재 테마를 유지하세요. 첫 미리 보기에는 테스트용 메시지 데이터를 사용하세요. 추가한 소스 파일, 기존 채팅 훅과 인터페이스를 연결하는 방법, 아직 검증이 필요한 런타임 의존성을 설명해주세요.

결과 확인

실제 출력을 다음의 관찰 가능한 기준과 비교해 확인하세요.

  • 실제 컴포넌트 위치와 설정된 별칭에서 import가 올바르게 해석됩니다.
  • 메시지 역할과 텍스트 부분이 의도한 테마로 표시됩니다.
  • 에이전트가 작동하는 UI 미리 보기와 실제 모델에 연결해 검증한 대화를 구분합니다.

OpenDesign은 코딩 에이전트를 위한 로컬 디자인 작업 공간을 제공합니다. 이 목록은 스킬이 번들로 포함되어 있거나 외부 도구, 자격 증명, 소프트웨어 의존성이 포함되어 있다는 뜻이 아닙니다.

05 출처 및 라이선스

소스와 라이선스

이 페이지는 아래에 링크된 고정 소스 리비전을 설명합니다. 업스트림의 동작과 요구 사항은 바뀔 수 있습니다.

소스 소유자
vercel
스킬 파일
SKILL.md
라이선스
Apache-2.0
검토한 스냅샷
2026-11-02 · ca8be600bfd0
편집 소스 요약
수정 가능한 React 컴포넌트로 AI 채팅 인터페이스를 만드세요.

링크된 소스를 바탕으로 OpenDesign이 작성한 원본 요약입니다. 저장소 스타 수는 특정 시점의 인기 지표일 뿐 스킬 사용량이나 품질 점수가 아닙니다.

06 시작 전 질문

시작 전 궁금한 점

설치한 컴포넌트를 수정할 수 있나요?

네. 설치 도구가 프로젝트에 컴포넌트 코드를 추가하므로 클래스와 동작을 조정할 수 있습니다.

AI Gateway는 필수인가요?

소스에서는 모델 접근 수단으로 권장합니다. 전제 조건 목록에서는 애플리케이션, AI SDK, shadcn 설정을 별도로 다룹니다.

컴포넌트에 스타일이 적용되지 않는 이유는 무엇인가요?

컴포넌트 마크업을 변경하기 전에 프로젝트의 Tailwind 및 shadcn 전역 스타일을 확인하세요.

OpenDesign

작업 요청과 디자인 결과물을 한곳에 모으세요.

브리프, 소스 자료, 디자인 작업을 로컬 작업 공간에 함께 보관하세요. 워크플로에 추가하기 전에 스킬 자체의 설정을 확인하세요.

업스트림 소스 파일
https://github.com/vercel/ai-elements/blob/ca8be600bfd01b3131f9bf6134b51602a71f4374/skills/ai-elements/SKILL.md