Aegro Agronomo | Skills Pool
Aegro Agronomo Dominio agronomico do Aegro - safras, talhoes, atividades, colheitas, clima e insumos de producao
pmdusso 0 Sterne 18.03.2026 Agronomo - Dominio Agronomico do Aegro
Referencia completa do dominio agronomico: safras, talhoes, atividades de campo,
registros de colheita, dados climaticos e insumos de producao (sementes, defensivos,
fertilizantes). Base para todos os workflows agronomicos.
1. Vocabulario do Dominio
Termo Aegro Termo API Definicao Safra cropCiclo produtivo com periodo definido (ex: Soja 2025/26). Contem talhoes, atividades e colheitas. Talhao glebeUnidade permanente de terra na fazenda. Nao muda entre safras. Area fixa em hectares. Talhao de Safra crop-glebeVinculo talhao-safra. Area efetivamente plantada naquele ciclo. Central para produtividade. Atividade
Schnellinstallation
Aegro Agronomo npx skillvault add pmdusso/pmdusso-aegro-skills-skills-aegro-agronomo-skill-md
Sterne 0
Aktualisiert 18.03.2026
Beruf activity
Operacao agricola planejada ou executada (plantio, aplicacao, colheita, etc).
Plano planPlanejamento: quais talhoes, quais insumos, datas previstas.
Realizacao realizationExecucao efetiva. Uma atividade pode ter multiplas realizacoes.
Romaneio harvest-logRegistro de pesagem de colheita. Pesos: bruto, tara, liquido, descontado, produto.
Rateio crop-prorateDistribuicao proporcional de custos entre talhoes. Soma = 100%.
Elemento elementInsumo: semente, defensivo, fertilizante, item ou servico.
Produtividade - Sacas/ha. Soja: peso descontado (kg) / area (ha) / 60.
Desconto harvest-discountReducoes no peso: umidade, impureza, avariados. Por safra.
Chaves: Formato tipo::hex (ex: crop::68dd6719e90f726622b7f549). Hexadecimais sao IDs MongoDB.
2. Modelo de Dados e Relacionamentos FARM (fazenda)
├── GLEBE (talhoes permanentes - area fixa)
├── CROP (safra - ciclo produtivo)
│ ├── CROP_GLEBE (talhao vinculado a safra = area plantada)
│ ├── ACTIVITY (atividade agricola)
│ │ ├── PLAN (planejamento: cropGlebeKeys[], inputs[] → ELEMENTS)
│ │ └── REALIZATION[] (execucoes, impacta STOCK)
│ ├── HARVEST_LOG (romaneios: cropGlebes[], pesos, seedKey)
│ ├── CROP_PRORATE (rateios entre talhoes)
│ └── HARVEST_DISCOUNTS (config umidade/impureza)
└── ELEMENT (insumos globais)
├── SEED (tipo: SOYBEAN, CORN...) ├── DEFENSIVE (tipo: HERBICIDE...)
├── FERTILIZER └── ITEM / SERVICE
Eixo central: CROP_GLEBE. Atividades, colheitas e produtividade sao por crop-glebe.
Sem crop-glebes vinculados, a safra nao tem operacoes possiveis.
3. Regras de Negocio
Tipos de Atividade SOWING (plantio), APPLICATION (defensivos), FERTILIZATION (adubacao), HARVEST (colheita),
SEED_TREATMENT (tratamento sementes), PEST_SCOUTING (monitoramento), TILLAGE (preparo solo), OTHER.
Tipos de Defensivo HERBICIDE (plantas daninhas), INSECTICIDE (insetos), FUNGICIDE (doencas), ACARICIDE (acaros), OTHER (adjuvantes).
Modo de Calculo de Colheita
AUTOMATICMANUAL
Descontos de Colheita
Umidade base soja: 13-14% (acima desconta proporcionalmente)
Impureza maxima soja: 1-2% (acima desconta kg/kg)
Configurados por safra: aegro crops harvest-discounts <crop_key>
Calculo de Produtividade Produtividade (sc/ha) = Peso Descontado Total (kg) / Area (ha) / 60
1 saca soja = 60 kg. Usar peso descontado (apos umidade/impureza), nao peso liquido bruto.
Realizacoes e Rateios
Uma atividade pode ter multiplas realizacoes (ex: colheita em 3 dias)
Realizacoes baixam estoque automaticamente
Rateios: status ACTIVE ou ARCHIVED, soma percentuais = 100%
4. Referencia Completa de Comandos
4.1 Safras (aegro crops) Comando Argumentos/Opcoes crops get <crop_key>posicional crops list--start-date, --end-date, --pagecrops glebes <crop_key>posicional, --glebe-key (repetivel), --page crops prorate <prorate_key>posicional crops prorates--crop-key (repetivel), --status (repetivel), --search, --pagecrops harvest-discounts <crop_key>posicional
aegro crops list --start-date 2025-01-01 --end-date 2026-12-31
aegro crops glebes crop::68dd6719e90f726622b7f549
aegro crops prorates --crop-key crop::68dd6719e90f726622b7f549 --status ACTIVE
4.2 Talhoes de Safra (aegro crop-glebes) Comando Argumentos/Opcoes crop-glebes get <key>posicional crop-glebes list <crop_key>posicional, --page
crop-glebes list recebe crop_key posicional. Endpoint: POST /pub/v1/crops/{crop_key}/crop-glebes/filter.
aegro crop-glebes list crop::68dd6719e90f726622b7f549
4.3 Talhoes Permanentes (aegro glebes) Comando Argumentos/Opcoes glebes get <key>posicional glebes list--page
4.4 Atividades (aegro activities) Comando Argumentos/Opcoes activities get <key>posicional activities list--crop-key, --status (repetivel), --type (repetivel), --pageactivities plan <key>posicional - chave da atividade → /activities/{key}/plan activities get-plan <key>posicional - chave do plano → /activities/plans/{key} activities realizations--activity-key, --crop-key, --start-date, --end-date, --pageactivities get-realization <key>posicional activities create-plan--crop-key (obrig.), --type (obrig.), --start-date (obrig.), --activity-key, --crop-glebe-key (repetivel), --end-date, --observations, --inputs (JSON)
ATENCAO plan vs get-plan:
activities plan <ACTIVITY_KEY> → plano a partir da chave da atividade activities get-plan <PLAN_KEY> → plano pela chave do plano aegro activities list --crop-key crop::68dd6719e90f726622b7f549 --type APPLICATION
aegro activities list --crop-key crop::68dd6719e90f726622b7f549 --type SOWING --type HARVEST
aegro activities realizations --crop-key crop::68dd6719e90f726622b7f549 --start-date 2025-10-01 --end-date 2026-03-31
# Criar plano de plantio com insumos
aegro activities create-plan \
--crop-key crop::68dd6719e90f726622b7f549 \
--type SOWING --start-date 2026-01-15 \
--crop-glebe-key cropglebe::68dd6730e90f726622b7f555 \
--observations "Plantio soja TMG 2381" \
--inputs '[{"elementKey":"element::abc123","quantity":{"magnitude":50,"unit":"KG/HA"}}]'
4.5 Romaneios de Colheita (aegro harvest-logs) Comando Argumentos/Opcoes harvest-logs get <key>posicional harvest-logs createver parametros abaixo
Parametros create: --crop-key (obrig.), --date (obrig., YYYY-MM-DD), --crop-glebe (repetivel),
--calculation-mode (AUTOMATIC/MANUAL, default AUTOMATIC), --seed-key, --destination-key,
--gross-weight (kg), --tare-weight (kg), --net-weight (kg), --discounted-weight (kg),
--product-weight (kg), --observations, --identifier, --invoice-code, --romaneio-code.
# Romaneio automatico
aegro harvest-logs create \
--crop-key crop::68dd6719e90f726622b7f549 --date 2026-03-10 \
--crop-glebe cropglebe::68dd6730e90f726622b7f555 \
--gross-weight 32000 --tare-weight 12000
# Romaneio manual completo
aegro harvest-logs create \
--crop-key crop::68dd6719e90f726622b7f549 --date 2026-03-10 \
--crop-glebe cropglebe::68dd6730e90f726622b7f555 \
--crop-glebe cropglebe::68dd6730e90f726622b7f556 \
--calculation-mode MANUAL --seed-key element::seed123 \
--gross-weight 32000 --tare-weight 12000 --net-weight 20000 \
--discounted-weight 19400 --product-weight 19400 \
--romaneio-code "ROM-2026-0042" --invoice-code "NF-88901"
4.6 Clima (aegro weather) Comando Argumentos/Opcoes weather get <key>posicional weather create--weather-station-key (obrig.), --date (obrig.), parametros pareados abaixo
Parametros pareados (ambos presentes ou ambos ausentes):
--precipitation + --precipitation-unit (ex: mm)--temperature + --temperature-unit (ex: CELSIUS) Independentes: --humidity (%), --pressure (hPa).
aegro weather create --weather-station-key weatherstation::ws001 --date 2026-03-12 \
--precipitation 12.5 --precipitation-unit mm \
--temperature 28.0 --temperature-unit CELSIUS --humidity 65.0
4.7 Elementos / Insumos (aegro elements) Comando Argumentos/Opcoes elements get <key>posicional elements list--category (repetivel), --type (repetivel), --pageelements create-defensive--name (obrig.), --type (obrig.), --unit (obrig.), --manufacturer, --observationselements create-fertilizer--name (obrig.), --unit (obrig.), --manufacturer, --observationselements create-seed--name (obrig.), --type (obrig.), --unit (obrig.), --manufacturer, --observations
Categorias agro: SEED, DEFENSIVE, FERTILIZER.
aegro elements list --category SEED
aegro elements list --category DEFENSIVE --type HERBICIDE
aegro elements create-defensive --name "Roundup Original" --type HERBICIDE --unit L --manufacturer Monsanto
aegro elements create-fertilizer --name "MAP Granulado" --unit KG --manufacturer Mosaic
aegro elements create-seed --name "TMG 2381 IPRO" --type SOYBEAN --unit KG --manufacturer TMG
Opcao global: Todos os comandos aceitam --output / -o com json (padrao), table ou csv.
5. Padroes e Exemplos Reais
02
1. Vocabulario do Dominio