Atoms 클라우드의 AI 섹션을 사용해 AI 모델을 선택하고, 앱에서 사용하며, 앱의 AI 사용량을 검토하세요.

이 페이지에서는 사용자가 앱 내부에서 상호작용하는 AI 기능을 설명합니다. Atoms 클라우드는 모델 라이브러리와 프로젝트 사용량 정보를 제공하고, Chat의 Atoms Agent는 이러한 기능을 구축하고 업데이트합니다.

Atoms 클라우드에서 AI 이해하기

Atoms 데스크톱 버전에서 프로젝트를 열고 Web 모드인지 확인하세요. AI Library에는 현재 프로젝트에서 사용할 수 있는 모델이 포함되어 있고, AI Usage에는 프로젝트 크레딧 사용량과 활성 모델이 표시됩니다.

Atoms 클라우드 가 연결되어 있지 않거나 AI 를 사용할 수 없는 경우, 계속하기 전에 에이전트에게 Atoms 클라우드를 연결해 달라고 요청하거나 Atoms 클라우드 를 따르세요.

Atoms 클라우드에서 AI Library 열기

1. App 뷰어 가 있는 동일한 워크스페이스 도구 모음에서 Atoms 클라우드 를 선택하세요.
2. 사이드바에서 AI 를 선택하세요.
3. AI Library 를 여세요.

AI Library 에는 현재 프로젝트에서 사용할 수 있는 모델이 표시됩니다. 카테고리 필터를 탐색하거나 Search 를 사용해 적합한 모델을 찾을 수 있습니다.

라이브러리는 시간이 지나면서 변경될 수 있습니다. 이전 모델이나 제공업체 목록에 의존하지 말고, 그곳에 표시된 모델과 정보를 사용하세요.

요청에 모델 추가하기

1. AI Library 에서 모델을 찾으세요.
2. 해당 카드에서 # Add 를 선택하세요. Atoms가 현재 Chat 메시지에 모델 태그를 삽입합니다.
3. 태그 뒤에 기능 요청을 완성한 다음, 메시지를 Atoms Agent 에게 보내세요.

# Add 를 선택하면 사용하려는 AI 모델을 에이전트에게 알릴 수 있습니다. 모델은 Chat 메시지에 태그로 표시됩니다. 그런 다음 에이전트가 무엇을 만들거나 변경하길 원하는지 설명할 수 있습니다.

Chat에서 직접 모델을 첨부할 수도 있습니다. # 를 입력하고 AI 를 선택한 다음, 현재 사용 가능한 모델 중 하나를 고르세요.

Chat 요청에 모델 태그를 삽입하려면 # Add를 선택하세요.

기능을 명확하게 설명하기

모델을 첨부한 후에는 사용자 관점에서 기능이 어떻게 작동하길 원하는지 에이전트에게 알려주세요. 다음 세부 정보를 포함하세요.

설명할 내용	에이전트에게 전달할 내용
목적	이 기능이 사용자가 무엇을 달성하도록 도와야 하는지 설명하세요.
사용자 여정	사용자가 무엇을 입력, 업로드 또는 선택할지, 그리고 결과를 어디에서 봐야 하는지 설명하세요.
사용되는 정보	AI가 사용해야 하는 정보와 반드시 포함하지 말아야 할 항목을 명시하세요.
예상 결과	선호하는 형식, 어조, 언어, 길이와 중요한 제한 사항을 설명하세요.
로딩 및 오류	대기 중일 때, 정보가 없거나 유효하지 않을 때, 그리고 요청이 실패할 때 사용자에게 무엇이 보여야 하는지 설명하세요.

기능이 어떻게 코딩되어야 하는지 설명할 필요는 없습니다. 사용자가 무엇을 하는지, 어떤 결과를 받아야 하는지, 그리고 각 단계에서 앱이 어떻게 반응해야 하는지에 집중하세요.

생성된 레이아웃은 프로젝트마다 다를 수 있습니다. 모든 앱이 동일한 디자인을 사용할 것이라고 기대하기보다, 요청한 동작을 확인하세요.

선택한 AI 모델은 Chat 작성기에 태그로 표시됩니다.

App 뷰어에서 기능 테스트하기

에이전트가 작업을 마치면 App 뷰어 에서 전체 사용자 여정을 테스트하세요. 개인 정보나 민감한 정보가 포함되지 않은 무해한 샘플 콘텐츠를 사용하세요.

테스트	수행할 작업	예상 결과
일반 입력	기능이 처리하도록 설계된 일반적인 예시를 제출하세요.	요청한 출력이 올바른 위치와 형식으로 표시됩니다.
빈 입력	필수 콘텐츠를 제공하지 않고 계속 진행해 보세요.	앱은 사용자에게 무엇을 제공해야 하는지 설명하고, 불필요한 요청을 보내지 않습니다.
유효하지 않은 입력	지원되지 않는 형식이거나 기능의 예상 요구 사항을 벗어나는 콘텐츠를 제공하세요.	앱은 계속 사용할 수 있는 상태를 유지하고 문제를 명확하게 설명합니다.
로딩 상태	요청을 제출하고 처리되는 동안 앱을 관찰하세요.	앱은 요청이 진행 중임을 표시하고 실수로 중복 제출하는 것을 방지합니다.
실패한 응답	일반 테스트 중 요청이 실패하면 앱이 어떻게 반응하는지 확인하세요.	앱은 유용한 메시지를 표시하고, 사용자가 다시 시도할 수 있게 하며, 기술적 세부 정보나 개인 정보를 노출하지 않습니다.

오류를 만들기 위해 의도적으로 민감한 데이터를 사용하거나, 사용 가능한 모든 크레딧을 소모하거나, 서비스를 방해하지 마세요. 느리거나 실패한 응답을 안전하게 재현할 수 없다면, 대신 앱이 그 상황을 어떻게 처리해야 하는지 에이전트에게 알려주세요.

Atoms 클라우드에서 AI 사용량 검토하기

1. Atoms 클라우드 → AI 로 돌아가세요.
2. AI Usage 를 여세요.
3. Overview 아래에서 이 프로젝트의 Total Credits Used 와 Active Models 를 검토하세요.
4. Active Models 아래에 나열된 모델을 검토하세요.

AI Usage 는 프로젝트 수준 개요를 보여줍니다. 지갑 잔액, 충전, 그리고 더 넓은 Cloud 또는 AI 사용량 세부 정보는 Cloud & AI Wallet 을 참조하세요.

특정 에이전트 응답에서 사용된 크레딧을 검토하려면 해당 응답 아래의 ... 를 선택한 다음 Credits used 를 확인하세요. 이 메시지 수준 값은 AI Usage 의 프로젝트 개요와는 별개입니다.

해당 에이전트 응답에서 사용된 크레딧을 검토하려면 메시지 메뉴를 여세요.

추가할 스크린샷: AI Usage 가 표시된 깔끔한 테스트 프로젝트로, Overview, Total Credits Used, Active Models 가 보여야 합니다. AI Usage 탭은 주황색으로 강조하세요. 목록을 이해할 수 있도록 현재 모델 이름은 보이게 유지하되, 계정 세부 정보, 워크스페이스 정보, 그리고 필요하지 않은 잔액 정보는 가리세요. 캡션: “프로젝트 크레딧 사용량과 활성 모델을 검토하려면 AI Usage를 여세요.” 대체 텍스트: “프로젝트에서 사용된 크레딧과 활성 모델을 보여주는 AI Usage 탭.”

사용자 데이터와 자격 증명 보호하기

AI 기능을 통해 제출된 콘텐츠는 처리를 위해 선택한 모델 제공업체로 전송될 수 있습니다. 요청을 완료하는 데 필요한 정보만 전송하세요.

비밀번호, API 키, 액세스 토큰 또는 불필요한 개인 정보나 기밀 정보를 절대 전송하지 마세요. 사용자가 자신의 콘텐츠가 AI 모델로 전송되는 시점을 이해할 수 있도록 하고, 조직의 개인정보 보호 및 데이터 처리 요구 사항을 준수하세요.

중요한 결정을 위해 AI가 생성한 결과에 의존하기 전에 항상 검토하세요. 자세한 내용은 Atoms Terms of Service 를 참조하세요.

앱에 외부 제공업체의 비공개 자격 증명이 필요한 경우 키 and secrets 를 사용해 저장하세요. 자격 증명을 Chat에 붙여넣거나 브라우저에서 실행되는 코드에 포함하지 마세요.