Création d'un routeur de discussion alimenté par l'IA à l'aide de la plate-forme d'agent d'IA Oracle Cloud Infrastructure

Introduction

Ce tutoriel explique comment créer un agent d'IA Oracle Cloud Infrastructure (OCI) qui acheminera l'entrée utilisateur en fonction de son contexte vers les LLM hébergés dans le service OCI Generative AI à l'aide du kit de développement d'agent Oracle Cloud Infrastructure (OCI ADK). Vous apprendrez à packager la logique de service OCI en tant qu'outils, à créer un agent d'IA qui interprète le langage naturel et à obtenir efficacement des réponses en fonction du contexte. Cela tire le meilleur parti des LLM hébergés dans OCI à l'aide d'agents d'IA.

Dans le cadre de ce tutoriel, nous n'utiliserons que deux LLM dans le back-end. Si l'entrée de l'utilisateur est basée sur la génération de contenu ou la synthèse de texte, cette entrée est envoyée à Llama 3.3 70B. Si l'entrée de l'utilisateur concerne le codage ou les mathématiques, elle est envoyée à Llama 4 Maverick hébergé sur les services OCI Generative AI.

Remarque :

Objectifs

Prérequis

Tâche 1 : création d'un agent OCI AI à partir de la console OCI

La plate-forme d'agent d'IA Oracle Cloud Infrastructure (plate-forme d'agent d'IA OCI) vous permet de créer des assistants intelligents qui interprètent les questions des utilisateurs, planifient les actions et appellent des outils personnalisés ou intégrés (compétences) par rapport aux API OCI. Chaque outil est packagé en tant que classe Python avec des méthodes spécifiques, ce qui confirme le système d'inscription des outils d'OCI ADK.

  1. Connectez-vous à la console OCI, accédez à Agents d'IA générative et cliquez sur Créer un agent.

    image

  2. Dans la section Informations de base, entrez un nom et le message de bienvenue. Dans le cadre de ce tutoriel, l'instruction de routage reste vide. Fournissez les informations relatives au jeu de transport, puis cliquez sur Suivant.

    image

  3. Dans la section Ajouter un outil, ne créez aucun outil. Nous allons utiliser OCI ADK pour le créer.

  4. Dans la section Adresse de l'agent de configuration, sélectionnez Guardrails.

    image

  5. Cliquez sur Créer un agent.

Concepts clés :

Remarque : un agent peut acheminer les demandes utilisateur sur plusieurs boîtes à outils (par exemple, Oracle Cloud Guard, compartiments) et composer des opérations en plusieurs étapes si nécessaire.

Tâche 2 : configuration locale de l'ADK OCI

Vous allez écrire des classes Python définissant des outils pour exposer les opérations Oracle Cloud Guard. Chaque fonction est annotée avec @tool et peut être appelée en langage naturel par l'agent.

Mettre à jour l'authentification dans le fichier d'agent

image

Tâche 3 : Exécuter l'agent AI

  1. Téléchargez le fichier suivant et enregistrez-le dans le même répertoire.

  2. Mettez à jour l'entrée dans le fichier oci_ai_route.py selon vos besoins.

    image

  3. Exécutez le fichier oci_ai_route.py en utilisant la commande suivante.

    uv run oci_ai_route.py 
    
  4. En fonction du contexte, le modèle requis est appelé et le contenu est généré.

    image

Remarque : vous pouvez utiliser agent.run() à partir du fichier oci_ai_route.py ajouté à l'application Web ou à l'application pour appeler cet agent.

Accusés de réception

Ressources de formation supplémentaires

Explorez d'autres ateliers sur le site docs.oracle.com/learn ou accédez à d'autres contenus d'apprentissage gratuits sur le canal Oracle Learning YouTube. En outre, visitez le site education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.

Pour obtenir de la documentation sur le produit, consultez Oracle Help Center.