• Hulp · Verbind je AI

Voorstellen: waarvoor je AI om je ja vraagt

Als je AI wil dat iets de deur uitgaat of verandert, maakt hij een voorstel. Jij ziet het als een ja-kaart. Deze pagina is voor je AI: ze noemt wat elk soort voorstel nodig heeft, zodat het meteen goed is.

Hoe een voorstel werkt

  • propose neemt de number van de taak, een kind, een titel van maximaal 200 tekens, de payload en de run_id.
  • De payload van elk soort heeft precies deze sleutels: die hieronder, geen andere. Een sleutel met ? mag je weglaten.
  • Na propose geeft je AI je de ja-link en wacht hij op je antwoord.

E-mails

  • email: { to, subject, text, separately?, send_at? }. Een nieuwsbrief: { audience: "newsletter", subject, text, send_at? }.
  • Een e-mail gaat naar 1 tot 20 mensen. Het onderwerp is maximaal 200 tekens en de tekst maximaal 50.000.
  • send_at is een tijd met de tijdzoneverschuiving erbij, maximaal 400 dagen vooruit.
  • separately: true stuurt iedereen een eigen kopie, zodat niemand de anderen ziet.
  • Een reeks gaat alleen mee met kind email.

Posts

  • post: { accounts, text, when, title?, media_urls?, content_item_id?, content_item_version? }.
  • De tekst is maximaal 5.000 tekens, de titel maximaal 100 (YouTube heeft er een nodig). Accounts: 1 tot 20. Maximaal 10 media_urls, alleen https-links.
  • Post alleen naar accounts die op departments/marketing.md staan.
  • Voor een film of afbeelding uit de mediabibliotheek geef je content_item_id en content_item_version samen (allebei of geen van beide), en laat je media_urls weg: de link wordt gemaakt na de ja.
  • Om een ingeplande post te verplaatsen, gebruik je post_move: { proposal_id, when }, met een tijd in de toekomst en de tijdzoneverschuiving erbij. Een post die al wordt verstuurd, kan niet meer verplaatst worden.

Bestanden wijzigen en verwijderen

  • file_change: { path, body, base_version }. file_delete: { path, base_version }.
  • base_version is een getal: de versie die read je gaf. Bij een verwijdering is het 1 of meer.
  • Het pad volgt dezelfde regels als write (zie "Je bedrijfsmap").

Importeren

  • people_import en invoice_import: { source, count, samples, rows }. people_import mag consent: { count?, date, source } toevoegen voor de rijen die ja zeiden tegen de nieuwsbrief.
  • De rijen gaan direct mee, elke rij als object, nooit als bestand.
  • Maximaal 5.000 rijen en 240.000 tekens per import. Splits alles wat groter is.
  • Maximaal 3 voorbeelden om de eigenaar te laten zien. De bron is maximaal 100 tekens.

Andere soorten

  • department_on: { department }. Management en Systemen staan altijd aan, dus die hebben het nooit nodig.
  • record_delete: { module, key, why }. Het gegeven moet bestaan, en why is één gewone zin van maximaal 300 tekens.
  • company_new: { name }, een naam van 2 tot 120 tekens.
  • site_publish: { site, version }, precies zoals deploy_site antwoordde. Zie "Je website".