Metodologia
O separador Metodologia é onde um administrador define como o agente trabalha num projeto — as normas que segue sempre, a metodologia para cada função e os ficheiros de referência que lê em cada execução. É assim que faz o Makion seguir a forma exata de trabalhar da sua equipa, nas suas palavras, em vez das predefinições genéricas de ABAP.
Tudo neste separador é editável apenas por um administrador do projeto ou superadmin. Todos os restantes veem o separador em forma de apenas leitura com a nota "Read-only — an admin edits these.", para que possam ver as normas a que o agente está sujeito sem as poderem alterar.
A metodologia é por projeto. Se duas equipas trabalharem em sistemas SAP diferentes com normas diferentes, dê-lhes projetos separados — consulte Configurar projetos — e afine a metodologia de cada projeto de forma independente.
Como as camadas se combinam#
O Makion orienta o agente a partir de três camadas ao mesmo tempo. Em cada execução, elas são combinadas no contexto a partir do qual o agente trabalha:
- Regras base — sempre aplicadas, a cada tarefa do projeto.
- A metodologia da função escolhida — o system prompt da função que o programador selecionou no Chat (por exemplo, uma função de construção vs. uma função de revisão de apenas leitura).
- Ficheiros da base de conhecimento — normas e exemplos que são materializados no contexto do agente em cada execução.
Assim, um único pedido é moldado por regras base + a função que escolheu + a base de conhecimento, em conjunto. As regras base definem a verdade fundamental para todo o projeto; a função estreita-a ao tipo de tarefa; a base de conhecimento fornece os padrões e exemplos concretos.
Os três blocos#
| Bloco | O que contém | Quem pode editar |
|---|---|---|
| Regras base | O método e as normas que o agente segue sempre neste projeto | Administrador do projeto / superadmin |
| Funções | A metodologia para cada função que o programador pode escolher no Chat | Administrador do projeto / superadmin |
| Base de conhecimento | Ficheiros que o agente lê ao trabalhar | Administrador do projeto / superadmin |
Regras base#
As Regras base são o método e as normas que o agente segue sempre neste projeto, seja qual for a função escolhida. Uma linha de estado indica-lhe de onde vêm as regras atuais:
- "Customized for this project." — o projeto tem as suas próprias regras base.
- "Using built-in ABAP defaults — edit to customize." — o projeto ainda usa as predefinições ABAP integradas do Makion; edite-as para as tornar suas.
| Controlo | O que faz |
|---|---|
| Área de texto das regras base | Um editor grande que contém o texto completo das regras base que o agente aplica sempre. |
| Guardar regras base | Guarda as suas edições e muda o estado para "Customized for this project." |
Escreva as regras base em linguagem simples: convenções de nomenclatura, expectativas de clean-core, disciplina de transportes, hábitos de revisão — tudo aquilo que o agente deve respeitar em cada tarefa.
Funções#
O bloco Funções define a metodologia para cada função que o programador pode escolher no Chat. Uma função é ao mesmo tempo uma fronteira de permissões e uma forma de trabalhar: as funções de leitura apenas não podem alterar o SAP, e esse limite é aplicado nas ferramentas dadas ao agente, não apenas descrito em texto. Para o panorama completo de como as funções delimitam o agente, consulte Como funcionam as funções e Funções de programador.
As funções aparecem como separadores — um por função. Uma função personalizada mostra uma etiqueta "custom", para que perceba num relance quais funções adaptou e quais continuam nas predefinições.
Para a função selecionada, pode editar:
| Controlo | O que faz |
|---|---|
| Etiqueta | O nome de apresentação da função, tal como aparece no seletor de função do Chat. |
| Descrição | Uma linha curta que descreve quando usar esta função. |
| Can change SAP (write) | Se esta função pode escrever no SAP. Desmarcada = apenas leitura: o agente recebe apenas ferramentas de leitura e fisicamente não pode alterar o SAP. |
| Área de texto de conteúdo | A metodologia / system prompt da função — como o agente deve abordar este tipo de tarefa. |
| Guardar função | Guarda a etiqueta, a descrição, a marca de escrita e o conteúdo desta função. |
| Repor predefinição | Para uma função integrada personalizada, restaura a predefinição fornecida pelo Makion. Remove a etiqueta "custom". |
Can change SAP (write) decide se o agente pode modificar o seu sistema nesta função. Deixe-a desmarcada para tudo o que deva apenas investigar ou rever. Apenas leitura significa apenas leitura — as ferramentas de escrita nunca são passadas ao agente.
Afinar as funções é a parte de maior alavancagem do separador Metodologia: é a forma de um administrador codificar "é exatamente assim que nós construímos, revemos e damos suporte a ABAP" em cada conversa. Comece em Configurar projetos ao levantar a metodologia de um novo projeto.
Base de conhecimento#
A Base de conhecimento contém ficheiros que o agente lê ao trabalhar — as suas normas, padrões e exemplos trabalhados. Estes ficheiros são materializados no contexto do agente em cada execução, pelo que tudo o que aqui colocar é material de referência em que o agente pode confiar diretamente.
| Controlo | O que faz |
|---|---|
| Lista de ficheiros | Todos os ficheiros de conhecimento do projeto, por caminho. |
| Add | Criar um novo ficheiro. Dê-lhe um caminho como knowledge/patterns/my-rule.md. |
| Editor | O conteúdo do ficheiro selecionado. |
| Editar | Abrir o ficheiro selecionado para alterações. |
| Guardar | Guardar o conteúdo do ficheiro atual. |
| Eliminar | Remover o ficheiro selecionado da base de conhecimento. |
Use pastas no caminho (por exemplo knowledge/patterns/… ou knowledge/examples/…) para manter a base organizada à medida que cresce. Bons candidatos: um exemplo canónico de "como estruturamos um relatório", um padrão preferido de tratamento de erros, um guia rápido de nomenclatura, uma lista de verificação que o agente deve percorrer antes de terminar.
As regras base são ideais para princípios curtos e sempre verdadeiros. A base de conhecimento é ideal para material de referência mais longo e exemplos concretos que o agente deve imitar. Em conjunto, permitem "fazer crescer a norma" ao longo do tempo sem sobrecarregar as regras base.
Para onde ir a seguir#
- Como funcionam as funções — como uma função delimita o que o agente pode e não pode fazer.
- Funções de programador — as funções integradas e para que serve cada uma.
- Configurar projetos — levantar um projeto e a sua metodologia.
- Especificações — especificações de desenvolvimento versionadas a partir das quais o agente trabalha.