Quando Usar

• Use quando o fluxo de trabalho anterior corresponder ao objetivo declarado do usuário.
• Use quando a tarefa exigir os procedimentos documentados nesta habilidade.

Gerar esquema de saída do Actor

Você está gerando arquivos de esquema de saída para um Apify Actor. O esquema de saída informa ao Apify Console como exibir os resultados da execução. Você analisará o código-fonte do Actor, criará dataset_schema.json, output_schema.json e key_value_store_schema.json (se o Actor usar o armazenamento chave-valor) e atualizará actor.json.

Princípios Fundamentais

• Analise o código primeiro: Leia o código do Actor para entender quais dados ele realmente envia para o conjunto de dados — nunca adivinhe.
• Todo campo é anulável: APIs e sites são imprevisíveis — sempre defina "nullable": true.
• Anonimize exemplos: Nunca use IDs de usuário, nomes de usuário ou dados pessoais reais em exemplos.
• Verifique contra o código: Se houver tipos TypeScript, compare o esquema com a definição do tipo E o código que produz os valores.
• Reutilize padrões existentes: Antes de gerar esquemas, verifique se outros Actors no mesmo repositório já possuem esquemas de saída — combine a estrutura, convenções de nomenclatura, estilo de descrição e formatação deles.
• Não reinvente a roda: Reutilize definições de tipo, interfaces e utilitários existentes do código-fonte em vez de criar definições duplicadas.

Fase 1: Descobrir a estrutura do Actor

Objetivo: Localizar o Actor e entender sua saída

Solicitação inicial: $ARGUMENTS

Ações:

1. Crie uma lista de tarefas com todas as fases.
2. Encontre o diretório .actor/ contendo actor.json.
3. Leia actor.json para entender a configuração do Actor.
4. Verifique se dataset_schema.json, output_schema.json e key_value_store_schema.json já existem.
5. Procure por esquemas existentes no repositório: Procure por outros diretórios .actor/ ou arquivos de esquema (por exemplo, **/dataset_schema.json, **/output_schema.json, **/key_value_store_schema.json) para aprender as convenções do repositório — combine o estilo de descrição, nomenclatura de campos, formatação de exemplos e estrutura geral deles.
6. Encontre todos os locais onde os dados são enviados para o conjunto de dados:
   • JavaScript/TypeScript: Procure por Actor.pushData(, dataset.pushData(, Dataset.pushData(.
   • Python: Procure por Actor.push_data(, dataset.push_data(, Dataset.push_data(.
7. Encontre todos os locais onde os dados são armazenados no armazenamento chave-valor:
   • JavaScript/TypeScript: Procure por Actor.setValue(, keyValueStore.setValue(, KeyValueStore.setValue(.
   • Python: Procure por Actor.set_value(, key_value_store.set_value(, KeyValueStore.set_value(.
8. Encontre definições de tipo de saída — reutilize-as diretamente em vez de recriá-las do zero:
   • TypeScript: Procure por interfaces/tipos de saída (por exemplo, em src/types/, src/types/output.ts). Se uma interface ou tipo já define a forma da saída, derive os campos do esquema a partir dela — não crie uma definição paralela.
   • Python: Procure por definições TypedDict, dataclass ou Pydantic model. Use os nomes de campo, tipos e docstrings existentes como fonte da verdade.
9. Verifique se há utilitários de esquema compartilhados ou funções auxiliares existentes no código-fonte que lidam com a geração ou validação de esquemas — reutilize-os em vez de criar nova lógica.
10. Se houver configuração inline de storages.dataset ou storages.keyValueStore em actor.json, anote para migração.

Apresente as descobertas ao usuário: liste todos os campos de saída do conjunto de dados descobertos, chaves do armazenamento chave-valor, seus tipos e de onde eles vêm.

Fase 2: Gerar dataset_schema.json

Objetivo: Criar um esquema de conjunto de dados completo com definições de campo e visualizações de exibição

Estrutura do arquivo

{
    "actorSpecification": 1,
    "fields": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "type": "object",
        "properties": {
            // TODOS os campos de saída aqui — todo campo que o Actor pode produzir,
            // não apenas os mostrados na visualização geral
        },
        "required": [],
        "additionalProperties": true
    },
    "views": {
        "overview": {
            "title": "Visão Geral",
            "description": "Campos mais importantes em um relance",
            "transformation": {
                "fields": [
                    // 8-12 nomes de campo mais importantes
                ]
            },
            "display": {
                "component": "table",
                "properties": {
                    // Configuração de exibição para cada campo da visão geral
                }
            }