Troubleshooting & Advanced Notes

I’m not seeing as many results as expected / I’m seeing too many results!

The way results are displayed depends on the various parameter settings. Depending on how you need to see the results, adjusting the minimum confidence and marker interval plus whether to allow or disallow repeat matches can drastically change the output. When building out AI workflows, pick some solid short test clips and try reprocessing the results with different combinations of parameters until you’re happy with the output.

My worker action failed!

The failed action should indicate if it’s an Amazon error or something else. If it’s an Amazon error your job results may have expired, or there may be a problem with the input. It’s also worth checking over the parameters you’ve entered in the worker config to make sure they aren’t the cause of the issue. If you see anything around ‘Error 403: Access Denied’ the most likely issue is that the IAM credentials provided do not have the correct permissions for the requested task. Speaking of permissions…

Which permissions do I need on AWS?

The AWS IAM permissions or policies are required for whichever account is used are:

AmazonRekognitionFullAccess

translate:TranslateText

transcribe:StartTranscriptionJob

transcribe:GetTranscriptionJob

For the S3 remote volume configuration, LIST, GET, PUT and DELETE permissions on the applicable bucket should do the trick.

Which CatDV fields are required?

The clip fields created and used by the plugin are:

aws.ai.jobs.data

aws.ai.rekognition.job.status

aws.ai.transcription.job.name

aws.ai.transcription.job.status

aws.ai.transcription.job.s3tempFile

It is easiest to create these fields before running a job, but the plugin will check and create them on the first run if they do not exist. The only field which end users should be concerned with on a day to day basis is the job status field which shows “IN_PROGRESS” or “SUCCEEDED” depending on the state of the job.

I hit some other bug/issue!

Please report any unrecoverable task failures to Square Box Support. Please note that support is available to solve bugs in the software and assist with software installation / upgrades - workflow design consultation would typically constitute chargeable work, available via Square Box Professional Services.