OpenAI: acción Ejecutar asistente
- Última actualización2024/10/31
OpenAI: acción Ejecutar asistente
El OpenAI: La acción Ejecutar asistente utiliza Assistant API (v2) 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 Assistant API (v2) admite tres tipos de herramientas: Intérprete de código, búsqueda de archivos 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 OpenAI: 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 OpenAI: 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 OpenAI: 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: \n\n\\[0, 1, 1, 2, 3, 5, 8, 13\\]",
"annotations": []
}
}
]
},
{
"role": "assistant",
"content": [
{
"type": "text",
"text": {
"value": "The Fibonacci sequence is a series of numbers where each number is the sum of the two preceding ones, starting from 0 and 1. Let's generate the first 8 terms of the Fibonacci sequence.",
"annotations": []
}
}
]
}
],
"status": "completed"
}En el siguiente ejemplo, se muestra cómo utilizar el asistente con la Búsqueda de archivo activada. 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": "Here are the holidays listed in the attached file:\n\n1. New Year's Day\n2. Martin Luther King Jr. Day\n3. Presidents' Day\n4. Memorial Day\n5. Independence Day\n6. Labor Day\n7. Columbus Day\n8. Veterans Day\n9. Thanksgiving Day\n10. Christmas Day\n\nThese holidays were found within the attached document .",
"annotations": []
}
}
]
}
],
"status": "completed"
}- Si desea cargar varios archivos, puede agregar una lista de ID de archivos. Estos ID de archivo son identificadores únicos asignados a los archivos cargados mediante OpenAI. Para obtener más información sobre cómo cargar y recuperar archivos en un asistente, consulte OpenAI Files Operations.
- Los archivos de la Control Room o los archivos de escritorio cargados en OpenAI se pueden encontrar en el almacenamiento de OpenAI.
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_Sizn8HNIKH5NzDYXQ61n05RC",
"tool_calls":[
{
"id":"call_wCWp3g9fdWLszmSvUMqglyW5",
"type":"function",
"function":{
"name":"get_weather",
"arguments":"{\"location\":\"Chicago, IL\"}"
}
}
],
"id":"run_MBq3pioUk9K0NaREPOIY4qFG"
},
"status":"requires_action"
}