Troubleshooting

Frequently Asked Questions

Does the Agent Produce the Actual Video File?

Yes, step by step. It writes the script and storyboard, makes a still for each shot, renders each still into a short clip, and joins the clips into one video you can download, with an optional generated voice-over. Each step is something you start.

Does Approving Render or Publish the Video?

No. Approve marks the project approved and, when Brand checking is on, runs the script through the check. Rendering, assembly, and publishing are separate actions.

What Does Publish Do?

It records the public link you paste in and moves the project to Recently Published. It does not upload the video to any platform. You upload the file to YouTube, Vimeo, or your own site first.

I Regenerated the Storyboard and My Shots Are Gone

Regenerating the storyboard replaces every shot, so the old stills and clips are discarded. The app and the Slack card ask you to confirm first and say how many shots, stills, and clips will be discarded. Generate the images and render the clips again.

I Edited the Script and the Storyboard Says Outdated

Editing the script, in the app or from the Slack card, keeps your shots, stills, and clips as they are and marks the storyboard Outdated, because the shots were planned from the earlier script. Nothing is rebuilt until you choose Regenerate Storyboard and confirm. If the planner cannot produce a new storyboard, your existing shots are kept and you can try again.

Is the Finished Video Checked Against the Brand?

The check, when it is on, reads the script only: the hook, voice-over, and call to action. It does not review the images or the assembled video. It runs when you approve, and only when Brand checking is Warn or Enforce. Brand checking is set in the Operator Console, and Warn is the shipped default. See Brand Compliance.

How Is the Script Paced?

The writer aims for 2.5 to 3 spoken words per second, with a voice-over body of about 25 to 80 words, plus the hook and the call to action. It tends to write a little over rather than under, because trimming is easier than lengthening.

How Many Shots Can There Be?

At most six, and each is 5 or 10 seconds. A short target length gives fewer shots.

What Aspect Ratios Are Supported?

Vertical (9:16), square (1:1), and horizontal (16:9), chosen when you create the project. Shot images are made to match.

Can I Make a Video Without a Voice-Over?

Yes. Skip Generate Voice-Over and assemble. The result is a silent cut.

Common Issues

The Script Tone Does Not Match the Brand

What to check:

1. Confirm the right brand was chosen in New Video.
2. Edit the hook, voice-over, or call to action directly, or choose Regenerate Script.
3. If it is wrong again and again for one brand, ask an administrator to review the brand's voice setup.

I Cannot Approve the Project on the Project Page

What to check:

1. Step 4 and its Submit For Review button only appear when Brand checking is Warn or Enforce.
2. With Brand checking Off, approve from the Video page, where every project in production has an Approve button, or from the Slack card or the Work Queue.
3. Approving needs a written script.

Publish Is Disabled or Fails

What to check:

1. Publish needs an approved project. Approve it first.
2. Paste a public link. Without one, the publish fails and the project is marked publish failed.
3. After fixing either, choose Publish again.

A Shot Failed to Render

What to check:

1. Find the failed shot on the project page. The other shots are not affected.
2. Choose Render Video on that shot again.
3. If it keeps failing, simplify its motion direction (avoid asks where one thing turns into another) or its image brief, then retry.
4. If it still fails, contact support@agenteous.com.

Assemble Video Is Disabled

Assembling needs every shot to have rendered. Check each shot for Video Done. Generate Voice-Over is also disabled until every shot has rendered.

There Is No Slack Card

What to check:

1. Open the Video page. Every project is listed there.
2. Open your Work Queue for projects waiting on approval.
3. A card is only posted when Slack is set up for the agent and the script was written successfully.