Habilidades agênticas

O Meridian oferece um conjunto de habilidades de agentes interativas projetadas para ajudar cientistas de dados e engenheiros em todo o ciclo de vida da modelagem do mix de marketing (MMM).

Essas habilidades seguem a especificação de habilidades de agentes aberta e fornecem aos assistentes de programação de IA conhecimento específico do domínio para ajudar na preparação de dados, na configuração de distribuições a priori, ajuste de modelos, análise de diagnósticos, execução de otimizações de orçamento e planejamento de cenários.

O que são habilidades de agentes?

As habilidades de agentes são pacotes de recursos modulares e padronizados que contêm instruções, modelos de referência e scripts. Quando integradas a um assistente de programação de IA, as habilidades permitem ao agente:

  • Acompanhar você passo a passo: explore configurações estatísticas complexas sem precisar memorizar toda a API.
  • Inferir mapeamentos de esquema: analise os cabeçalhos de coluna CSV brutos e sugira mapeamentos apropriados para KPIs, gasto de mídia, impressões, alcance/frequência e variáveis de controle.
  • Manter o controle human-in-the-loop: apresente propostas de configuração (como distribuições a priori bayesianas, seleção de nós e restrições de gastos) em pontos de controle críticos e aguarde sua confirmação antes da execução.
  • Gerar scripts Python reproduzíveis: produza scripts Python independentes executáveis diretamente em ambientes virtuais Python padrão (python3 script.py).

Habilidades disponíveis do Meridian

O Meridian inclui cinco habilidades especializadas que abrangem cada etapa da jornada de MMM:

Habilidade Identificador Descrição Principais resultados
Consultor de documentação meridian-doc-consultant Responde a perguntas conceituais, matemáticas e de configuração citando a documentação relevante do Meridian. Explicações e referências técnicas fundamentadas
Criação de modelos meridian-model-building Orienta você no carregamento de dados CSV, mapeamento de colunas, configuração a priori de ModelSpec, análise de dados exploratória (EDA, na sigla em inglês), ajuste de MCMC e salvamento de modelos. Script Python, relatório HTML de EDA, arquivo modelo salvo (.binpb)
Visualização de resultados meridian-result-visualization Carrega modelos ajustados para gerar verificações de integridade de convergência de MCMC (Reviewer) e relatórios de resumo executivo de 2 páginas (Summarizer). HTML da verificação de integridade, HTML dos resultados do resumo
Otimização do orçamento meridian-budget-optimization Configura e executa otimizações de orçamento fixo/flexível e cenários de gastos com ROI desejado. HTML do relatório de otimização de orçamento
Planejador de cenários meridian-scenario-planner Prepara os dados do planejador de cenários e fornece instruções de transferência para criar painéis do Looker Studio. Arquivo de dados do planejador de cenários (.binpb), URL do painel

Instalação e descoberta

As habilidades do Meridian são distribuídas diretamente no repositório de código aberto e podem ser adicionadas ao seu espaço de trabalho usando ferramentas de agente padrão.

Instalar usando a CLI de Habilidade

Se você tiver o Node.js / npm no seu ambiente, poderá instalar todas as habilidades do Meridian ou habilidades individuais específicas usando npx skills:

# Install all Meridian skills into your workspace
npx skills add google/meridian
# Or install a specific skill (e.g., model building)
npx skills add google/meridian --skill meridian-model-building

Descoberta manual ou no repositório

Se você preferir não usar o npx ou estiver trabalhando em um ambiente Python puro:

  • Descoberta no repositório: se você clonar ou desenvolver diretamente no repositório google/meridian, os assistentes de programação de IA compatíveis vão descobrir automaticamente todas as habilidades disponíveis usando o manifesto do espaço de trabalho em .agents/skills.json e o diretório skills/.
  • Cópia manual: é possível copiar as subpastas skills/ (por exemplo, meridian_model_building/) do repositório diretamente para o diretório .agents/skills/ do projeto.

Ambientes compatíveis

As habilidades do Meridian são criadas com base na especificação de habilidades de agentes aberta. Como usam padrões abertos (instruções padrão do Markdown e modelos modulares do Python), elas são projetadas para serem compatíveis com qualquer ambiente de programação de agentes, extensão de ambiente de desenvolvimento integrado ou ferramenta de CLI com suporte ao padrão de habilidades de agentes.

Segurança e verificação human-in-the-loop

As habilidades do Meridian seguem um projeto baseado em pontos de controle. Durante as sessões interativas, o agente vai pausar e solicitar sua revisão antes de:

  1. Finalizar os mapeamentos de colunas do conjunto de dados.
  2. Definir parâmetros de distribuições a priori bayesianos (como distribuições a priori de ROI ou espaçamento de nós).
  3. Executar jobs longos de amostragem a posteriori de MCMC.
  4. Executar scripts gerados no ambiente local.

Assim, você mantém total visibilidade e controle sobre suas decisões de modelagem, além de se beneficiar da criação automatizada de scripts.