EdBuild AI

Modify existing activities; activities are created by edbuild_generate_activities. Covers the types EdBuild AI generates. In `activity.content`, only the fields sent change: they replace the stored ones, a list (questions, cards, terms…) being replaced whole, so it goes complete; for a text, its html (the plain text follows); for an AI podcast (audio), its whole script, the audio being rendered with edbuild_podcast_render afterwards. An activity keeps its type. `position` moves the activity among its notion activities. Items run in order and stop at the first failing one; the response lists the items already applied, so only the others need a retry.

edbuild_activities_write

Read the status of EdBuild background jobs from the job ids other EdBuild tools returned: activity generation, PDF analysis, notion video, podcast script or synthesis, video render (kind). Each job comes with its status (pending, processing or running, completed, failed), what it concerns, the error when it failed, and a next_step. Set wait_seconds (up to 50) to wait here until every job is over instead of calling again and again. A job still running past its time limit is reported as failed.

edbuild_job_status

Generate the activities of one or more notions with EdBuild AI, from each notion's source text and objectives: the default way to fill a formation. It takes no free-form instructions (difficulty, tone, focus): a result is steered afterwards by editing the generated activities with edbuild_activities_write. Each notion's chapter is analyzed from its PDF first (edbuild_chapter_analyze_pdf). The user agrees on each notion's activity types beforehand; the default offer is every type but the notion summary, video and podcast included (each chapter's introduction already summarizes its notions, so summary is for a user who asks for it): EdBuild AI then also writes the notion's video storyboard and podcast script, rendered in a later step. The video lasts 3 minutes unless the user asks for another length. Each chapter also gets its introduction (its PDF and a summary of its notions), as in the EdBuild app. Each notion becomes a background job (billed in credits), and at most 3 run at once per account: every notion goes in one call, the ones beyond the cap come back in not_started (too_many_jobs) to start again as jobs end. edbuild_formation_get shows which requested types a notion already has; the user decides beforehand whether they are overwritten. Without that agreement the notion is refused, unless replace is true, which redoes only those types (needs the "Full access" access level); its other activities, and imported videos and audio, are kept. The started job_ids are followed with edbuild_job_status.

edbuild_generate_activities

The first step to build a formation from a document: a file attached to the chat does not reach EdBuild, one dropped in the drop zone shown with the result does. Its curl command is for a coding agent with a shell on the user's own computer; a chat app's sandbox does not hold the user's files. It takes only the kind asked for, once, even when the upload fails, and expires after 15 minutes: a retry takes a new one. Up to 25 MB (PDF) or 10 MB (image) from the drop zone, 4.5 MB with curl.

edbuild_upload_link

Get the links that open one formation in EdBuild: url, its learner view once it is published and its editor otherwise (view tells which), and editor_url, its editor. With activity_id (a video or podcast to render, an activity to show), the editor opens on that activity. The user needs one once the activities are generated, and whenever they want to see, edit or publish a formation. These links are valid only as this tool returns them.

edbuild_formation_link

List the avatars (who appears in a video) and the voices (who speaks) this account can use, to pick the ones edbuild_video_build renders a video with. Filter by language and gender: the ones whose language or gender is unknown, like a custom voice, are listed whatever the filter. kind: podcast lists the podcast voices for edbuild_podcast_create instead.

edbuild_video_options

Publish a formation to its learners (published: true, in the format the user picks), or take it back to draft (published: false). Only a published formation reaches learners; edbuild_formation_link then gives its learner link.

edbuild_formation_publish

Read one formation: its settings (context, publishing format, pin, images) and outline (chapters, notions and their activities, with ids and titles), plus the content of the notions in notion_ids (source text, objectives and every activity in full) and of the activities in activity_ids. A video comes as its storyboard (slides, avatar, voice) and render state. A notion can weigh thousands of tokens: notion_ids and activity_ids name only what is being reviewed or edited. Ids that are not in this formation come back in ids_not_found.

edbuild_formation_get

Render a video activity from its storyboard, with the avatar and voice it has or the ones given (from edbuild_video_options): the new video replaces the current one. Answers at once with the job_id: the render takes several minutes, follow it with edbuild_job_status. Each call is a new render billed on its own, even while another render of the same video runs.

edbuild_video_build

List the formations (training courses) this account can access, newest first, optionally only those whose title contains query (case-insensitive). Returns ids and titles; pass next_cursor back as cursor to get the next page. It finds a formation id for edbuild_formation_get or edbuild_formation_edit, and tells whether a formation already exists before one is created.

edbuild_formation_search

Synthesize the audio of a podcast whose script EdBuild AI wrote (with the notion's activities, or with edbuild_podcast_create) (billed in credits). Without transcript, the script is synthesized as written; with it, the user's edited script replaces it. Runs in the background: follow its job_id with edbuild_job_status. A failed synthesis can be started again.

edbuild_podcast_render

Have EdBuild AI write a podcast script, as an audio activity: from a notion's source text (notion_id), or a recap of a whole chapter in its introduction (chapter_id). A notion's podcast is drafted with its activities (edbuild_generate_activities): this tool is for a chapter recap or to redo one. The speakers' voices come from edbuild_video_options (kind: podcast). Runs in the background: its job_id is followed with edbuild_job_status. The user reviews the script before the podcast is rendered with edbuild_podcast_render. A notion has one AI-made podcast: when edbuild_formation_get shows one already, the user decides beforehand whether it is overwritten; replace: true replaces it once the new script is written, imported audio is kept (needs the "Full access" access level).

edbuild_podcast_create

Have EdBuild AI write a video, slides and narration, as a video activity: from a notion's source text (notion_id), or a recap of a whole chapter in its introduction (chapter_id). A notion's video is drafted with its activities (edbuild_generate_activities): this tool is for a chapter recap or to redo one. Runs in the background: its job_id is followed with edbuild_job_status. The user reviews the storyboard before the video is rendered with edbuild_video_build. A notion has one AI-made video: when edbuild_formation_get shows one already, the user decides beforehand whether it is overwritten; replace: true replaces it once the new one is ready, imported videos are kept (needs the "Full access" access level).

edbuild_notion_video