Volver a herramientas
DisponibleAgentes·
Assistants API
API de OpenAI para crear agentes persistentes con acceso a herramientas (code interpreter, file search, function calling), hilos de conversación y archivos adjuntos gestionados por OpenAI.
Compatible con
PythonTypeScriptREST API
assistantsagentesthreadsopenaicode-interpreter
Assistants API: agentes con estado gestionado por OpenAI
La Assistants API abstrae la gestión de contexto, herramientas y ejecución de acciones, permitiendo construir asistentes con estado sin implementar la lógica de orquestación desde cero.
Conceptos principales
- Assistant: configuración del agente (modelo, instrucciones, herramientas)
- Thread: hilo de conversación con historial persistente
- Message: mensaje individual dentro de un thread
- Run: ejecución del assistant sobre un thread
Crear un assistant
from openai import OpenAI
client = OpenAI()
assistant = client.beta.assistants.create(
name="Analista de datos",
instructions="Analiza datos y genera visualizaciones con Python.",
model="gpt-4o",
tools=[{"type": "code_interpreter"}, {"type": "file_search"}]
)
Ejecutar una conversación
# Crear thread
thread = client.beta.threads.create()
# Añadir mensaje
client.beta.threads.messages.create(
thread_id=thread.id,
role="user",
content="Analiza el CSV adjunto y dime las tendencias principales"
)
# Ejecutar
run = client.beta.threads.runs.create_and_poll(
thread_id=thread.id,
assistant_id=assistant.id
)
# Obtener respuesta
messages = client.beta.threads.messages.list(thread_id=thread.id)
Herramientas disponibles
| Herramienta | Descripción |
|---|---|
code_interpreter | Ejecuta Python en sandbox, genera gráficos |
file_search | Búsqueda semántica en documentos adjuntos |
function | Function calling personalizado |
Cuándo usar Assistants vs Chat Completions
Usa Assistants cuando necesites persistencia de conversación, gestión de archivos o ejecución de código. Usa Chat Completions para llamadas únicas sin estado.