Agents IA et outils

Les agents et outils sont définis dans le fichier .ironflock/ai-template.yml dans le dépôt de votre application.

Structure d’un agent

Chaque clé de premier niveau définit un agent :


my_agent:
    tool_description: |
        Quand déléguer à cet agent et quel contexte fournir.
        Ces instructions sont pour l'IA IronFlock, pas pour votre agent.
 
    system_prompt: |
        Définissez le rôle, l'expertise et les garde-fous de votre agent.
 
    main: true
    max_context_tokens: 50000
    messages_after_summary: 6
    max_iterations: 10
    tools:
        my_tool:
            description: Ce que fait cet outil et quand l'appeler.
            topic: my_app.my_wamp_topic
            parameters:
                my_param:
                    type: string
                    description: Ce que ce paramètre contrôle.
                    required: true

Champs d’un agent

Champ	Description
`tool_description`	Instructions pour l’IA IronFlock sur quand déléguer à cet agent.
`system_prompt`	Définit le rôle, l’expertise, les outils disponibles et le format de sortie attendu.
`main`	`true` = visible pour l’IA IronFlock. `false` = sous-agent, accessible uniquement via délégation.
`data_access`	Facultatif. `true` donne à cet agent un accès SQL en lecture seule aux tables de données de votre propre application, via les outils intégrés `get_schema` et `execute_sql`. Jamais aux données d’une autre application.
`file_access`	Facultatif. `true` donne à cet agent un accès en lecture seule aux fichiers stockés de votre propre application, via les outils intégrés `list_app_files` et `read_app_file`. La recherche porte sur les chemins, pas sur le contenu, et les PDF et autres formats binaires ne peuvent pas être lus.
`log_access`	Facultatif. `true` donne à cet agent un accès en lecture seule aux journaux des conteneurs de votre propre application, via l’outil intégré `get_app_logs`. Jamais les journaux d’une autre application, et uniquement sur les appareils que l’utilisateur peut déjà voir.
`web_search`	Facultatif. `true` donne à cet agent l’outil intégré `web_search`, qui effectue une recherche sur Internet et renvoie une réponse synthétisée avec les liens des sources — pour des fiches techniques, des codes d’erreur ou tout ce que les données de votre application ne peuvent pas expliquer. La requête est envoyée à un fournisseur de recherche externe : précisez donc dans le `system_prompt` ce que l’agent peut rechercher.
`max_context_tokens`	Limite de tokens par requête.
`max_iterations`	Nombre maximal de tours d’appel d’outils avant l’arrêt de l’agent.

Sous-agents et délégation

Pour les domaines complexes, divisez votre intégration IA en plusieurs agents spécialisés.

Propriété	Agent principal (`main: true`)	Sous-agent (`main: false`)
Visibilité	Enregistré avec l’IA IronFlock	Masqué de l’IA IronFlock
Accès	Invoqué directement	Uniquement accessible via délégation
Cas d’usage	Point d’entrée pour l’IA de votre application	Expertise de domaine spécialisée

Bonnes pratiques

Rédiger les descriptions d’outils

Le champ tool_description est pour l’IA IronFlock — il détermine quand votre agent est invoqué. Rédigez-le du point de vue de l’IA IronFlock.

Conception des outils WAMP

Retournez des données lisibles — L’agent IA interprétera les valeurs de retour de votre outil.
Incluez des messages d’erreur — En cas d’échec d’un outil, retournez un message d’erreur descriptif.
Gardez les paramètres simples — Utilisez des types primitifs quand c’est possible.