> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexxible.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Criar com IA
O design de microsserviços mediante Inteligência Artificial (IA) permite sua geração automática a partir de solicitações expressas em linguagem natural. Esta funcionalidade reduz a necessidade de conhecimentos técnicos avançados e agiliza o processo de desenvolvimento ao eliminar a necessidade de programação manual.
O código do microsserviço é gerado de acordo com a solicitação realizada, mas o processo de criação é concluído na seção [Designer](ms-designer), a partir de onde o microsserviço pode ser habilitado para que possa ser executado.
## Criar um microsserviço
Os passos para criar um microsserviço através da IA são os seguintes:
1. Acessar **Microsserviços** → **Criar com IA**.
2. No painel central, escrever a solicitação em linguagem natural e com um máximo de 400 caracteres. Na parte inferior, **Experimente algo como isto** oferece exemplos que podem ajudar a criar uma solicitação.
3. No menu suspenso, escolher em qual escopo será executado: *Microsserviço de Sistema* ou *Microsserviço de Sessão*.
4. Clicar na seta do quadrado laranja para continuar.
5. Caso existam microsserviços similares, serão oferecidos como alternativas disponíveis. O usuário poderá clicar sobre cada um deles para analisar seu uso em relação ao objetivo desejado. Ao fazê-lo, será redirecionado à seção [Marketplace](ms-marketplace).
Se após revisar as alternativas, o usuário considerar que deve criar um novo microsserviço, deve clicar em **Criar com IA**.
6. Alguns segundos depois, a IA desenhará o microsserviço.
O botão **Copiar código** permite copiar o código gerado para a área de transferência, facilitando seu uso em testes, se necessário.
Esta funcionalidade só gera microsserviços em PowerShell.
7. Revisar o código do microsserviço.
8. A caixa **Melhore o microsserviço**, localizada na parte inferior direita da tela, permite ao usuário adicionar informações para otimizar o microsserviço. A cada melhoria é gerada uma nova versão do código, que pode ser vista na coluna **Microsserviços criados**, localizada na parte superior.
9. Clicar em **Criar microsserviço**.
Se clicar novamente em **Criar microsserviço** sobre uma solicitação de microsserviço já existente, será solicitada confirmação ao usuário para verificar se deseja criar um novo. Em caso afirmativo, será gerado outro microsserviço cujo nome incluirá um número no final para diferenciá-lo do original. **Em nenhum caso será sobrescrito o código ou configuração de um microsserviço já criado.**
10. A seguir, o usuário será direcionado à seção [Designer](ms-designer) para que possa editar a configuração do microsserviço, se assim desejar.
11. Clicar em **Salvar**.
12. O microsserviço aparecerá na listagem das seções [Designer](ms-designer) e [Marketplace](ms-marketplace).
Por padrão, os microsserviços gerados com IA são criados sem nenhuma categoria e têm a licença **Flexxible Microservices License**. Esta configuração pode ser modificada em Designer.
A IA também pode cometer erros. A execução de microsserviços desenhados com este método é responsabilidade do usuário.
## Redação de solicitações
Quanto mais detalhada for uma solicitação, mais preciso e útil será o microsserviço gerado.
Para consegui-lo, recomenda-se que as mensagens cumpram as seguintes diretrizes:
**1. Conciso**
* Evitar frases vagas, redundantes ou excessivamente longas.
* Utilizar uma linguagem direta.
* A clareza deve ter prioridade sobre a quantidade de palavras.
**2. Específico**
* Explicar exatamente o que se deseja obter.
* Incluir detalhes como o formato de saída, as ferramentas, objetivo, restrições, etc.
* Quanto mais detalhes forem fornecidos, melhor será o resultado.
**3. Contexto**
* Indicar onde a ação será aplicada.
* Se faltar contexto, a IA poderia criar resultados genéricos.
* Especificar o propósito do microsserviço.
**4. Verbos no modo imperativo**
* Sugere-se utilizar verbos que indiquem com clareza o que a IA deve fazer.
* Exemplos: crie, faça, analise, gere, busque, compare, etc.
### Recomendações
Além de escrever solicitações claras, é recomendável estruturá-las de forma que a IA compreenda com precisão o que deve fazer e como deve apresentar o resultado. Para consegui-lo, sugere-se levar em conta as seguintes recomendações:
* **Evitar a ambiguidade.** Cada solicitação deve ter uma única interpretação possível.
* **Iterar e melhorar.** Se o resultado não é ótimo, pode-se ajustar a solicitação adicionando mais contexto.
* **Usar exemplos quando possível.** Mostrar um modelo de saída orienta melhor o resultado.
* **Especificar a ação concreta.** Descrever de forma direta a tarefa que a IA deve executar.
* **Incluir exemplos de referência.** Mostrar como deveria ser a saída esperada, para guiar corretamente a interpretação da IA.
* **Estabelecer restrições ou regras.** Indicar os limites, condições ou requisitos que devem ser cumpridos durante a execução.
* **Definir critérios de sucesso.** Explicar quais condições o resultado deve cumprir para ser considerado satisfatório.
### Exemplos de como realizar uma solicitação
| :x: | :white\_check\_mark: | |
| ---------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | - |
| Pode fazer uma cópia de segurança da área de trabalho e dos documentos? | Faça uma cópia de segurança da área de trabalho e da pasta Documentos. Copie esses arquivos em ZIP para \nas\backups\. Além disso, quero manter apenas a última cópia. Exclua o resto dos arquivos no momento em que a cópia tenha sido concluída corretamente. | |
| Criar uma tarefa programada nos equipamentos que encerre a sessão quando levar certo tempo de inatividade. | Crie uma tarefa programada no Windows 11. A tarefa deve encerrar a sessão do usuário atual quando forem detectados 30 minutos de inatividade. | |
## Minhas solicitações
A coluna **Minhas solicitações**, localizada à esquerda da tela, mostra as solicitações de microsserviços que o usuário fez à IA. Cada usuário só pode ver as suas, não são compartilhadas com o resto da organização.
Esta funcionalidade permite que o histórico de solicitações seja visível a todo momento pelo usuário que a criou, para que sempre se possa voltar a elas. Também permite dar feedback sobre o resultado; para isso, o usuário pode clicar sobre os botões com formas de polegar, localizados no canto superior direito da tela.
### Excluir uma solicitação
1. Ir para a coluna **Minhas solicitações**, localizada no lado esquerdo da tela.
2. Clicar sobre uma solicitação da listagem para entrar no detalhe do código.
3. Clicar no ícone de **Excluir**, localizado no canto superior direito da tela.
4. Ler a mensagem de aviso.
5. Clicar em **Cancelar** ou **Excluir**, conforme o caso.
Excluir uma solicitação não implica apagar o microsserviço criado a partir dela.
## Microsserviços criados
No extremo direito da tela, a coluna **Microsserviços criados** apresenta a listagem de todos os microsserviços criados a partir de uma solicitação. Este painel permite identificar se uma solicitação deu origem a um ou vários microsserviços, bem como acessar diretamente a cada um deles para sua revisão.
* Quando a IA desenha a primeira versão de um microsserviço, mas este não foi criado através do botão **Criar microsserviço**, a coluna **Microsserviços criados** mostra uma mensagem como a da seguinte imagem:
A seta laranja localizada no quadro de cada versão permite carregar o código da versão anterior.
* Quando a IA desenha a primeira versão e clica-se em **Criar microsserviço**, a coluna **Microsserviços criados** mostra o nome do microsserviço. Se clicar sobre ele, acessa-se sua visão de detalhe na seção [Designer](ms-designer).
* Quando a IA desenha e cria mais de uma versão de um microsserviço, a coluna **Microsserviços criados** mostra a palavra *Múltiplo*.
Ao clicar em *Múltiplo* abre-se uma janela modal com a listagem dos microsserviços criados a partir dessa solicitação. Ao selecionar um deles acessa-se sua visão de detalhe na seção [Designer](ms-designer).
## Habilitar um microsserviço
O processo para habilitar ou desabilitar um microsserviço gerado com IA é o mesmo utilizado para criar microsserviços de forma manual.
**Passos para habilitar um microsserviço a partir do Designer:**
1. Acessar **Microsserviços** → **Designer**.
2. Buscar o microsserviço na listagem e clicar sobre ele.
3. Clicar no botão **Habilitar**, localizado na parte superior direita da tela.
4. O microsserviço aparecerá marcado com um ponto verde (sinal de estar habilitado) na seção [Marketplace](ms-marketplace).
**Passos para habilitar um microsserviço a partir do Marketplace:**
1. Acessar **Microsserviços** → **Marketplace**.
2. Buscar o microsserviço na listagem e clicar sobre ele.
3. Clicar no botão **Habilitar**, localizado na parte superior direita da tela.
4. O microsserviço aparecerá marcado com um ponto verde (sinal de estar habilitado).
## Habilitar um microsserviço para o usuário final
O processo de habilitar um microsserviço criado com IA para sua execução pelo usuário final é o mesmo dos microsserviços desenhados de forma manual.
Por favor, consulte o guia Habilitar microsserviços para o usuário final.
A Flexxible recomenda revisar as abas `Privacidade` e `Destinatários` na seção [Designer](ms-designer) antes de habilitar um microsserviço para comprovar que têm a configuração desejada.