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, 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. 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 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 e Marketplace.

​

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

​

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.

​

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.
• 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.

​

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.

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.