> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreweave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fonctions distantes

> Exécutez des fonctions Python dans des bacs à sable avec sérialisation automatique.

Ces exemples utilisent un jeton d’accès à l’API CoreWeave défini dans `CWSANDBOX_API_KEY`. Pour l’authentification par clé API Forge, consultez [Premiers pas](/fr/products/sandboxes/get-started). Pour les exigences relatives à CKS, consultez [Modes de placement](/fr/products/sandboxes/placement).

Ce tutoriel explique comment exécuter des fonctions Python dans une sandbox à l’aide de fonctions distantes. Au lieu de construire des chaînes de commandes shell, vous pouvez appeler le code exécuté dans la sandbox comme s’il s’agissait d’une fonction locale. Il s’adresse aux développeurs qui souhaitent solliciter des ressources de calcul dans une sandbox directement depuis leur code Python et récupérer des résultats typés.

<h2 id="define-and-call-a-remote-function">
  Définir et appeler une fonction distante
</h2>

Décorez une fonction avec `@session.function()` pour l’appeler dans la sandbox avec `.remote()`. L’appel renvoie une référence, que vous résolvez ensuite avec `.result()` :

```python theme={"system"}
from cwsandbox import Sandbox, SandboxDefaults

with Sandbox.session(SandboxDefaults()) as session:
    @session.function()
    def add(x: int, y: int) -> int:
        return x + y

    result = add.remote(2, 3).result()  # 5
```

<h2 id="run-functions-in-parallel-with-map">
  Exécuter des fonctions en parallèle avec `.map()`
</h2>

Utilisez `.map()` pour lancer de nombreux appels à la fois et récupérer leurs résultats. Les appels indépendants s’exécutent simultanément plutôt que les uns après les autres :

```python theme={"system"}
@session.function()
def square(x: int) -> int:
    return x * x

refs = square.map([(1,), (2,), (3,)])
results = [r.result() for r in refs]  # [1, 4, 9]
```

<h2 id="next-steps">
  Étapes suivantes
</h2>

Vous pouvez désormais appeler des fonctions Python dans une sandbox comme s’il s’agissait d’appels locaux, et paralléliser le travail avec `.map()`.

Pour en savoir plus sur les modes de sérialisation, les tests avec `.local()` et d’autres sujets, consultez le [guide des fonctions distantes](/fr/products/sandboxes/client/guides/remote-functions).