sapiens_write
Create, update, and publish personal Sapiens articles from a brief or existing text. Manage drafts, covers, and voice styles while spending credits, saving results to your profile.
Instructions
Artigos self-serve do PRÓPRIO usuário (qualquer conta logada, não só admin) — espaço pessoal, aparece em /u/, NÃO é o blog editorial. Sub-actions: generate (gera 1 artigo na voz Sapiens a partir de brief livre, ou reescrevendo um artigo publicado/texto teu; custa 400 Sinapses, reembolsa se falhar; salva como rascunho. Capa: por padrão gera uma capa-cortesia grátis; se você JÁ tem a imagem (gerou via sapiens_image, ou o artigo é sobre ela), passe coverImageId (id da tua galeria) ou coverImageUrl (host Sapiens) pra ELA virar a capa em vez da cortesia), list (teus artigos), get (1 artigo teu por id, corpo completo), update (edita title/content/excerpt/tldr), publish (publish=true publica no teu perfil, false volta pra rascunho). Identidade vem do sessionToken; cobra as Sinapses do dono do token. Pra blog editorial curado (owner-only) use sapiens_article. NOTA (generate): é SÍNCRONA (texto + capa) e cai na REGRA DO TIMEOUT; sem idempotência, repetir às cegas cria um 2º rascunho e cobra 400 de novo (cheque action=list antes; o artigo do timeout fica salvo como rascunho).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tldr | No | ||
| brief | No | Briefing livre (1 parágrafo, até ~600 palavras). Caminho padrão de 'generate'. A IA expande na voz Sapiens. Custa 400 Sinapses. | |
| limit | No | Default 50. Max 100. Só pra action=list. | |
| title | No | ||
| action | Yes | ||
| content | No | Markdown completo do corpo (substitui o conteúdo). | |
| excerpt | No | ||
| publish | No | action=publish: true publica no teu perfil (/u/<username>), false volta pra rascunho. Default true. | |
| articleId | No | user_articles:_id (obrigatório pra get/update/publish). | |
| sourceKind | No | Default 'brief'. 'published_article' reescreve um artigo do blog (passe publishedArticleId); 'user_article' reescreve um texto teu (passe sourceUserArticleId). | |
| voiceStyle | No | Preset de tom da voz (opcional). | |
| customVoice | No | Instrução de voz custom (opcional). | |
| voiceSource | No | Qual voz molda o texto: 'sapiens' (default, piso da casa) | 'minha' (a tua alma, destilada do teu rastro) | 'sintetico' (a alma do teu Sintético, se tiveres um acordado em Sintonia). Omitido = comportamento igual a 'sapiens'. | |
| coverImageId | No | Capa PRONTA (opcional, só generate): id de uma imagem da TUA galeria (generatedImages:_id, ache via sapiens_gallery/sapiens_reference) que vira a capa do artigo em vez da capa-cortesia gerada do zero. Use quando você JÁ gerou a imagem (sapiens_image) e o artigo é sobre ela — assim a peça não nasce sem capa se a cortesia falhar. | |
| coverImageUrl | No | Alternativa a coverImageId: URL de imagem do Sapiens (Bunny CDN / Convex) pra usar como capa pronta. Host fora da allowlist é recusado. | |
| repertorioItemIds | No | Até 5 ids de obras do Repertório do usuário (repertorioItems:_id) pra IA usar como lente/referência do texto (sinopse + nota do dono entram no prompt). Ache os ids via sapiens_repertorio (action=list/search). Só do próprio usuário; ids de outros são ignorados. | |
| publishedArticleId | No | articles:_id (quando sourceKind='published_article'). | |
| sourceUserArticleId | No | user_articles:_id (quando sourceKind='user_article'). |