Rapport

Générez des rapports d'analyse vidéo horodatés en interrogeant l'agent VSS pour une description de la vidéo via POST …/generate. L'agent exécute video_understanding (et outils connexes) en interne. Prenez le texte de style sous-titre de l'agent avec horodatages et collez-le dans le modèle Rapport d'Analyse Vidéo ci-dessous.

Quand l'utiliser

• « Générez un rapport pour cette vidéo » / « pour <sensor-id> »
• « Créez un rapport d'analyse »
• « Rapportez ce qui se passe dans la vidéo téléchargée »
• « Donnez-moi un rapport »

Prérequis de déploiement

Cette compétence nécessite le profil base de VSS s'exécutant sur l'hôte à $HOST_IP. Avant toute demande :

1. Testez l'agent VSS :

   curl -sf --max-time 5 "http://${HOST_IP}:8000/docs" >/dev/null

2. Si le test échoue, demandez à l'utilisateur :

   « Le profil base de VSS ne s'exécute pas sur $HOST_IP. Puis-je le déployer maintenant en utilisant la compétence /deploy avec -p base ? »

   • Si oui → passez à la compétence /deploy. Revenez ici une fois réussi.
   • Si non → arrêtez. N'exécutez pas cette compétence sans la pile manquante.

   (Si votre appelant a accordé une pré-autorisation explicite pour déployer de manière autonome — par exemple la demande mentionne « pré-autorisé à déployer les prérequis », ou vous exécutez dans un harnais d'évaluation non interactif avec cette permission — ignorez la confirmation et invoquez /deploy directement.)

3. Si le test réussit, continuez.

Flux de l'agent

Exécutez ces étapes dans l'ordre :

1. Capteur / clip — Confirmez le sensor id ou la vidéo que l'utilisateur demande. Si c'est flou, demandez avant de continuer. Si le capteur ou la vidéo ne sont pas mentionnés directement dans la demande de l'utilisateur, l'utilisateur peut faire référence à une vidéo mentionnée précédemment.

2. Déploiement de l'agent VSS — Résolvez l'URL HTTP de base de l'agent. Lisez VSS_AGENT_PORT, EXTERNAL_IP / HOST_IP, ou consultez la documentation de composition / déploiement de la machine où s'exécute la pile. Motif typique : http://<host>:<port> avec le port issu de l'env (souvent 8000 pour l'API agent).

3. Interrogez l'agent — POST ${VSS_AGENT_BASE_URL}/generate avec JSON {"input_message": "<prompt>"}. Demandez un résumé sous-titré avec horodatages (segments chronologiques, secondes depuis le début du clip), par ex. décrivez les scènes et événements avec les plages horaires. Le nom du capteur / fichier doit être inclus dans le message d'entrée à l'agent.

   • NE MENTIONNEZ PAS de rapport à l'agent vss

4. Modèle de rapport — Copiez le texte final de l'agent (sous-titre/résumé horodaté) dans Résultats de l'analyse et remplissez Informations de base ; retournez ce markdown à l'utilisateur.

Interroger l'agent VSS (/generate)

# Défini depuis le déploiement (compose / .env / hôte où vss-agent écoute)
export VSS_AGENT_BASE_URL="http://localhost:8000"

curl -s -X POST "${VSS_AGENT_BASE_URL}/generate" \
  -H "Content-Type: application/json" \
  -d '{"input_message": "Describe in detail what happens in the video for sensor <sensor-id>, with timestamps (start–end in seconds from clip start) for each segment or event."}' | jq .

Modèle de Rapport d'Analyse Vidéo

Collez le résumé horodaté de l'agent sous Résultats de l'analyse. Remplissez les champs du tableau (horodatages, source, demande).

# Rapport d'Analyse Vidéo

## Informations de base

| Champ | Valeur |
|-------|--------|
| **Identifiant du Rapport** | vss_report_<YYYYMMDD_HHMMSS> |
| **Date d'analyse** | <YYYY-MM-DD> |
| **Heure d'analyse** | <HH:MM:SS> |
| **Agent IA signaleur** | <par ex. votre label> |
| **Source vidéo** | <sensor_id ou nom de fichier> |
| **Demande d'analyse** | <description de votre demande à vous> |

## Résultats de l'analyse

<sortie de l'agent : sous-titre / résumé horodaté>

Références croisées

• vios — Capteurs VST, stockage et URLs de clips si vous devez télécharger une vidéo ou vérifier l'existence de la vidéo avant d'appeler l'agent.
• video-understanding pour les questions de suivi auxquelles on ne peut pas répondre directement par le rapport généré ou l'historique de conversation.
• video-summarization / incident-report — autres motifs /generate ; cette compétence se concentre sur sous-titres horodatés → modèle de rapport.