L'Assistant API fournit un ensemble d'outils de développement facilitant la gestion des messages de conversation et l'appel d'outils. Cette rubrique prend pour exemple la création d'un assistant de dessin à partir de zéro afin de vous familiariser rapidement avec les méthodes de codage de base de l'Assistant API.
Processus type
Voici le processus typique pour construire une application d'agent (Assistant) :
- Créer un Assistant : lors de la création, sélectionnez un modèle, fournissez des instructions et ajoutez des outils, tels qu'un interpréteur de code et l'appel de fonctions.
- Créer un Thread : lorsqu'un utilisateur initie une conversation, créez un thread de session pour suivre l'historique des échanges.
- Envoyer un message au Thread : ajoutez le message de l'utilisateur à la conversation.
- Démarrer un Run : exécutez l'assistant sur le thread de session. L'assistant analyse le message, appelle les outils ou services appropriés, génère une réponse et vous la retourne.
Scénario d'exemple
Les modèles de génération de texte ne peuvent pas produire d'images par eux-mêmes. Un modèle spécifique de conversion texte-image est généralement nécessaire pour transformer du texte en images. Une application d'agent créée avec l'Assistant API peut optimiser automatiquement les termes descriptifs fournis par l'utilisateur, appeler un outil texte-image pour générer des images de haute qualité. Par exemple, pour obtenir une image réaliste d'un chat domestique, il suffit de fournir une description sommaire. L'assistant de dessin affine alors automatiquement le prompt et le transmet directement à l'outil texte-image pour réaliser efficacement la tâche de création visuelle.
Procédure
Les étapes suivantes détaillent la procédure en Python pour le mode de sortie non streaming. Pour consulter le code complet des SDK Python et Java couvrant les modes streaming et non-streaming, reportez-vous à la section Code complet à la fin de cette rubrique.

Étape 1 : Préparer l'environnement de développement
| |
Étape 2 : Créer un AssistantAprès avoir importé le SDK Dashscope, utilisez la méthode create de la classe Assistant pour créer un agent Assistant. Ce processus implique la définition des paramètres clés suivants :
| |
Étape 3 : Créer un ThreadUn Thread est un concept fondamental de l'Assistant API représentant un contexte de conversation continu.Le Thread permet de créer un fil de gestion de session lorsqu'un utilisateur entame une nouvelle conversation. L'Assistant exploite ce Thread pour appréhender l'ensemble du contexte et fournir des réponses plus cohérentes et pertinentes.Nous vous recommandons les pratiques suivantes :
| |
Étape 4 : Ajouter un message à un ThreadVotre saisie est transmise via un objet Message. L'Assistant API prend en charge l'envoi d'un ou plusieurs messages à un même Thread. Lors de la création d'un Message, tenez compte des paramètres suivants :
Une fois la méthode Messages.create() exécutée, elle ajoute automatiquement le message au thread et déclenche sa mise en file d'attente. Cela équivaut à effectuer simultanément les opérations de création et d'envoi du message, ce qui constitue le comportement par défaut de l'API. | |
Étape 5 : Créer et exécuter un RunUne fois qu'un utilisateur a attribué un message à un Thread spécifique, vous pouvez démarrer un Run pour activer l'Assistant préconfiguré. L'assistant utilise tous les messages du thread comme contexte, exploite le modèle spécifié et les plugins disponibles pour répondre intelligemment aux questions de l'utilisateur, puis insère les réponses générées dans la séquence de messages du thread.Dans ce scénario, effectuez les étapes suivantes :
De nombreux utilisateurs pouvant solliciter le modèle simultanément, le temps de traitement peut s'en trouver allongé. Nous vous recommandons de patienter jusqu'à ce que le statut affiche « complete » avant d'effectuer l'opération suivante, afin d'assurer un déroulement fluide. |
Code complet
- Non-streaming output
- Streaming output
python