Configurar projetos
Esta é a página que responde à pergunta central: como faço o Makion seguir as nossas instruções exatas quando constrói código ou atua no sistema? A resposta é um projeto. Um projeto emparelha um sistema SAP com as definições e os padrões que moldam cada tarefa executada nele — o motor de IA, a variante ABAP, se pode correr sem supervisão, e as regras, funções e exemplos que o agente lê em cada execução.
Configure bem um projeto uma vez, e cada programador que trabalha nele obtém o mesmo comportamento previsível. Esta página percorre toda a configuração por ordem.
Um projeto por "equipa × sistema SAP × forma de trabalhar." Se duas equipas têm padrões diferentes ou sistemas diferentes, dê-lhes projetos separados e afine cada um de forma independente.
As quatro coisas que orientam o agente#
O comportamento do Makion num projeto provém de quatro camadas, definidas em dois separadores:
| Camada | Onde a define | O que controla |
|---|---|---|
| Alvo e motor | Separador Admin → tabela Projetos | Qual o sistema SAP, qual a variante ABAP, qual o motor de IA, e se as execuções autónomas são permitidas. |
| Regras base | Separador Metodologia | Os padrões que o agente segue sempre — nomenclatura, padrões, o que fazer / não fazer. |
| Metodologias de função | Separador Metodologia | Como cada função se comporta, e se essa função pode escrever no SAP. |
| Base de conhecimento | Separador Metodologia | Padrões e exemplos trabalhados que o agente lê em cada execução. |
O mecanismo preciso: em cada tarefa, o Makion combina regras base + a função que o programador escolheu + os ficheiros da base de conhecimento no contexto a partir do qual o agente trabalha. Portanto, regras base precisas + bons exemplos = o agente "segue as instruções" de forma fiável. A página de Metodologia explica esta estratificação na íntegra; esta página diz-lhe a ordem por que a deve fazer.
Lista de verificação da configuração#
1. Criar o projeto#
A partir do Seletor de projetos da barra superior, clique em + Novo projeto e dê-lhe um nome. A pessoa que cria um projeto torna-se o seu administrador do projeto, pelo que pode gerir a sua metodologia e membros mesmo sem ser superadmin. Consulte Entrar e projetos para o seletor.
2. Apontá-lo a um sistema SAP#
Abra o separador Sistemas e configure a ligação SAP que este projeto tem como alvo — níveis DEV / QAS / PROD, onde QAS e PROD são de leitura apenas. Depois, na tabela Projetos do separador Admin, defina a coluna Sistema SAP para esse sistema, para que o projeto e a sua ligação fiquem emparelhados.
3. Definir o perfil técnico do projeto (Admin → Projetos)#
No separador Admin, a tabela Projetos tem uma linha por projeto. Defina:
| Coluna | Opções | O que faz |
|---|---|---|
| Projeto | — | O nome do projeto (etiqueta de leitura apenas da linha). |
| Sistema SAP | os seus sistemas configurados | Qual o sistema SAP que este projeto tem como alvo. |
| Variante ABAP | modern (7.40+ / S/4) ou classic (<7.40 / ECC) | Molda quais os construtos de linguagem e padrões que o agente usa — estilo moderno inline / CDS / RAP versus ABAP clássico seguro para ECC. Defina-o para corresponder ao sistema alvo. |
| Motor | Claude, Gemini, Codex, Kimi ou Grok | Qual o modelo de IA que corre este projeto. Consulte Motores de IA e início de sessão. |
| Autónomo | caixa de verificação | Quando ativado, este projeto pode executar execuções de agente sem supervisão. Consulte Modo autónomo. |
Autónomo ATIVADO permite execuções de agente sem supervisão. O trabalho autónomo continua a ser de leitura apenas e propõe alterações para uma fila de envio que um humano aprova e aplica — mas deixe-o desativado para projetos que devem correr apenas de forma interativa. Consulte Modo autónomo.
4. Escrever a metodologia (separador Metodologia)#
Abra o separador Metodologia e defina os três blocos — é aqui que "seguir as nossas instruções exatas" é efetivamente codificado:
- Regras base — os padrões que o agente segue sempre neste projeto, seja qual for a função: convenções de nomenclatura, expectativas de clean-core, disciplina de transportes, hábitos de revisão. Escreva-as em linguagem simples e clique em Guardar regras base. Regras base precisas e inequívocas são a maior alavanca sobre a fidelidade com que o agente trabalha.
- Funções — para cada função que o programador pode escolher no Chat, edite a sua metodologia e alterne Pode alterar o SAP (escrita). Desmarcado significa leitura apenas: o agente recebe fisicamente apenas ferramentas de leitura. Afine cada função para dizer exatamente como a sua equipa constrói, revê ou dá suporte a ABAP. Consulte Como funcionam as funções.
- Base de conhecimento — adicione padrões e exemplos trabalhados como ficheiros (por exemplo, um "como estruturamos um relatório" canónico, um padrão preferido de tratamento de erros, uma lista de verificação de pré-conclusão). Estes são lidos em cada execução, pelo que são o melhor lugar para exemplos concretos que o agente deve imitar.
5. Adicionar os programadores#
Dê acesso às pessoas que vão trabalhar no projeto:
- Um superadmin usa Admin → Acesso a projetos e marca a caixa de verificação para este projeto na linha de cada programador.
- Um administrador do projeto usa o separador Membros do projeto — Adicionar um programador, depois define a sua função.
O detalhe completo está em Utilizadores e acesso.
Após a configuração#
- Os programadores escolhem o projeto no seletor da barra superior, ligam-se em Sistemas, e trabalham no Chat.
- Refine à medida que aprende: aperte as regras base, adicione exemplos à base de conhecimento, e deixe o Retro fazer emergir correções de regras e de conhecimento a partir de sessões reais.
- Tudo o que o agente faz é registado — consulte o Registo de auditoria.
Para onde ir a seguir#
- Metodologia — as regras base, funções e base de conhecimento na íntegra.
- Motores de IA e início de sessão — escolha e autentique o motor do projeto.
- Utilizadores e acesso — conceda acesso e faça a gestão de membros.
- Modo autónomo — como as execuções sem supervisão propõem alterações para aprovação humana.