Documentation Oracle Cloud Infrastructure

Configuration d'exécution pour les équipes d'agent

La configuration d'exécution vous permet de fournir des valeurs lors de l'exécution sans modifier les définitions stockées des équipes, des agents, des tâches ou des outils. La configuration d'exécution utilise des paires clé-valeur pour fournir des valeurs à une équipe lors de l'exécution. Une clé identifie une variable d'exécution et sa valeur associée fournit la valeur de cette variable. Un espace réservé est une référence à une clé variable d'exécution dans une définition d'équipe, d'agent, de tâche ou d'outil stockée. Par exemple, l'espace réservé {audience} référence la clé de variable d'exécution audience. Les espaces de noms prennent en charge différents types de valeurs d'exécution et peuvent être utilisés avec les équipes et leurs outils. Pour les équipes en général, y compris les équipes partagées, vous pouvez fournir des valeurs d'exécution via SET_TEAM ou RUN_TEAM. Pour les équipes partagées, ces valeurs peuvent être fournies sans modifier la définition de l'équipe partagée.

La configuration d'exécution prend en charge les espaces de noms suivants :

Espace de noms Objet
instruction_variables Fournissez des valeurs qui remplacent les espaces réservés dans les rôles d'agent et les instructions de tâche.
attribute_variables Fournissez des valeurs d'exécution pour les attributs d'agent ou d'outil configurables, tels que profile_name ou tool_params.
state_variables Stocker l'état d'exécution et échanger des valeurs entre les outils au cours d'une exécution.

La configuration d'exécution prend en charge les valeurs de portée session et d'exécution. Les valeurs de niveau session restent disponibles pour les exécutions suivantes dans la même session de base de données. Les valeurs d'exécution s'appliquent uniquement à l'exécution en cours.

Comportement de configuration d'exécution supplémentaire pour les équipes et les équipes partagées :

  • Utilisez SET_TEAM pour définir la configuration d'équipe et d'exécution pour la session de base de données en cours. Ces valeurs restent disponibles pour les exécutions d'équipe suivantes dans cette session jusqu'à ce que vous les modifiiez ou les effaciez. Lorsque vous utilisez SET_TEAM avec SELECT AI AGENT <prompt>, chaque invite exécute l'équipe définie pour la session en cours. Vous pouvez soumettre plusieurs invites à l'aide de SELECT AI AGENT <prompt> après un seul appel SET_TEAM. Les invites continuent d'utiliser les valeurs d'équipe et de session sélectionnées jusqu'à ce que vous appeliez à nouveau SET_TEAM, que vous effaciez la configuration ou que vous mettiez fin ou réinitialisiez la session de base de données.
  • Utilisez RUN_TEAM pour fournir des valeurs pour une exécution d'équipe spécifique. Les valeurs fournies via RUN_TEAM s'appliquent uniquement à cette exécution et remplacent les valeurs de niveau session correspondantes fournies via SET_TEAM. Les remplacements ne modifient pas la configuration de niveau session définie par SET_TEAM.
  • La fourniture de valeurs via SET_TEAM ne nécessite pas que toutes les exécutions suivantes utilisent la même conversation. La continuité de conversation est déterminée par les informations de conversation associées à l'exécution. Les invites qui utilisent la même valeur conversation_id appartiennent au même thread de conversation. Une nouvelle conversation démarre lorsque vous fournissez une nouvelle adresse conversation_id.
  • Utilisez une clé d'exécution uniquement lorsque la définition d'équipe, d'agent, de tâche ou d'outil correspondante contient un espace réservé correspondant.
  • Un consommateur peut fournir une paire clé-valeur dans un espace de noms de variable d'exécution pris en charge. La valeur fournie affecte uniquement un espace réservé correspondant dans la définition d'équipe, d'agent, de tâche ou d'outil stockée. S'il n'existe aucun espace réservé correspondant, la valeur fournie n'a aucun effet.
  • Le propriétaire de l'équipe contrôle les parties de la définition stockée que les consommateurs peuvent configurer en définissant les espaces réservés disponibles pour les variables d'exécution. La substitution avec des variables d'exécution n'accorde pas de privilèges supplémentaires. Les opérations effectuées par l'équipe restent soumises aux exigences d'autorisation et à la sémantique d'exécution applicables.
  • Le consommateur qui démarre ou sélectionne une conversation possède cette conversation. Seul ce destinataire peut reprendre un processus WAITING_FOR_HUMAN et uniquement tant que le destinataire a toujours accès à l'équipe partagée.
  • Les valeurs écrites par SET_VARIABLE sont disponibles pour les outils ultérieurs de la même exécution d'équipe. Ces outils peuvent extraire les valeurs à l'aide de GET_VARIABLE.
  • Si une exécution d'équipe est interrompue pour les entrées humaines, les valeurs écrites par SET_VARIABLE sont enregistrées et restaurées lorsque le même consommateur reprend l'exécution.
  • Les valeurs d'exécution ne modifient pas les définitions d'équipe, d'agent, de tâche ou d'outil stockées.

Pour plus d'informations, voir FonctionGET_VARIABLE, Procédure SET_VARIABLE, Fonction SET_TEAM, Fonction RUN_TEAM.