# Design do Agente Exemplos hipotéticos para compreender a entrega; não representam uma conta ou instalação atual. 0.3.1 · 2026-11-05 ## Gestão de tráfego Transforma objetivos, criativos e dados em campanhas acompanhadas e melhorias justificadas. Exemplo proposto · Skills, pastas, acessos e responsabilidades a definir na aplicação. Entradas: Objetivos, materiais e dados de mídia. Trabalho: Planeja, acompanha e melhora campanhas. Entregas: Planos, análises e próximos ajustes. ### Entradas Objetivos, materiais e dados de mídia. #### Objetivo e limites Resultado pretendido, oferta, público e verba definida. Necessário para: Distinguir uma campanha bem apresentada de uma campanha que serve ao objetivo. Origem: Direção da pessoa e fontes do negócio. #### Oferta e criativos Textos, peças, páginas e condições de uso. Necessário para: Planejar e conferir a comunicação da campanha. Origem: Material fornecido ou repositório competente. #### Dados e medição Campanhas, conversões, período e contexto. Necessário para: Analisar desempenho e sustentar hipóteses de melhoria. Origem: Plataformas e sistemas produtores, ou conteúdo fornecido. ### Rotinas de trabalho Do pedido à entrega, com os recursos necessários. #### Analisar uma campanha Entender resultado e preparar o próximo movimento. O que recebe: Objetivo, período, investimento, dados da campanha e conversões identificadas. O que faz: Compara resultado e objetivo; identifica diferenças, qualidade dos dados e hipóteses de ajuste. O que entrega: Análise com fonte, período, hipóteses e próximo teste. Como começa: Pessoa solicita a análise. Uma recorrência pode ser definida e configurada depois. Se faltar informação: Expõe a lacuna e limita a conclusão; não deduz venda apenas de clique ou lead. Consulte Analisar desempenho em Skills propostas. No mapa interativo, use “Ver Skill de análise” (referência interna: agent/skills/analisar). Consulte Dados/ em Pastas. No mapa interativo, use “Ver pasta de dados” (referência interna: agent/pastas/dados). Consulte Análise da campanha em Entregas. No mapa interativo, use “Ver modelo da entrega” (referência interna: outputs/entregas/analise). #### Preparar uma campanha Ligar objetivo, oferta, público, criativos e medição. O que recebe: Objetivo, oferta, público pretendido, materiais, verba definida e critérios de resultado. O que faz: Compõe campanha e plano de medição; identifica conteúdo e acesso que faltam. O que entrega: Plano de campanha utilizável para configuração e conferência. Quem decide: A pessoa responsável define objetivo e orçamento; as operações permitidas ao agente são estabelecidas por alcance. Consulte Planejar campanhas em Skills propostas. No mapa interativo, use “Ver Skill de planejamento” (referência interna: agent/skills/planejar). Consulte Planejamento/ em Pastas. No mapa interativo, use “Ver pasta de planejamento” (referência interna: agent/pastas/planejamento). #### Preparar uma mudança Relacionar ajuste proposto, motivo e forma de conferir. O que recebe: Diagnóstico, hipótese, resultado esperado e alcance de alteração autorizado. O que faz: Especifica a mudança e sua condição de comparação; executa somente se o meio e a ordem cobrirem a operação. O que entrega: Ajuste preparado ou aplicado, com diferença, fundamento e resultado da conferência. O que conserva: Configuração anterior pertinente e registro da mudança, para comparação. Consulte Preparar e conferir otimizações em Skills propostas. No mapa interativo, use “Ver Skill de otimização” (referência interna: agent/skills/otimizar). Consulte Registros/ em Pastas. No mapa interativo, use “Ver registro de mudanças” (referência interna: agent/pastas/registros). ### Skills propostas Nomes e funções para este exemplo de agente. #### Planejar campanhas Do objetivo ao plano de campanha. Quando usar: Ao iniciar uma campanha ou rever seu desenho. Entradas: Objetivo, oferta, público, criativos, verba definida e critérios de medição. Transformação: Relacionar estratégia, composição da campanha, materiais e condição de avaliação. Saída: Plano com hipóteses, estrutura, necessidades e conferência. Local sugerido: Skills/planejar-campanhas/SKILL.md #### Analisar desempenho De dados identificados a uma leitura fundamentada. Quando usar: Ao avaliar uma campanha e seu período. Entradas: Dados de mídia, objetivo, conversões e contexto do negócio disponíveis. Transformação: Comparar resultado, consistência dos dados e hipóteses; separar observação de interpretação. Saída: Análise com fontes, diferenças e próximos testes. Local sugerido: Skills/analisar-desempenho-de-campanhas/SKILL.md #### Preparar e conferir otimizações Da hipótese ao ajuste verificável. Quando usar: Quando a análise sustenta uma mudança a experimentar. Entradas: Diagnóstico, configuração vigente, alcance autorizado e critério de comparação. Transformação: Especificar alteração, efeito esperado e forma de verificar; aplicar se houver ordem e operação suficientes. Saída: Ajuste preparado ou aplicado com registro e conferência. Local sugerido: Skills/otimizar-campanhas/SKILL.md #### Produzir relatório de gestão Dos resultados à decisão que a pessoa precisa tomar. Quando usar: Ao consolidar o período para acompanhamento. Entradas: Análises, mudanças realizadas, resultados e pendências. Transformação: Selecionar o que muda a leitura do período e a próxima decisão. Saída: Relatório com conclusão, evidência, limite e próximo movimento. Local sugerido: Skills/relatar-gestao-de-trafego/SKILL.md ### Pastas Onde encontrar insumos, campanhas e resultados. #### Planejamento/ Objetivos, briefing, verba definida e plano de mídia. O que procurar: Briefing, contexto da oferta, critérios e plano vigente. O que guardar: Plano de campanha e revisões pertinentes. Recorte de arquivos: briefing.md · plano-de-campanha.md · criterios-de-medicao.md #### Campanhas/ Cada campanha conserva sua identidade e configuração. Organização possível: Uma subpasta por campanha identificada. O que procurar: Escopo, público, configurações e referência aos materiais usados. O que guardar: Configuração pertinente e mudanças que precisam ser comparadas. Exemplo de árvore: Campanhas/ → campanha-identificada/ → contexto.md, configuracao.md #### Criativos/ Materiais e versões usados nas campanhas. O que procurar: Peças, textos, referências e sua condição de uso. O que guardar: Versões e vínculos com as campanhas correspondentes. Propósito: Reencontrar o material efetivamente utilizado sem confundir versões. #### Dados/ Extrações e referências com período e origem. O que procurar: Dados da plataforma, conversões e recortes pertinentes. O que guardar: Extrações datadas ou referências para a fonte competente. Conferência: Identidade da campanha, intervalo, origem e definição das medidas. #### Relatorios/ Análises e entregas para acompanhamento. O que procurar: Última análise válida e relatório do período. O que guardar: Entregas com fonte, período, conclusão e próximo movimento. #### Registros/ Histórico útil de testes, alterações e decisões. O que procurar: O que mudou, por quê e qual comparação continua aberta. O que guardar: Hipótese, configuração anterior pertinente, ajuste e conferência. Propósito: Retomar o teste e reconhecer o resultado sem depender da memória do chat. ### Sistemas e fontes Aplicativos possíveis e a operação necessária. #### Meta Ads / Google Ads Campanhas, investimento e desempenho. Operação necessária: Ler os dados e a configuração dos objetos corretos. Se houver alteração: Conferir escrita e alcance da ordem por operação. Alternativa: Dados e configuração fornecidos pela pessoa. Condição neste cenário: Acesso a configurar e demonstrar; nenhum conector foi consultado. #### Site, conversões e CRM O que ocorre depois do anúncio. Operação necessária: Recuperar os eventos e resultados do negócio que a análise exige. O que relacionar: Campanha, período, identificação disponível e definição de conversão. Limite: A associação disponível não demonstra, sozinha, uma atribuição causal. #### Pastas ou repositório de trabalho Criativos, regras, planos e entregas. Operação necessária: Ler os insumos e salvar derivados no destino definido. Conferência: Conteúdo recebido e resultado salvo, separadamente. ### Responsabilidades e autonomia Quem contribui e quais efeitos o agente pode realizar. #### Operações e decisões Análise, mudança de campanha e direção têm alcances próprios. Agente de tráfego: Planeja, analisa, prepara materiais e realiza operações cobertas pela ordem e pelos meios disponíveis. Pessoa responsável pelo negócio: Define objetivos, verba e mudanças de alcance pertinentes. Conteúdo e comercial: Fornecem materiais e informações de oferta, atendimento e resultado quando fizerem parte do trabalho. O que precisa ficar escrito: Quais operações de leitura, alteração e publicação o agente pode realizar; que decisão permanece com outra pessoa. ### Estado e continuidade Campanhas, testes e decisões que precisam ser retomados. #### Retomar uma campanha Reconhecer o último resultado válido e o que falta conferir. Condição a preservar: Campanha, objetivo, período analisado, hipótese em teste, mudança realizada e próximo movimento. Fonte da condição: Registro competente do trabalho, com referências para dados e entregas. Como retoma: Nova execução recebe e lê essa condição antes de continuar. ### Entregas Planos, análises e próximos ajustes. #### Plano de campanha Deixa a configuração e a avaliação compreensíveis. Para que serve: Organizar a campanha a realizar. Quem recebe: Responsável pelo negócio e quem configura a campanha. Modelo: Objetivo → oferta/público → estrutura → criativos → verba definida → medição → condição de conferência. Destino sugerido: Planejamento/ ou subpasta da campanha. #### Análise da campanha Permite reconhecer resultado e decidir o próximo movimento. Para que serve: Entender diferenças e escolher o próximo teste. Quem recebe: Gestor e responsável pelo tráfego. Modelo: Campanha/período → objetivo → dados e fontes → leitura → hipóteses → limites → próximo movimento. Destino sugerido: Relatorios/ e referência na condição da campanha. Consulte Analisar desempenho em Skills propostas. No mapa interativo, use “Ver Skill correspondente” (referência interna: agent/skills/analisar). #### Ajuste e acompanhamento Mantém a relação entre hipótese, mudança e conferência. Para que serve: Saber o que foi proposto ou alterado e o que precisa ser observado. Quem recebe: Responsável pela campanha. Modelo: Hipótese → mudança → alcance recebido → aplicação/conferência → resultado a acompanhar. Destino sugerido: Registros/ e condição da campanha. ### Fontes cenario-trafego · Cenário hipotético de gestão de tráfego Descrição do caso neste modelo JSON. 0.3.0 · Insumo ilustrativo; sustenta a composição do exemplo, sem comprovar instalação ou operação. ## Gestão financeira Organiza compromissos, recebimentos e movimentos para acompanhar o caixa e sustentar decisões. Exemplo proposto · Skills, pastas, acessos e responsabilidades a definir na aplicação. Entradas: Documentos, títulos, movimentos e regras. Trabalho: Confere, concilia, organiza e acompanha. Entregas: Programações, posições e pendências. ### Entradas Documentos, títulos, movimentos e regras. #### Títulos e documentos Compromissos e evidência que os sustenta. Conteúdo: Identidade, natureza, vencimento, valor e documentos pertinentes ao trabalho. Origem: Sistema e repositório competentes, ou dados fornecidos para o caso. #### Movimentos e saldos O que efetivamente ocorreu nas fontes disponíveis. Conteúdo: Extratos, recebimentos, liquidações e saldos do período. Origem: Sistemas que produzem os movimentos ou arquivos fornecidos. #### Regras e direção Critérios, responsabilidades e limites do trabalho. Conteúdo: Critérios de conferência, distribuição de responsabilidades e alcance das operações. Origem: Decisões e documentos fornecidos pela organização. ### Frentes e rotinas Como o departamento transforma documentos em trabalho concluído. #### Contas a pagar Do título recebido à programação e ao registro do resultado. O que recebe: Títulos, documentos de suporte, vencimentos, dados do favorecido e regras fornecidas. O que faz: Confere identidade, completude, possível duplicidade e divergência; prepara a programação pertinente. O que entrega: Programação proposta com documentos relacionados e pendências explícitas. Quem participa: Responsável por contas a pagar; agente na contribuição definida; pessoa com autoridade para o efeito reservado. Como começa: Solicitação da pessoa neste cenário. Rotina por agenda exige configuração e prova próprias. Exceção: Título divergente ou insuficiente continua identificado para tratamento; não é completado por plausibilidade. Consulte Conferir títulos e documentos em Skills propostas. No mapa interativo, use “Ver Skill de conferência” (referência interna: agent/skills/titulos). Consulte Contas-a-pagar/ em Pastas. No mapa interativo, use “Ver pasta de contas a pagar” (referência interna: agent/pastas/pagar). Consulte Programação de compromissos em Entregas. No mapa interativo, use “Ver modelo da programação” (referência interna: outputs/entregas/programacao). #### Contas a receber Do compromisso de recebimento à posição acompanhada. O que recebe: Títulos a receber, condições acordadas e evidências de recebimento. O que faz: Relaciona compromisso, vencimento e recebimento; identifica diferença ou item sem correspondência. O que entrega: Posição de recebíveis e pendências para tratamento. Quem participa: Responsável pelo recebimento e comercial quando a informação do acordo for necessária. Exceção: Não tratar título previsto como recebido sem evidência. Consulte Acompanhar recebíveis em Skills propostas. No mapa interativo, use “Ver Skill de recebíveis” (referência interna: agent/skills/recebiveis). Consulte Contas-a-receber/ em Pastas. No mapa interativo, use “Ver pasta de recebíveis” (referência interna: agent/pastas/receber). #### Conciliação Relacionar registros e movimentos sem esconder diferenças. O que recebe: Registros de títulos e movimentos das fontes disponíveis. O que faz: Compara identidades, datas e valores; preserva o que não tem correspondência suficiente. O que entrega: Itens conciliados com base identificada e divergências a tratar. Quem participa: Responsável pela conciliação; outros participantes esclarecem o dado de origem quando necessário. Exceção: Não forçar uma correspondência ambígua para fechar a lista. Consulte Conciliar movimentos em Skills propostas. No mapa interativo, use “Ver Skill de conciliação” (referência interna: agent/skills/conciliar). Consulte Conciliacao/ em Pastas. No mapa interativo, use “Ver pasta de conciliação” (referência interna: agent/pastas/conciliacao). #### Caixa e fechamento Da condição conferida à visão de acompanhamento. O que recebe: Saldos, compromissos, recebíveis e diferenças pertinentes ao período. O que faz: Distingue realizado e previsto, organiza a posição e explicita premissas e pendências. O que entrega: Visão de caixa e fechamento no alcance dos dados conferidos. Quem participa: Responsável financeiro e gestor que decide prioridades ou novas ações. Exceção: Pendência de conciliação conserva seu efeito sobre a conclusão. Consulte Preparar visão de caixa em Skills propostas. No mapa interativo, use “Ver Skill de caixa” (referência interna: agent/skills/caixa). Consulte Caixa-e-fechamento/ em Pastas. No mapa interativo, use “Ver pasta de fechamento” (referência interna: agent/pastas/fechamento). ### Skills propostas Transformações que podem servir a mais de uma frente. #### Conferir títulos e documentos Prepara uma base identificada e pendências utilizáveis. Quando usar: Ao receber ou revisar um compromisso financeiro. Entradas: Título, documento, vencimento, identidade e critérios fornecidos. Transformação: Confrontar os campos, documentos e registros relacionados; localizar diferenças. Saída: Item conferido no alcance possível ou pendência com causa e próximo movimento. Local sugerido: Skills/conferir-titulos-e-documentos/SKILL.md #### Acompanhar recebíveis Relaciona compromisso e evidência de recebimento. Quando usar: Na atualização da carteira de recebimentos. Entradas: Títulos, condições acordadas e movimentos/evidências. Transformação: Identificar condição, diferença e necessidade de tratamento. Saída: Posição identificada de recebíveis e pendências. Local sugerido: Skills/acompanhar-recebiveis/SKILL.md #### Conciliar movimentos Confronta o registro financeiro com os movimentos. Quando usar: Ao conferir a correspondência entre fontes. Entradas: Registros e movimentos do mesmo objeto/período, com identidades suficientes. Transformação: Procurar correspondências sustentadas e separar divergências ou ambiguidades. Saída: Conciliação com referência e itens a tratar. Local sugerido: Skills/conciliar-movimentos/SKILL.md #### Preparar visão de caixa Organiza realizado, previsto e premissas. Quando usar: Ao preparar acompanhamento ou decisão sobre o período. Entradas: Saldos, compromissos, recebíveis e premissas fornecidas. Transformação: Relacionar os dados por período e explicitar limites e diferenças. Saída: Posição ou projeção de caixa no alcance informado. Local sugerido: Skills/preparar-visao-de-caixa/SKILL.md #### Preparar fechamento Reúne resultados e diferenças que permanecem abertas. Quando usar: Ao encerrar um recorte de acompanhamento. Entradas: Conciliação, posição de compromissos e resultados pertinentes. Transformação: Consolidar o período e explicar pendências que mudam sua leitura. Saída: Resumo de fechamento com fontes, limites e próximos movimentos. Local sugerido: Skills/preparar-fechamento-financeiro/SKILL.md ### Pastas Documentos, tratamento das frentes e entregas recuperáveis. #### Referencias/ Regras do trabalho e critérios fornecidos. O que procurar: Critérios de conferência, responsabilidades e alcance das operações. O que guardar: Referências vigentes com origem e relação de atualização. #### Contas-a-pagar/ Documentos e programação de compromissos. Organização possível: Uma subpasta por período ou agrupamento que o trabalho já utiliza. Exemplo de árvore: Contas-a-pagar/ → periodo/ → documentos/, programacao/, comprovantes/ O que guardar: Artefatos e evidências pertinentes; o título continua no sistema competente quando já existir ali. Propósito: Reencontrar a base e o resultado da programação sem duplicar o registro vigente. #### Contas-a-receber/ Acordos, posições e evidências pertinentes. O que procurar: Condições de recebimento e documentos do caso. O que guardar: Entregas e evidências ligadas à condição competente. #### Conciliacao/ Recortes de movimentos, correspondências e divergências. O que procurar: Fontes do período, resultado da conferência e itens abertos. O que guardar: Conciliação identificada e evidência suficiente para revisar diferenças. #### Caixa-e-fechamento/ Visões de caixa e entregas do período. O que procurar: Última posição válida, premissas e fechamento correspondente. O que guardar: Relatório ou tabela vinculados às fontes e à conferência. #### Registros/ Exceções, decisões e passagens úteis à continuidade. O que procurar: Diferença, tratamento acordado e condição para continuar. O que guardar: Contexto e evidência que não estejam suficientemente na fonte da demanda. ### Sistemas e fontes Onde está cada fato e qual operação precisa funcionar. #### Sistema financeiro / ERP Títulos e condição operacional dos registros. Operação necessária: Consultar os títulos e identidades pertinentes; escrita exige capacidade e alcance próprios. Casa da condição: O registro competente do sistema, se já governa aquele objeto. Alternativa: Extrato de dados fornecido e identificado para o período. Condição neste cenário: Fonte e acesso a definir; nenhum sistema foi consultado. #### Bancos e meios de recebimento Movimentos, saldos e evidências de liquidação. Operação necessária: Recuperar o movimento e período necessários à conferência. O que distinguir: Consulta de movimentação, preparação de uma operação e execução de pagamento são capacidades diferentes. Condição neste cenário: Sem operação de conta ou pagamento. #### Pasta ou repositório documental Documentos, comprovantes e relatórios. Operação necessária: Ler a base de suporte e preservar artefatos autorizados. O que conferir: Objeto, edição, destino e resultado da gravação. ### Responsabilidades e autonomia Quem prepara, confere, decide e realiza cada efeito. #### Papel do agente e das pessoas O nome do departamento não define uma autorização única. Agente financeiro: Organiza, confere, concilia e prepara posições e efeitos no alcance recebido. Responsáveis pelas frentes: Mantêm as informações e tratam pendências segundo a distribuição real de trabalho. Gestor ou autoridade definida: Decide prioridades, compromissos e efeitos que lhe forem reservados. Operação material: Ler um título, corrigir registro, preparar programação e efetuar pagamento exigem alcances próprios. O que o mapa precisa mostrar: Responsável pertinente e ordem aplicável em cada passagem; sem inventar aprovação para todo passo. ### Estado e continuidade O que permanece aberto entre uma rodada e outra. #### Retomar o departamento Saber qual condição usar e que diferença exige atenção. Condição a recuperar: Período, fonte vigente, último resultado válido, divergências, decisões e próximo movimento. O que evitar: Dois lugares editáveis afirmando condições diferentes para o mesmo título. Como retoma: Execução recebe a condição competente e confere o que mudou. ### Entregas Programações, posições e pendências. #### Programação de compromissos Permite organizar o tratamento do que vence. Para que serve: Reconhecer compromissos, base e pendências antes da operação seguinte. Quem recebe: Responsável por contas a pagar e autoridade pertinente. Modelo: ID → compromisso → vencimento → documento → conferência → pendência → próximo movimento. Destino sugerido: Registro competente do trabalho, com artefato em Contas-a-pagar/ quando necessário. Condição: Programação preparada não demonstra pagamento. Consulte Contas a pagar em Frentes e rotinas. No mapa interativo, use “Ver rotina correspondente” (referência interna: agent/rotinas/pagar). Consulte Conferir títulos e documentos em Skills propostas. No mapa interativo, use “Ver Skill de conferência” (referência interna: agent/skills/titulos). #### Posição e visão de caixa Distingue realizado, previsto e diferenças. Para que serve: Acompanhar o período e sustentar a decisão do gestor. Quem recebe: Responsável financeiro e gestor. Modelo: Período → fontes → realizado → previsto → premissas → divergências → decisão necessária. Destino sugerido: Caixa-e-fechamento/ ou ambiente de gestão existente. #### Fechamento e pendências Deixa explícito o que foi conferido e o que continua aberto. Para que serve: Retomar o trabalho e concluir o tratamento das diferenças. Quem recebe: Responsáveis pelas frentes e gestor. Modelo: Objeto → diferença → fundamento → responsável definido → próximo movimento → condição de retomada. Destino sugerido: Fonte da condição, com referência à conciliação e ao fechamento. ### Fontes cenario-financeiro · Cenário hipotético de gestão financeira Descrição do caso neste modelo JSON. 0.3.0 · Insumo ilustrativo; sustenta a composição do exemplo, sem comprovar instalação ou operação.