OpenAI: acción Ejecutar asistente
- Actualizado: 2024/04/17
OpenAI: acción Ejecutar asistente
El OpenAI: La acción Ejecutar asistente utiliza Assistant API de OpenAI para crear asistentes de IA dentro de sus propias aplicaciones. Un asistente tiene instrucciones y puede aprovechar modelos, herramientas y conocimientos para responder las consultas de los usuarios. Actualmente, el Asistente de API admite tres tipos de herramientas: Intérprete de código, recuperación y llamada de funciones.
Antes de empezar
- Debe tener el Rol de creador de bots para usar la acción Ejecutar asistente de OpenAI en una automatización.
- Asegúrese de tener las credenciales necesarias para enviar una solicitud y haber incluido Acción Autenticar antes de llamar cualquier acción de OpenAI.
- Comprender las limitaciones del asistente: Conocer las capacidades y limitaciones del asistente le ayudará a establecer expectativas realistas.
En este ejemplo se muestra cómo cargar un asistente existente en la acción Ejecutar asistente de OpenAI y obtener la respuesta adecuada. Si desea aprender a crear su propio asistente, consulte OpenAI Create Assistant.
Procedimiento
-
Ingrese o seleccione los siguientes campos:
-
Haga clic en Cargar asistentes y seleccione un asistente existente. Necesita autenticarse (consulte Acción Autenticar) con la clave de API.
- Aparecerá Conectarse a Open AI. Puede ingresar la clave de API a través de una credencial guardada en la pestaña Credencial o seleccionar la pestaña Cadena insegura para pegar directamente la clave de API.
- El ID de asistente del asistente seleccionado se muestra en el campo ID de asistente.
Nota: Comprender las limitaciones de un asistente antes de seleccionarlo es crucial para tener una experiencia de usuario fluida. Imagínese solicitar una reserva de vuelo y descubrir que el asistente no puede acceder a los sistemas de reserva. Si conoce con anticipación las capacidades del asistente, podrá evitar estos escenarios tan frustrantes.
-
Haga clic en Cargar asistentes y seleccione un asistente existente. Necesita autenticarse (consulte Acción Autenticar) con la clave de API.
El siguiente ejemplo demuestra cómo utilizar el asistente con el intérprete de código habilitado para generar los primeros ocho términos de la sucesión de Fibonacci.
La respuesta de la automatización anterior es la siguiente:
{
"metadata":{
},
"data":[
{
"role":"assistant",
"content":[
{
"type":"text",
"text":{
"value":"The first 8 terms of the Fibonacci sequence are: 0, 1, 1, 2, 3, 5, 8, 13.",
"annotations":[
]
}
}
]
}
],
"status":"completed"
}El siguiente ejemplo muestra cómo utilizar el asistente con la recuperación habilitada. En este escenario, el asistente lee el archivo adjunto para generar la respuesta.
La respuesta de la automatización anterior es la siguiente:
{
"metadata":{
},
"data":[
{
"role":"assistant",
"content":[
{
"type":"text",
"text":{
"value":"The holidays listed in the 2024 USA holiday schedule are as follows:\n\n1. New Year\u0027s Day: January 1, Monday\n2. MLK Day: January 15, Monday\n3. President\u0027s Day: February 19, Monday\n4. Memorial Day: May 27, Monday\n5. Juneteenth: June 19, Wednesday\n6. Independence Day: July 4, Thursday\n7. Labor Day: September 2, Monday\n8. Thanksgiving Day: November 28, Thursday\n9. Day after Thanksgiving: November 29, Friday\n10. Christmas Eve: December 24, Tuesday\n11. Christmas Day: December 25, Wednesday\n12. New Year\u0027s Eve: December 31, Tuesday",
"annotations":[
]
}
}
]
}
],
"status":"completed"
}
En el siguiente ejemplo se muestra cómo utilizar el asistente con una función. En este escenario, imagine que quiere que el asistente recupere información meteorológica. Al introducir una función nueva llamada get_weather (junto con una descripción y parámetros), le otorga al asistente esta nueva habilidad.
{
"name": "get_weather",
"description": "Determine weather in my location",
"parameters":
{
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "The city and state e.g. San Francisco, CA"
},
"unit": {
"type": "string",
"enum": [
"c",
"f"
]
}
},
"required": [
"location"
]
}
}La salida JSON que se muestra a continuación destaca el estado del asistente como requires_action. Esto indica que el asistente espera sus indicaciones sobre cómo proceder. Ahora puede aprovechar el OpenAI: acción de la función Ejecutar asistente para indicarle al asistente cómo utilizar la reciente función get_weather y formular una respuesta adecuada según los datos recuperados.
La respuesta de la automatización anterior es la siguiente:
{
"data":{
"thread_id":"thread_Aq8I25CKOFAZ50GkVDH4gZXw",
"tool_calls":[
{
"id":"call_zkehFEVLaXyuEND9kSRgq4O1",
"type":"function",
"function":{
"name":"get_weather",
"arguments":"{\"location\":\"Chicago, IL\"}"
}
}
],
"id":"run_s3jWsc8H2xaGV6E28CevuXsG"
},
"status":"requires_action"
}