# Guide : Hermes

[Hermes Agent](https://hermes-agent.nousresearch.com) (Nous Research) se branche au téléphone par MCP, avec une clé
API. Ton agent pourra passer des appels depuis le terminal ou depuis ta messagerie (Telegram, Slack…).

## Avant de commencer

1. Crée ton compte sur `/app/`, vérifie ton numéro de mobile par SMS (5 minutes offertes), puis crée une clé API
   (`tel_…`) dans **Clés API**.
2. Range la clé dans `~/.hermes/.env` (jamais dans `config.yaml` ni dans une conversation) :

```bash
echo 'DIALYNE_API_KEY=tel_…' >> ~/.hermes/.env
```

## Configuration

Ajoute le serveur dans `~/.hermes/config.yaml`, sous `mcp_servers` :

```yaml
mcp_servers:
  dialyne:
    url: "https://mcp.dialyne.com/mcp"
    headers:
      Authorization: "Bearer ${DIALYNE_API_KEY}"
    timeout: 120
```

Hermes remplace `${DIALYNE_API_KEY}` par la valeur de `~/.hermes/.env` au moment de la connexion.

Puis, dans une session : `/reload-mcp` (ou redémarre Hermes). Vérifie la connexion avec `hermes mcp test dialyne`.
Les outils apparaissent sous le préfixe `mcp_dialyne_` (`mcp_dialyne_place_phone_call`, `mcp_dialyne_get_call`…).
Une passerelle de messagerie (`hermes gateway`) recharge `config.yaml` toute seule en une minute environ.

## Ton premier appel

Depuis Telegram ou le terminal :

> Appelle le 05 61 00 00 00 et demande au cabinet s'il reste un créneau jeudi après-midi pour Moha K. Ne prends rien
> avant 14 h. Suis l'appel jusqu'au bout et donne-moi le résultat.

Hermes lance l'appel, le suit avec `get_call` et te rend le résultat.

## Bons réflexes

- **Les questions par messagerie prennent du temps** : quand l'agent vocal pose une question que seul toi connais,
  Hermes doit te l'envoyer et attendre ta réponse. Demande-lui (dans tes instructions permanentes) d'appeler
  `hold_call_question` **avant** de te poser la question : l'interlocuteur patientera une minute s'il l'accepte. Sinon,
  laisse le rappel se faire : ta réponse sera dite au début du rappel. Voir [Questions en direct](questions.md).
- **Mets tout dans la mission** (nom, téléphone de rappel, créneaux acceptables) : moins de questions, appels plus
  courts.
- Pour suivre beaucoup d'appels sans tenir une session ouverte, utilise plutôt les [webhooks](webhooks.md) vers ton
  propre serveur.