Configuración de tiempo de ejecución para equipos de agente

La configuración de tiempo de ejecución permite proporcionar valores en tiempo de ejecución sin cambiar las definiciones almacenadas de equipos, agentes, tareas o herramientas. La configuración de tiempo de ejecución utiliza pares clave-valor para proporcionar valores a un equipo en tiempo de ejecución. Una clave identifica una variable de tiempo de ejecución y su valor asociado proporciona el valor de esa variable. Un marcador de posición es una referencia a una clave de variable de tiempo de ejecución en una definición de equipo, agente, tarea o herramienta almacenada. Por ejemplo, el marcador de posición {audience} hace referencia a la clave de variable de tiempo de ejecución audience. Los espacios de nombres soportan diferentes tipos de valores de tiempo de ejecución y se pueden utilizar con equipos y sus herramientas. Para los equipos en general, incluidos los equipos compartidos, puede proporcionar valores de tiempo de ejecución mediante SET_TEAM o RUN_TEAM. Para los equipos compartidos, estos valores se pueden proporcionar sin modificar la definición de equipo compartido.

La configuración de tiempo de ejecución soporta los siguientes espacios de nombres:

Espacio de nombres Finalidad
instruction_variables Proporcione valores que sustituyan a los marcadores de posición en roles de agente e instrucciones de tarea.
attribute_variables Proporcione valores de tiempo de ejecución para atributos de herramienta o agente configurables, como profile_name o tool_params.
state_variables Almacenar el estado de tiempo de ejecución y los valores de intercambio entre las herramientas durante una ejecución.

La configuración de tiempo de ejecución soporta valores de tiempo de ejecución y de ámbito de sesión. Los valores de ámbito de sesión permanecen disponibles para ejecuciones posteriores en la misma sesión de base de datos. Los valores de tiempo de ejecución solo se aplican a la ejecución actual.

Comportamiento de configuración de tiempo de ejecución adicional para equipos y equipos compartidos:

  • Utilice SET_TEAM para definir la configuración de equipo y tiempo de ejecución para la sesión de base de datos actual. Estos valores permanecen disponibles para las ejecuciones de equipo posteriores en esa sesión hasta que los cambie o borre. Cuando se utiliza SET_TEAM con SELECT AI AGENT <prompt>, cada petición de datos ejecuta el equipo definido para la sesión actual. Puede enviar varias peticiones de datos mediante SELECT AI AGENT <prompt> después de una sola llamada SET_TEAM. Las peticiones de datos siguen utilizando los valores de ámbito de sesión y equipo seleccionados hasta que vuelva a llamar a SET_TEAM, borre la configuración o finalice o restablezca la sesión de la base de datos.
  • Utilice RUN_TEAM para proporcionar valores para una ejecución de equipo específica. Los valores proporcionados mediante RUN_TEAM sólo se aplican a esa ejecución y sustituyen los valores de ámbito de sesión coincidentes proporcionados mediante SET_TEAM. Las sustituciones no cambian la configuración de ámbito de sesión definida por SET_TEAM.
  • El suministro de valores mediante SET_TEAM no requiere que todas las ejecuciones posteriores utilicen la misma conversación. La continuidad de la conversación viene determinada por la información de conversación asociada a la ejecución. Las peticiones que utilizan el mismo conversation_id pertenecen al mismo thread de conversación. Una nueva conversación se inicia cuando se proporciona un nuevo conversation_id.
  • Utilice una clave de tiempo de ejecución solo cuando la definición de equipo, agente, tarea o herramienta correspondiente contenga un marcador de posición coincidente.
  • Un consumidor puede proporcionar un par clave-valor en un espacio de nombres de variable de tiempo de ejecución soportado. El valor proporcionado solo afecta a un marcador de posición coincidente en la definición de equipo, agente, tarea o herramienta almacenada. Si no existe ningún marcador de posición coincidente, el valor proporcionado no tiene ningún efecto.
  • El propietario del equipo controla qué partes de la definición almacenada pueden configurar los consumidores definiendo los marcadores de posición de variables de tiempo de ejecución disponibles. La sustitución de variables de tiempo de ejecución no otorga privilegios adicionales. Las operaciones realizadas por el equipo siguen sujetas a los requisitos de autorización aplicables y a la semántica del tiempo de ejecución.
  • El consumidor que inicia o selecciona una conversación es el propietario de esa conversación. Solo ese consumidor puede reanudar un proceso WAITING_FOR_HUMAN y solo mientras el consumidor aún tenga acceso al equipo compartido.
  • Los valores escritos por SET_VARIABLE están disponibles para herramientas posteriores en la misma ejecución de equipo. Estas herramientas pueden recuperar los valores mediante GET_VARIABLE.
  • Si una ejecución de equipo se detiene para la entrada humana, los valores escritos por SET_VARIABLE se guardan y restauran cuando el mismo consumidor reanuda la ejecución.
  • Los valores de tiempo de ejecución no modifican las definiciones de equipo, agente, tarea o herramienta almacenadas.

Consulte Función GET_VARIABLE, Procedimiento SET_VARIABLE, Función SET_TEAM, Función RUN_TEAM para obtener más información.