docs: add AI agents and external tools section to guides

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

GUIDE.md

@@ -7,13 +7,14 @@
 3. [Installation locale](#installation-locale)
 4. [Deploiement Docker](#deploiement-docker)
 5. [Configuration des providers IA](#configuration-des-providers-ia)
-6. [Serveur MCP (Model Context Protocol)](#serveur-mcp)
-7. [Integrations N8N](#integrations-n8n)
-8. [Configuration email (SMTP)](#configuration-email)
-9. [Administration](#administration)
-10. [Reference des variables d'environnement](#reference-des-variables-denvironnement)
-11. [Commandes utiles](#commandes-utiles)
-12. [Resolution des problemes](#resolution-des-problemes)
+6. [Agents IA et Outils externes](#agents-ia-et-outils-externes)
+7. [Serveur MCP (Model Context Protocol)](#serveur-mcp)
+8. [Integrations N8N](#integrations-n8n)
+9. [Configuration email (SMTP)](#configuration-email)
+10. [Administration](#administration)
+11. [Reference des variables d'environnement](#reference-des-variables-denvironnement)
+12. [Commandes utiles](#commandes-utiles)
+13. [Resolution des problemes](#resolution-des-problemes)
 
 ---
 
@@ -338,6 +339,97 @@ Les providers IA peuvent aussi etre configures depuis l'interface :
 
 ---
 
+## Agents IA et Outils externes
+
+Memento inclut un systeme d'agents IA configurables qui peuvent executer des actions automatisees en utilisant des outils externes.
+
+### Types d'agents
+
+| Type | Description | Outils par defaut |
+|------|-------------|-------------------|
+| **Scraper** | Scrape des pages web et cree des notes | `web_scrape`, `note_create` |
+| **Researcher** | Recherche web approfondie + synthese | `web_search`, `web_scrape`, `note_search`, `note_create` |
+| **Monitor** | Surveille un notebook et analyse les notes | `note_search`, `note_read`, `note_create` |
+| **Custom** | Agent libre avec instructions personnalisees | configurable |
+
+### Outils disponibles
+
+| Outil | Externe | Description | Configuration requise |
+|-------|---------|-------------|----------------------|
+| `web_search` | Oui | Recherche web (SearXNG ou Brave) | URL SearXNG ou cle Brave |
+| `web_scrape` | Oui | Scrape une page web en Markdown (Jina Reader) | Cle Jina (optionnel) |
+| `url_fetch` | Non | Recupere du contenu JSON/CSV/texte | Aucune |
+| `note_search` | Non | Recherche par mots-cles dans les notes | Aucune |
+| `note_read` | Non | Lire une note par ID | Aucune |
+| `note_create` | Non | Creer une nouvelle note | Aucune |
+| `memory_search` | Non | Rechercher dans l'historique des executions | Aucune |
+
+### Recherche web - SearXNG (recommande)
+
+SearXNG est un moteur de metarecherche open-source et auto-hberge. C'est le provider par defaut pour la recherche web.
+
+**Installation de SearXNG :**
+
+```bash
+# Via Docker
+docker run -d --name searxng \
+  -p 8080:8080 \
+  -e SEARXNG_BASE_URL=http://localhost:8080 \
+  --restart unless-stopped \
+  searxng/searxng:latest
+```
+
+**Configuration dans Memento :**
+
+1. Aller dans `/admin/settings`
+2. Section "Tools"
+3. Web Search Provider : selectionner `SearXNG (Self-hosted)`
+4. SearXNG URL : `http://localhost:8080` (ou l'URL de votre instance)
+5. Sauvegarder
+
+**En Docker (reseau partage) :**
+
+Si SearXNG et Memento sont dans le meme reseau Docker, utiliser le nom du service :
+```
+http://searxng:8080
+```
+
+### Recherche web - Brave Search (alternative)
+
+Brave Search est une API payante comme alternative a SearXNG.
+
+1. Creer un compte sur [brave.com/search/api](https://brave.com/search/api/)
+2. Obtenir une cle API
+3. Dans `/admin/settings` > Tools : selectionner `Brave Search API` et entrer la cle
+
+Les deux providers peuvent etre utilises en meme temps en selectionnant `Both`.
+
+### Scraping web - Jina Reader (optionnel)
+
+L'outil `web_scrape` utilise [Jina Reader](https://jina.ai/reader/) pour convertir des pages web en Markdown. Fonctionne sans cle API (avec limites de debit), ou avec une cle pour des limites plus elevees.
+
+1. Creer un compte sur [jina.ai](https://jina.ai/)
+2. Obtenir une cle API
+3. Dans `/admin/settings` > Tools : entrer la cle Jina
+
+### Utilisation des agents
+
+1. Aller sur `/agents`
+2. Cliquer sur "Nouvel agent" ou choisir un template
+3. Configurer :
+   - **Nom et description**
+   - **Type** (Scraper, Researcher, Monitor, Custom)
+   - **Instructions** (prompt systeme)
+   - **Outils** (selectionner les outils actifs)
+   - **Frequence** (manuel, hourly, daily, weekly, monthly)
+   - **Notebook cible** (ou sauvegarder les resultats)
+   - **URLs sources** (pour les scrapers)
+4. Sauvegarder et executer
+
+Les agents sont aussi disponibles dans le **Chat IA** : si la recherche web est activee, le chat utilise automatiquement les outils `web_search` et `web_scrape`.
+
+---
+
 ## Serveur MCP
 
 Le serveur MCP (Model Context Protocol, v3.1) permet aux agents IA d'interagir avec vos notes via un protocole standardise.