앱에서 AI 사용하기
Atoms 클라우드의 AI 섹션을 사용하여 AI 모델을 선택하고, 앱에서 사용하며, 앱의 AI 사용량을 검토하세요.
이 페이지에서는 사용자가 앱 내부에서 상호작용하는 AI 기능을 설명합니다. Atoms Cloud 는 모델 라이브러리와 프로젝트 사용량 정보를 제공하고, Chat 의 Atoms Agent 는 이러한 기능을 빌드하고 업데이트합니다.
Atoms Cloud에서 AI 이해하기
Atoms 데스크톱 버전에서 프로젝트를 열고 Web 모드인지 확인하세요. AI Library 에는 현재 프로젝트에서 사용할 수 있는 모델이 포함되어 있으며, AI Usage 에서는 프로젝트 크레딧 사용량과 활성 모델을 확인할 수 있습니다.
Atoms Cloud 가 연결되어 있지 않거나 AI 를 사용할 수 없는 경우, 에이전트에게 Atoms 클라우드를 연결해 달라고 요청하거나 계속하기 전에 Atoms Cloud를 따르세요.
Atoms Cloud에서 AI Library 열기
- App 뷰어 가 있는 동일한 워크스페이스 도구 모음에서 Atoms Cloud 를 선택합니다.
- 사이드바에서 AI 를 선택합니다.
- AI Library 를 엽니다.
AI Library 에는 현재 프로젝트에서 사용할 수 있는 모델이 표시됩니다. 카테고리 필터를 둘러보거나 Search 를 사용해 적합한 모델을 찾을 수 있습니다.
라이브러리는 시간이 지나면서 변경될 수 있습니다. 이전 모델이나 제공업체 목록에 의존하지 말고, 그곳에 표시된 모델과 정보를 사용하세요.
요청에 모델 추가하기
- AI Library 에서 모델을 찾습니다.
- 해당 카드에서 # Add 를 선택합니다. Atoms가 현재 Chat 메시지에 모델 태그를 삽입합니다.
- 태그 뒤에 기능 요청을 완성한 다음, 메시지를 Atoms Agent 에게 보냅니다.
# Add 를 선택하면 어떤 AI 모델을 사용할지 에이전트에게 알려줄 수 있습니다. 모델은 Chat 메시지에 태그로 표시됩니다. 그런 다음 에이전트가 빌드하거나 변경하길 원하는 내용을 설명할 수 있습니다.
Chat에서 직접 모델을 첨부할 수도 있습니다. # 를 입력하고 AI 를 선택한 다음, 현재 사용 가능한 모델 중 하나를 선택하세요.
Chat 요청에 모델 태그를 삽입하려면 # Add를 선택하세요.
기능을 명확하게 설명하기
모델을 첨부한 후에는 사용자 관점에서 기능이 어떻게 작동하길 원하는지 에이전트에게 알려주세요. 다음 세부 정보를 포함하세요.
| 설명할 내용 | 에이전트에게 알려줄 내용 |
|---|---|
| 목적 | 이 기능이 사용자가 무엇을 달성하도록 도와야 하는지 설명하세요. |
| 사용자 여정 | 사용자가 무엇을 입력, 업로드 또는 선택할지, 그리고 결과를 어디에서 봐야 하는지 설명하세요. |
| 사용되는 정보 | AI가 어떤 정보를 사용해야 하는지, 그리고 포함하면 안 되는 내용이 무엇인지 구체적으로 지정하세요. |
| 예상 결과 | 선호하는 형식, 톤, 언어, 길이 및 중요한 제한 사항을 설명하세요. |
| 로딩 및 오류 | 대기 중일 때, 정보가 없거나 유효하지 않을 때, 그리고 요청이 실패할 때 사용자에게 무엇이 보여야 하는지 설명하세요. |
기능이 어떻게 코딩되어야 하는지 설명할 필요는 없습니다. 사용자가 무엇을 하는지, 어떤 결과를 받아야 하는지, 그리고 각 단계에서 앱이 어떻게 응답해야 하는지에 집중하세요.
생성된 레이아웃은 프로젝트마다 다를 수 있습니다. 모든 앱이 동일한 디자인을 사용할 것이라고 기대하기보다, 요청한 동작을 확인하세요.
선택한 AI 모델이 Chat 작성기에 태그로 표시됩니다.
App 뷰어에서 기능 테스트하기
에이전트가 작업을 마치면 App 뷰어 에서 전체 사용자 여정을 테스트하세요. 개인 정보나 민감한 정보가 포함되지 않은 무해한 샘플 콘텐츠를 사용하세요.
| 테스트 | 수행할 작업 | 예상 결과 |
|---|---|---|
| 일반 입력 | 기능이 처리하도록 설계된 일반적인 예시를 제출합니다. | 요청한 출력이 올바른 위치와 형식으로 표시됩니다. |
| 빈 입력 | 필요한 콘텐츠를 제공하지 않고 계속 진행해 봅니다. | 앱이 사용자에게 무엇을 제공해야 하는지 설명하고, 불필요한 요청을 보내지 않습니다. |
| 유효하지 않은 입력 | 지원되지 않는 형식이거나 기능의 예상 요구 사항을 벗어나는 콘텐츠를 제공합니다. | 앱은 계속 사용할 수 있으며 문제에 대한 명확한 설명을 표시합니다. |
| 로딩 상태 | 요청을 제출하고 처리되는 동안 앱을 관찰합니다. | 앱은 요청이 진행 중임을 표시하고 실수로 중복 제출하는 것을 방지합니다. |
| 실패한 응답 | 일반적인 테스트 중 요청이 실패하면 앱이 어떻게 응답하는지 확인합니다. | 앱은 유용한 메시지를 표시하고, 사용자가 다시 시도할 수 있게 하며, 기술적 세부 정보나 개인 정보를 노출하지 않습니다. |
오류를 만들기 위해 의도적으로 민감한 데이터를 사용하거나, 사용 가능한 모든 크레딧을 소모하거나, 서비스를 방해하지 마세요. 느리거나 실패한 응답을 안전하게 재현할 수 없다면, 대신 그런 상황을 앱이 어떻게 처리해야 하는지 에이전트에게 알려주세요.
Atoms Cloud에서 AI Usage 검토하기
- Atoms Cloud → AI 로 돌아갑니다.
- AI Usage 를 엽니다.
- Overview 아래에서 이 프로젝트의 Total Credits Used 와 Active Models 를 검토합니다.
- Active Models 아래에 나열된 모델을 검토합니다.
AI Usage 는 프로젝트 수준 개요를 보여줍니다. 지갑 잔액, 충전, 더 넓은 Cloud 또는 AI 사용량 세부 정보는 Cloud & AI Wallet을 참조하세요.
특정 Agent 응답에서 사용된 크레딧을 검토하려면 해당 응답 아래의 ... 를 선택한 다음 Credits used 를 확인하세요. 이 메시지 수준 값은 AI Usage 의 프로젝트 개요와는 별개입니다.
해당 Agent 응답에 사용된 크레딧을 검토하려면 메시지 메뉴를 여세요.
추가할 스크린샷: AI Usage 가 깔끔한 테스트 프로젝트에 표시되고, Overview, Total Credits Used, Active Models 가 보이도록 하세요. AI Usage 탭은 주황색으로 강조 표시하세요. 목록을 이해할 수 있도록 현재 모델 이름 하나는 보이게 유지하되, 계정 세부 정보, 워크스페이스 정보, 그리고 필요하지 않은 잔액 정보는 가리세요. 캡션: “프로젝트 크레딧 사용량과 활성 모델을 검토하려면 AI Usage를 여세요.” 대체 텍스트: “프로젝트에서 사용된 크레딧과 활성 모델을 보여주는 AI Usage 탭.”
사용자 데이터와 자격 증명 보호하기
AI 기능을 통해 제출된 콘텐츠는 처리를 위해 선택한 모델 제공업체로 전송될 수 있습니다. 요청을 완료하는 데 필요한 정보만 전송하세요.
비밀번호, API 키, 액세스 토큰 또는 불필요한 개인 정보나 기밀 정보는 절대 전송하지 마세요. 사용자의 콘텐츠가 AI 모델로 전송될 때 사용자가 이를 이해할 수 있도록 하고, 조직의 개인정보 보호 및 데이터 처리 요구 사항을 따르세요.
중요한 결정을 위해 AI가 생성한 결과에 의존하기 전에 항상 검토하세요. 자세한 내용은 Atoms Terms of Service를 참조하세요.
앱에 외부 제공업체의 비공개 자격 증명이 필요한 경우 Keys and secrets를 사용해 저장하세요. 자격 증명을 Chat에 붙여넣거나 브라우저에서 실행되는 코드에 포함하지 마세요.