Créez un routeur de clavardage alimenté par intelligence artificielle à l'aide de la plate-forme d'agent d'intelligence artificielle d'Oracle Cloud Infrastructure

Présentation

Ce tutoriel explique comment créer un agent du service d'intelligence artificielle pour Oracle Cloud Infrastructure (OCI) qui acheminera l'entrée utilisateur en fonction de son contexte vers les LLM hébergés dans le service d'intelligence artificielle générative pour OCI à l'aide de la trousse SDK d'agent pour Oracle Cloud Infrastructure (OCI ADK). Vous apprendrez à emballer la logique du service OCI sous forme d'outils, à créer un agent d'IA qui interprète le langage naturel et obtient efficacement des réponses en fonction du contexte. Cela permet de tirer 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 système dorsal. Si l'entrée de l'utilisateur est basée sur la génération de contenu ou la récapitulation de texte, cette entrée sera envoyée à Llama 3.3 70B; si l'entrée de l'utilisateur concerne le codage ou les mathématiques, elle sera envoyée à Llama 4 Maverick hébergé dans les services d'intelligence artificielle générative pour OCI.

Note :

La connaissance des opérations OCI de base et du développement Python est utile, mais n'est pas requise.

Assurez-vous que votre compte d'utilisateur et de service OCI est autorisé à accéder aux services d'intelligence artificielle générative et aux points d'extrémité d'agent OCI dans OCI.

Une fois que vous avez configuré votre premier agent d'IA, vous pouvez facilement l'étendre à l'aide de nouveaux outils pour couvrir des services OCI supplémentaires en les définissant et en les enregistrant à l'aide de l'interface de boîte à outils OCI ADK.

Objectifs

Comprendre l'architecture et le flux de travail des agents d'IA OCI et de l'ADK OCI.
Développez des toolkits personnalisés.
Configurez, enregistrez et exécutez un agent d'IA qui répond le mieux en fonction du contexte.
Utilisez l'agent d'IA pour utiliser les services de clavardage OCI Generative AI.
Réutilisez cet apprentissage pour développer des agents similaires avec des services OCI à l'aide d'OCI ADK.

Conditions requises

Installer uv : Installez uv à l'aide de la commande suivante selon votre système d'exploitation.
- macOS/Linux :
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```
- Windows :
```
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
```
Créer un environnement virtuel : Naviguez jusqu'au répertoire de votre projet et créez un environnement virtuel à l'aide de la commande uv.
```
uv venv
```
Activer l'environnement virtuel : Activez l'environnement virtuel.
- macOS/Linux :
```
source .venv/bin/activate
```
- Windows :
```
.venv\Scripts\activate
```
Installer les ensembles requis : Installez les ensembles nécessaires à l'aide de la commande uv.
```
uv pip install oci "oci[adk]" rich pydantic docstring_parser
```
Assurez-vous d'avoir :
- Données d'identification et configurations OCI valides. Pour plus d'informations, voir Configuration du fichier de configuration.
- Les politiques d'Oracle Cloud Infrastructure Identity and Access Management (OCI IAM) permettent d'accéder aux services d'IA générative d'OCI et d'enregistrer et d'utiliser des points d'extrémité d'agent.
- Point d'extrémité d'agent OCI disponible ou possibilité d'en créer un.

Tâche 1 : Créer un agent d'intelligence artificielle pour OCI à partir de la console OCI

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

Connectez-vous à la console OCI, naviguez jusqu'à Agents d'IA générative et cliquez sur Créer un agent.
Dans la section Informations de base, entrez un nom et le message de bienvenue. L'instruction de routage sera laissée vide dans le cadre de ce tutoriel. Cliquez sur Suivant.
Dans la section Ajouter un outil, ne créez aucun outil. Nous utiliserons OCI ADK pour le créer.
Dans la section Configurer le point d'extrémité de l'agent, sélectionnez Guardrails.
Cliquez sur Créer un agent.

concepts clés :

Agent : Interpréteur et orchestrateur alimentés par l'intelligence artificielle.
Outil/trousse d'outils : Classe avec une ou plusieurs opérations exposées à l'agent (@tool).
Point d'extrémité de l'agent : Ressource OCI fournissant l'exécution et la connectivité.
Client agent : Client Python pour la communication agent-point d'extrémité.

Note : Un agent peut acheminer les demandes d'utilisateur entre plusieurs trousses d'outils (par exemple, Oracle Cloud Guard, compartiments) et créer des opérations en plusieurs étapes, selon les besoins.

Tâche 2 : Configurer la clé ADK OCI localement

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 avec le langage naturel par l'agent.

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

Mettez à jour le type d'authentification (auth_type), sélectionnez la configuration profile et la configuration region dans laquelle le point d'extrémité de l'agent d'IA est créé.
Mettez également à jour l'OCID du point d'extrémité (agent_endpoint_id) dans get_config.py.

Tâche 3. Exécuter l'agent d'intelligence artificielle

Téléchargez le fichier suivant et enregistrez-le dans le même répertoire.
Mettez à jour l'entrée dans le fichier oci_ai_route.py selon vos besoins.
Exécutez le fichier oci_ai_route.py à l'aide de la commande suivante.
```
uv run oci_ai_route.py 
```
En fonction du contexte, le modèle requis est appelé et le contenu généré.

Note : Vous pouvez utiliser agent.run() à partir de oci_ai_route.py ajouté à votre application Web ou à votre application pour appeler cet agent.

Remerciements

Auteur - Mukund Murali (architecte en nuage principal)

Ressources d'apprentissage supplémentaires

Explorez d'autres laboratoires sur le site docs.oracle.com/learn ou accédez à plus de contenu d'apprentissage gratuit sur le canal Oracle Learning YouTube. De plus, visitez education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.

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

Informations sur le titre et les droits d'auteur

Build an AI Powered Chat Router Using Oracle Cloud Infrastructure AI Agent Platform

G38671-01