GEO Writer
Crie e faça a gestão de tarefas do GEO Writer com IA. As tarefas são processadas de forma assíncrona, por isso crie uma e faça polling até estar concluída.
POST/intelligence_tasks
Crie uma tarefa do GEO Writer. Dois modos: baseado num prompt (indique prompt_id) ou agêntico (indique custom_topic e/ou user_instructions). O tipo product_listing recebe, em vez disso, um objeto product e devolve texto de página de produto pronto a aplicar.
project_idobrigatóriotask_typeobrigatório: brief, create, update, pr_insights, custom, product_listingprompt_idcustom_topicuser_instructionsoutput_language_codeexisting_contentexisting_content_url
Apenas para product_listing: product (obrigatório: title, além de external_id, description_html, seo_title, seo_description, url, product_type e até 20 images com id e alt) e prompt_ids (até 20 prompts do projeto para os quais orientar o texto). O result_data da tarefa concluída inclui summary, description_html, faq, seo_title, seo_description, image_alts e changes.
GET/intelligence_tasks
Liste as tarefas do GEO Writer de um projeto com filtragem opcional.
project_idobrigatóriotask_typestatuspageper_page
GET/intelligence_tasks/:id
Obtenha os detalhes completos da tarefa, incluindo os dados do resultado quando estiver concluída. Aceita o ID numérico ou o public_id.
project_idobrigatório:idID da tarefa ou public_id no URL
PATCH/intelligence_tasks/:id
Edite blocos de texto existentes de uma tarefa concluída sem a regenerar. Cada chave de edits é um caminho com pontos para um valor de texto de result_data (por exemplo, sections.0.content) e só é possível alterar texto existente. Um valor igual ao texto guardado é ignorado e a primeira edição guarda uma cópia da versão de IA para que possa ser restaurada.
project_idobrigatório:idID da tarefa ou public_id no URLeditsobrigatório, objeto que associa caminhos em notação de pontos ao novo texto
Requer uma chave de API com âmbito de escrita.
result_version (opcional): envie o result_version devolvido quando leu a tarefa. Se a tarefa tiver sido regenerada entretanto, a edição é recusada com ERR_STALE_CONTENT (HTTP 409) e nada é guardado: leia a tarefa novamente e reenvie as suas edições. Sem este parâmetro, as edições aplicam-se ao conteúdo que a tarefa tiver no momento do pedido.
POST/intelligence_tasks/:id/revert
Descarta todas as edições manuais e restaura a versão de IA guardada na primeira edição. Devolve ERR_INVALID_PARAM quando a tarefa não tem edições manuais.
project_idobrigatório:idID da tarefa ou public_id no URL
Requer uma chave de API com âmbito de escrita.