Fonctions distantes

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. Pour les exigences relatives à CKS, consultez Modes de 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.

Définir et appeler une fonction distante

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() :

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

Exécuter des fonctions en parallèle avec `.map()`

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 :

@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]

Étapes suivantes

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.

Sandbox

Utiliser les Sandbox

Gérer les bacs à sable

Référence

Définir et appeler une fonction distante

Exécuter des fonctions en parallèle avec `.map()`

Étapes suivantes

​Définir et appeler une fonction distante

​Exécuter des fonctions en parallèle avec .map()

​Étapes suivantes

Définir et appeler une fonction distante

Exécuter des fonctions en parallèle avec `.map()`

Étapes suivantes