ACME Agents

Showing 25 of 42 from the live probe.

• Get Brand

  Marca del tenant: paleta, voz, avatares, dominio. Revisá SIEMPRE el campo "configurada": si es false, esto NO es la marca del tenant — es el fallback histórico a Endonautas (plataforma era mono-marca). No lo presentes como si fuera la marca real del usuario: avisale y sugerí generate_brand + update_brand antes de generar contenido.

• Get Capabilities

  Catálogo real y vigente de este tenant — llamar ANTES de create_article para no adivinar combinaciones. Devuelve: estilos (incluye None=evergreen, con descripción de cada uno), tipos (lista completa de 'tipo' para vehiculo), directores (los 8: 7 elegidos por el scorer + ucg, con descripción de estilo), y vehiculos_disponibles (los que YA tienen contexto narrativo o assets curados — cada uno con assets_visuales: bool, true = fondos+cutouts calentados en caché, false = crea

• List Brand Videos

  Videos subidos por el tenant (biblioteca propia) — usar el 'file' de un video con has_voice=true y sin 'processing' como source_video de create_article(estilo='ucg').

• List Brand Backgrounds

  Fondos full-bleed de la biblioteca del tenant (para carruseles). Cada uno trae 'file' (usarlo para delete_brand_background) y 'comun' (true = fondo compartido de la plataforma, NO se puede borrar; false = propio del tenant). Ver antes de subir o limpiar la biblioteca.

• List Brand Images

  Imágenes de personaje/producto subidas por el tenant (cutouts/vehicle_art). Cada una trae 'file' (usarlo para delete_brand_image).

• Delete Brand Background

  Borra un fondo propio del tenant (irreversible: quita el archivo + copia en R2). 'file' es el campo de list_brand_backgrounds. Solo fondos propios (comun=false). Requiere confirm=True — el humano confirmó ESTE borrado.

• Delete Brand Image

  Borra una imagen de personaje/producto propia (irreversible). 'file' es el campo de list_brand_images. Requiere confirm=True — el humano confirmó ESTE borrado.

• Delete Brand Video

  Borra un video propio de la biblioteca (irreversible). 'file' es el campo de list_brand_videos. Requiere confirm=True — el humano confirmó ESTE borrado.

• Update Brand

  Ajusta config del tenant (incluye brand). Envía solo las claves a cambiar.

• Trim Video Silences

  Corta los silencios largos de un video de la biblioteca y guarda el resultado como un video NUEVO (no reemplaza el original — un corte automático puede quedar mal y hay que poder volver). `file` sale de list_brand_videos. Corta imagen y audio juntos. Las pausas cortas del habla se respetan: solo se van los huecos ≥0.6s. El video nuevo entra en processing (se normaliza y se re-transcribe: los timestamps cambiaron) — esperá a que `processing` sea false en list_brand_videos

• Search Ig Audio

  Busca música en el catálogo LICENCIADO de Instagram con la cuenta del tenant. Sin `query` devuelve el trending de la región de esa cuenta. audio_type: 'music' | 'original_sound'. Para qué sirve: el sonido es parte de la marca. El Brand Agent propone el mood y términos en `brand.audio_style.busqueda`; con esta tool se buscan candidatos reales y los elegidos se guardan con update_brand({"brand": {"audio_style": {"audios": [{"audio_id": "...", "title": "..."}]}}}). Al p

• Get Recommendations

  Qué le rinde a ESTA marca: la cara 'enseña' de la plataforma. Lee el perfil de generación aprendido (de analyze_brand_history / uso) + los playbooks, y sugiere qué intent/objetivo/ángulos/director usar para sacar el máximo provecho. Sin datos aún → devuelve una guía para poblarlo. Consultar ANTES de una tanda de contenido para afinar las llamadas a create_article a lo que funciona para la marca. Trae también `ciclo`: en qué semana va el tenant, qué plan de planes_ciclo le toc

• Analyze Brand History

  Cold-start del perfil de generación: aprende de lo que YA le funcionó a la marca y afina la generación futura hacia su estilo y lo que le trae tráfico calificado. Fuente: 'posts' de un informe ([{caption, likes, comments}]); source='instagram' (lee la cuenta conectada — likes/comentarios/caption, scopes actuales, sin saves/reach); o source='published' (aprende de las piezas PROPIAS ya publicadas por la plataforma, con su engagement medido por el puller de métricas — cierra el

• Generate Brand

  Onboarding de un negocio: arma un perfil de marca (voz, avatares, paleta, CTAs) desde un brief. NO lo guarda — devuelve el perfil para revisar; persistilo con update_brand(config). material: el brief en texto (o el resultado de extract_brand_doc / el texto del sitio). site_url: opcional, la plataforma le suma el texto del sitio al material. answers: respuestas a preguntas de discovery (opcional). Flujo típico: extract_brand_doc → generate_brand → (revisar) → update_brand.

• Extract Brand Doc

  Extrae el texto de un brief subido (pdf/docx/txt/md) para alimentar generate_brand. file_base64: contenido del archivo en base64, sin prefijo data:URI. Devuelve el texto para pasarlo como 'material' a generate_brand.

• Update Article

  Edita metadata de una pieza sin regenerarla. Uso principal: AGENDAR — publish_at='YYYY-MM-DD' programa la publicación (calendario/Lanzador). Solo se mandan los campos provistos; para QUITAR una fecha ya agendada (despausar) usá el frontend/PATCH directo (este tool solo setea). (Agendar ≠ publish: publish postea YA; esto reserva fecha.) trial_reel=True publica esa pieza como TRIAL REEL de Instagram: solo la ven NO seguidores. Sirve para testear ganchos sin gastar alcance con

• Create Article

  Encola una pieza: dispara CopyAgent (~60-90s hasta 'scored'). layer: awareness|consideration|decision. intent (opcional): declara QUÉ quiere lograr la pieza y activa un playbook de generación compartido entre todas las marcas (ver get_capabilities().intents). Hoy: 'conversion' — orienta el copy a captación/venta (identificación antes de oferta, ángulos validados, CTA de lead-magnet 'comenta [PALABRA]', sesgo de director hacia impacto/interpelación, y scorer por conversion_fit

• Get Article

  Estado + variantes + viral_scores + r2_urls de una pieza.

• List Articles

  Piezas del tenant, opcionalmente filtradas por status.

• Approve Variants

  Aprueba finalistas y dispara VisualAgent. Cada selección: {finalist_id, director, carousel: bool, reel: bool, single: bool} — single activa el post de imagen única (estilo 'collage', 2026-07-21).

• Regenerate Copy

  Regenera el copy de UNA variante con una instrucción, sin gastar cuota (barato, DeepSeek). Genera 3 candidatos inyectando 'avatar_instruction' en el ángulo del avatar y se queda con el de mayor score. Usar cuando el copy está 90% pero un hook/CTA no convence — más quirúrgico que borrar y recrear. En 'scored', antes de approve_variants. vehiculo/tipo (opcional): reconecta el copy a un referente y lo persiste para el visual.

• Get Visual Plan

  Plan de assets antes de renderizar: guion final, duración, qué fondo/ personaje va en cada slide/segmento, avisos (ej. 'solo 2 fondos → se repiten'). Cada carousel/reel trae también candidates.pool: fondos/b-rolls ALTERNATIVOS (~20 carrusel, ~12 reel) que se pueden elegir en lugar del asset por defecto de un segmento. Si la pieza pidió single (estilo collage), trae además una sección 'single' con un solo slide (reusa la portada del carrusel) + su propio candidates.pool —

• Approve Visual Plan

  Aprueba el visual_plan y dispara el render real. Sin edits (o edits=[]) se renderiza tal cual el plan (el asset por defecto de cada segmento). edits opcional, uno o más de: - {finalist_id, segment_index, select_asset_id}: cambia el fondo/b-roll de ese segmento por un candidato del pool (path exacto de candidates.pool). - {discard_asset_id}: descarta un candidato (path) — se oculta del pool de este artículo, no de la biblioteca compartida. - {finalist_id,

• List Templates

  Catálogo de plantillas y variantes predefinidas por elemento del editor visual. kind='carrusel': layouts L1..L4 + logo_variants (4 esquinas × 3 tamaños). kind='reel': presets de director (contrain|loop|documental|edu|hook|pregunta| quote|ucg) + text_variants (3 tercios × 3 alineaciones). Elegir de acá — nunca escribir x/y/font arbitrarios (eso es del editor visual humano).

• Apply Template

  Aplica una plantilla completa a una variante del visual_plan. kind='carrusel': layout L1|L2|L3|L4 → resetea posición default de logo/texto en todos los slides. kind='reel': layout = nombre de preset (ver list_templates) → cambia el tratamiento visual del reel (director) re-materializando su composición desde el copy actual. recalculate_copy=True (solo reel) regenera además el copy del reel con palabras nuevas — el copy de reel es director-agnóstico, así que esto es 'copy