Use a seção de IA do Atoms Cloud para escolher um modelo de IA, usá-lo no seu app e revisar o uso de IA do app.

Esta página explica os recursos de IA com os quais os usuários interagem dentro do seu app. O Atoms Cloud fornece a biblioteca de modelos e as informações de uso do projeto, enquanto o Atoms Agent no Chat cria e atualiza esses recursos.

Entenda a IA no Atoms Cloud

Abra o projeto na versão desktop do Atoms e certifique-se de que ele esteja no modo Web. A Biblioteca de IA contém os modelos atualmente disponíveis para o projeto, enquanto Uso de IA mostra o uso de créditos do projeto e os modelos ativos.

Se o Atoms Cloud não estiver conectado ou se a IA não estiver disponível, peça ao Agent para conectar o Atoms Cloud ou siga Atoms Cloud antes de continuar.

Abra a Biblioteca de IA no Atoms Cloud

1. Na mesma barra de ferramentas do espaço de trabalho onde está o Visualizador de App , selecione Atoms Cloud.
2. Na barra lateral, selecione IA.
3. Abra Biblioteca de IA.

A Biblioteca de IA mostra os modelos atualmente disponíveis para o seu projeto. Você pode navegar pelos filtros de categoria ou usar Search para encontrar um modelo adequado.

A biblioteca pode mudar com o tempo. Use os modelos e as informações mostrados ali em vez de confiar em uma lista antiga de modelos ou provedores.

Adicione um modelo à sua solicitação

1. Encontre um modelo na Biblioteca de IA.
2. Selecione # Add no cartão dele. O Atoms insere a tag do modelo na mensagem atual do Chat.
3. Complete a solicitação do recurso após a tag e, em seguida, envie a mensagem para o Atoms Agent.

Selecione # Add para informar ao Agent qual modelo de IA você deseja usar. O modelo aparece como uma tag na sua mensagem do Chat. Depois, você pode descrever o que deseja que o Agent crie ou altere.

Você também pode anexar um modelo diretamente pelo Chat: digite #, selecione IA e, em seguida, escolha um dos modelos atualmente disponíveis.

Selecione # Add para inserir uma tag de modelo na sua solicitação do Chat.

Descreva o recurso com clareza

Depois de anexar um modelo, diga ao Agent como você quer que o recurso funcione da perspectiva do usuário. Inclua os seguintes detalhes:

O que descrever	O que dizer ao Agent
Objetivo	Explique o que o recurso deve ajudar os usuários a realizar.
Jornada do usuário	Descreva o que os usuários irão inserir, enviar ou selecionar e onde devem ver o resultado.
Informações usadas	Especifique quais informações a IA deve usar e tudo o que ela não deve incluir.
Resultado esperado	Descreva o formato, tom, idioma, comprimento e quaisquer limites importantes preferidos.
Carregamento e erros	Explique o que os usuários devem ver enquanto aguardam, quando faltam informações ou elas são inválidas, e se uma solicitação falhar.

Você não precisa explicar como o recurso deve ser codificado. Foque no que os usuários fazem, no resultado que devem receber e em como o app deve responder em cada etapa.

O layout gerado pode variar entre projetos. Verifique o comportamento que você solicitou em vez de esperar que todo app use o mesmo design.

O modelo de IA selecionado aparece como uma tag no compositor do Chat.

Teste o recurso no Visualizador de App

Depois que o Agent terminar, teste a jornada completa do usuário no Visualizador de App. Use conteúdo de exemplo inofensivo que não contenha informações pessoais ou sensíveis.

Teste	O que fazer	Resultado esperado
Entrada normal	Envie um exemplo típico que o recurso foi projetado para processar.	A saída solicitada aparece no local e formato corretos.
Entrada vazia	Tente continuar sem fornecer o conteúdo necessário.	O app explica o que o usuário precisa fornecer e não envia uma solicitação desnecessária.
Entrada inválida	Forneça conteúdo em um formato não compatível ou fora dos requisitos esperados do recurso.	O app continua utilizável e exibe uma explicação clara do problema.
Estado de carregamento	Envie uma solicitação e observe o app enquanto ela está sendo processada.	O app mostra que a solicitação está em andamento e evita envios duplicados acidentais.
Resposta com falha	Se uma solicitação falhar durante o teste normal, verifique como o app responde.	O app exibe uma mensagem útil, permite que o usuário tente novamente e não expõe detalhes técnicos nem informações privadas.

Não use deliberadamente dados sensíveis, não consuma todos os créditos disponíveis nem interrompa o serviço para criar um erro. Se você não puder reproduzir com segurança uma resposta lenta ou com falha, diga ao Agent como o app deve lidar com essa situação.

Revise o uso de IA no Atoms Cloud

1. Volte para Atoms Cloud → IA.
2. Abra Uso de IA.
3. Em Visão geral, revise Total de créditos usados e Modelos ativos deste projeto.
4. Revise os modelos listados em Modelos ativos.

Uso de IA mostra uma visão geral no nível do projeto. Para saldo da carteira, recarga e detalhes mais amplos de uso de Cloud ou IA, consulte Cloud & AI Wallet.

Para revisar os créditos usados por uma resposta específica do Agente, selecione ... abaixo dessa resposta e, em seguida, revise Créditos usados. Esse valor no nível da mensagem é separado da visão geral do projeto em Uso de IA.

Abra o menu da mensagem para revisar os créditos usados por essa resposta do Agent.

Captura de tela para adicionar: Uso de IA em um projeto de teste limpo, mostrando Visão geral, Total de créditos usados e Modelos ativos. Destaque a aba Uso de IA em laranja. Mantenha visível um nome de modelo atual para que a lista seja compreensível, mas oculte detalhes da conta, informações do espaço de trabalho e qualquer informação de saldo que não seja necessária. Legenda: “Abra Uso de IA para revisar o uso de créditos do projeto e os modelos ativos.” Texto alternativo: “Aba Uso de IA mostrando os créditos do projeto usados e os modelos ativos.”

Proteja os dados e as credenciais dos usuários

O conteúdo enviado por meio de um recurso de IA pode ser enviado ao provedor do modelo selecionado para processamento. Envie apenas as informações necessárias para concluir a solicitação.

Nunca envie senhas, chaves de API, tokens de acesso nem informações pessoais ou confidenciais desnecessárias. Certifique-se de que os usuários entendam quando o conteúdo deles está sendo enviado para um modelo de IA e siga os requisitos de privacidade e tratamento de dados da sua organização.

Sempre revise os resultados gerados por IA antes de confiar neles para decisões importantes. Consulte os Atoms Terms of Service para mais informações.

Se o seu app precisar de uma credencial privada de um provedor externo, armazene-a usando Chaves and secrets. Nunca cole a credencial no Chat nem a inclua em código executado no navegador.