edbuild_activities_write
ChatGPTModify 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_chapter_add
ChatGPTAdd a chapter at the end of a formation, for another PDF: pass the upload_id of edbuild_upload_link once the user has dropped it, and the chapter is titled from its file name. Then edbuild_chapter_analyze_pdf with the same upload_id writes its notions. notions holds only an outline the user dictates: a new chapter's content comes from edbuild_chapter_analyze_pdf.
edbuild_chapter_analyze_pdf
ChatGPTHave EdBuild AI write a chapter's notions (source text and objectives) from a PDF, after the notions it already has. Pass the upload_id of edbuild_upload_link once the user has dropped the PDF, or nothing to analyze the PDF already stored on the chapter in EdBuild. Answers at once with the job_id: the analysis takes a few minutes, follow it with edbuild_job_status.
edbuild_chapter_edit
ChatGPTRename a chapter, rewrite its description, or move it with position. Only the fields given change. chapter_id belongs to formation_id.
edbuild_chapter_intro
ChatGPTPut an Introduction notion first in a chapter: the chapter's PDF to read, and a summary of all its notions written by EdBuild AI (billed in credits). edbuild_generate_activities adds it on its own: this tool rebuilds it (replace) or adds it without generating, once the notions have their source text. The summary needs the "Edit and generate with AI" access level. A chapter has one introduction: replace: true rebuilds it (needs the "Full access" access level). The summary runs in the background: follow its job_id with edbuild_job_status.
edbuild_delete
ChatGPTDelete a formation, chapter, notion or activity. An empty formation or chapter (no chapter, notion or activity) goes at once; one with content, a notion or an activity returns what would go and a confirm_token. There is no trash: the user hears its title and content and is asked once; their yes in the chat is the go-ahead, and a second call with confirm_token deletes it.
edbuild_formation_create
ChatGPTCreate a formation (training course) with one empty chapter, filled by the analysis of one dropped PDF, not from an outline written in the chat. A PDF attached to the chat does not reach EdBuild. One PDF = one chapter, whatever its length. It needs only the dropped PDF and the formation's main language: the PDF analysis writes everything else (the chapter's notions and the formation context), which the user reviews once it is done. Once the PDF is dropped, the user gives in one answer the formation's main language, the conversation's by default (learners take the formation in it), and the language the PDF is written in (edbuild_chapter_analyze_pdf translates it when they differ). Without a title, EdBuild titles it from the file name. Not idempotent: after a network error or a timeout, edbuild_formation_search (title or file name) tells whether it was created before a retry.
edbuild_formation_edit
ChatGPTChange a formation's settings: title, description, target audience, objectives, prerequisites, pin, card image or banner. Only the fields given change. Publishing, chapters and notions have their own tools (edbuild_formation_publish, edbuild_chapter_edit, edbuild_notion_edit).
edbuild_formation_get
ChatGPTRead 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_link
ChatGPTGet 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_publish
ChatGPTPublish 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_search
ChatGPTList 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_generate_activities
ChatGPTGenerate 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_job_status
ChatGPTRead 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_notion_add
ChatGPTAdd a notion at the end of an existing chapter, on the user's request: to split a notion, the second part goes here and the first is shortened with edbuild_notion_edit. A new chapter's content comes from edbuild_chapter_analyze_pdf, from the PDF. A notion's content is the user's own passage, pasted or dictated by them; without it, the notion is added without content. chapter_id belongs to formation_id.
edbuild_notion_edit
ChatGPTChange a notion on the user's request: rename it, rewrite its description, source text (content, from the user's passage) or objectives, or move it within its chapter with position. Only the fields given change; its activities are not regenerated. notion_id belongs to formation_id.
edbuild_notion_video
ChatGPTHave 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_podcast_create
ChatGPTHave 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_render
ChatGPTSynthesize 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_upload_link
ChatGPTThe 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_video_build
ChatGPTRender 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_options
ChatGPTList 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_storyboard_edit
ChatGPTEdit a video activity's storyboard: change slides (title, lines shown, narration; only the fields sent change), remove slides, add slides. Slides are named by their number as edbuild_formation_get lists it (activity_ids), all as before this edit; the answer lists the slides renumbered. The video shows the changes once rendered again.