Les propositions : ce pour quoi votre IA vous demande oui

Quand votre IA veut que quelque chose parte ou change, elle fait une proposition. Vous la voyez comme une carte oui. Cette page est pour votre IA : elle liste ce dont chaque sorte de proposition a besoin, pour que ce soit juste du premier coup.

Comment fonctionne une proposition

• propose prend le number de la tâche, un kind, un titre de 200 caractères au plus, le payload et le run_id.
• Le payload de chaque kind a des clés exactes : celles listées ci-dessous, aucune autre. Une clé avec ? peut être omise.
• Après propose, votre IA vous donne le lien du oui et attend votre réponse.

Les e-mails

• email : { to, subject, text, separately?, send_at? }. Une newsletter : { audience: "newsletter", subject, text, send_at? }.
• Un e-mail part vers 1 à 20 personnes. L'objet fait 200 caractères au plus et le texte 50 000 au plus.
• send_at est une heure avec son décalage horaire, au plus 400 jours à l'avance.
• separately: true envoie à chaque personne sa propre copie, pour que personne ne voie les autres.
• Une séquence s'utilise seulement avec le kind email.

Les publications

• post : { accounts, text, when, title?, media_urls?, content_item_id?, content_item_version? }.
• Le texte fait 5 000 caractères au plus, le titre 100 au plus (YouTube en demande un). Comptes : de 1 à 20. Jusqu'à 10 media_urls, uniquement des liens https.
• Publiez seulement sur les comptes listés dans departments/marketing.md.
• Pour un film ou une image de la médiathèque, donnez content_item_id et content_item_version ensemble (les deux ou aucun), et laissez media_urls de côté : le lien est créé après le oui.
• Pour déplacer une publication prévue, utilisez post_move : { proposal_id, when }, avec une heure à venir et son décalage horaire. Une publication déjà en cours d'envoi ne peut pas être déplacée.

Changements et suppressions de fichiers

• file_change : { path, body, base_version }. file_delete : { path, base_version }.
• base_version est un nombre : la version que read vous a donnée. Pour une suppression, c'est 1 ou plus.
• Le chemin suit les mêmes règles que write (voir "Le dossier de votre entreprise").

Les imports

• people_import et invoice_import : { source, count, samples, rows }. people_import peut ajouter consent: { count?, date, source } pour les lignes qui ont dit oui à la newsletter.
• Les lignes sont mises directement dans la proposition, chaque ligne comme un objet, jamais comme un fichier.
• Jusqu'à 5 000 lignes et 240 000 caractères par import. Découpez tout ce qui est plus gros.
• Jusqu'à 3 exemples à montrer au propriétaire. La source fait 100 caractères au plus.

Les autres sortes

• department_on : { department }. Direction et Systèmes sont toujours activés, ils n'en ont donc jamais besoin.
• record_delete : { module, key, why }. La fiche doit exister, et why est une phrase simple de 300 caractères au plus.
• company_new : { name }, un nom de 2 à 120 caractères.
• site_publish : { site, version }, exactement comme deploy_site l'a renvoyé. Voir "Votre site".