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.
`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.