Aiblueprint Agent Starter

AIBlueprint Agent Starter

Un projet starter pour créer un agent IA capable d'interagir avec le système de fichiers et d'effectuer des actions.

🎯 Qu'est-ce qu'un Agent IA ?

Un agent IA va au-delà d'un simple chatbot. Il combine :

• Compréhension : capacité à analyser et comprendre les demandes
• Action : capacité à interagir avec le système (lire/écrire des fichiers, exécuter des commandes)
• Validation : mécanismes de sécurité pour éviter les actions destructrices

🚀 Installation et Configuration

1. Installer les dépendances

bun install

2. Configurer votre clé API

1. Copiez le fichier de template :

cp .env.template .env

1. Modifiez .env avec votre clé API :

• OpenAI (recommandé pour GPT-5) : https://platform.openai.com/api-keys
• Gemini (option gratuite) : https://aistudio.google.com/app/apikey

3. Lancer l'agent

bun run index.ts

📚 Fonctionnalités

L'agent peut :

• Répondre à des questions simples
• Lire le contenu de fichiers
• Modifier des fichiers avec validation
• Effectuer des corrections automatiques (ex: retours à la ligne)

🔧 Exemples d'utilisation

# Question simple
"Quelle est la capitale de la France ?"

# Lecture de fichier
"Quel est le contenu du fichier package.json ?"

# Modification de fichier
"Corrige les retours à la ligne dans le fichier exemple.txt"

🛡️ Sécurité

• Toutes les modifications de fichiers nécessitent une validation
• Sauvegarde automatique des versions précédentes
• Logs de toutes les actions effectuées
• Sandbox de développement recommandé

📖 Architecture

• index.ts : Point d'entrée et boucle principale de l'agent
• provider.ts : Configuration des providers IA (OpenAI/Gemini)
• .env : Variables d'environnement et clés API

Ce projet fait partie de la formation AIBlueprint sur la création d'agents IA.