Use IA no seu app

Esta página explica os recursos de IA com os quais os usuários interagem dentro do seu app. 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 AI Library contém os modelos atualmente disponíveis para o projeto, enquanto AI Usage mostra o uso de créditos do projeto e os modelos ativos.

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

Abra a AI Library 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 AI.
3. Abra AI Library.

A AI Library 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 ao longo do 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 em AI Library.
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 Agente 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 Agente crie ou altere.

Você também pode anexar um modelo diretamente pelo Chat: digite #, selecione AI 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 Agente como você quer que o recurso funcione da perspectiva do usuário. Inclua os seguintes detalhes:

O que descrever	O que dizer ao Agente
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 preferidos e quaisquer limites importantes.
Carregamento e erros	Explique o que os usuários devem ver enquanto esperam, quando faltarem informações ou elas forem 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 diferir 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 Agente 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 obrigató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 Agente como o app deve lidar com essa situação.

Revise o uso de IA no Atoms Cloud

1. Volte para Atoms Cloud → AI.
2. Abra AI Usage.
3. Em Overview, revise Total Créditos Used e Active Models deste projeto.
4. Revise os modelos listados em Active Models.

AI Usage mostra uma visão geral no nível do projeto. Para saldo da carteira, recarga e detalhes mais amplos de uso do Cloud ou de 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 used. Esse valor no nível da mensagem é separado da visão geral do projeto em AI Usage.

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

Captura de tela a adicionar: AI Usage em um projeto de teste limpo, mostrando Overview, Total Créditos Used e Active Models. Destaque a aba AI Usage em laranja. Mantenha um nome de modelo atual visível 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 AI Usage para revisar o uso de créditos do projeto e os modelos ativos.” Texto alternativo: “Aba AI Usage 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 ou 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.