Conversaciones sin un agente
En esta página
Modo de modelo directo
No siempre necesitas crear un objeto Agente para usar la API de Conversaciones. Mistral te permite iniciar una conversación directamente con un modelo, lo que te ofrece persistencia sin la capa de configuración del Agente. Esta capacidad se deriva directamente de la arquitectura que hemos visto anteriormente: la conversación es independiente del agente, por lo que puede existir perfectamente por sí sola.
Hay varios escenarios en los que esto es preferible a usar un agente registrado. Es posible que quieras persistencia sin definir un agente reutilizable, por ejemplo, porque cada hilo en tu aplicación es único. Quizás estés probando rápidamente el comportamiento con herramientas integradas, y crear y eliminar un agente para cada prueba te ralentice. Tu caso de uso podría ser puntual: nada justifica guardar una configuración que solo usarás una vez. O tus instrucciones podrían ser dinámicas, calculadas en tiempo de ejecución según el perfil del usuario o el documento actual; en ese caso, un agente estático sería la herramienta incorrecta.
Inicio de una conversación con un modelo
En lugar de pasar un agent_id, pasas directamente un model:
from mistralai.client import Mistral
import os
client = Mistral(api_key=os.environ["MISTRAL_API_KEY"])
response = client.beta.conversations.start(
model="mistral-medium-latest",
inputs=[
{"role": "user", "content": "Who is Albert Einstein?"}
]
)
print(response.outputs[-1].content)
Todo depende de esta elección de parámetro. Con agent_id, la llamada hereda la configuración registrada del agente: sus instrucciones, herramientas y barreras de seguridad. Con model, estás en modo directo y configuras todo en la propia solicitud; nada se recuerda más allá de la llamada.
Añadir herramientas en modo directo
Las herramientas integradas no están reservadas para los agentes. Las declaras en la solicitud, exactamente igual que harías durante la creación de un agente.
response = client.beta.conversations.start(
model="mistral-large-latest",
inputs=[
{"role": "user", "content": "What are the latest Ligue 1 results?"}
],
tools=[{"type": "web_search"}]
)
Esto es funcionalmente equivalente a un agente con web_search, pero sin persistencia de configuración. La diferencia se manifiesta en la décima llamada: con un agente, habrías cambiado la temperatura de una vez por todas; aquí, debes repetirla en cada solicitud, y nada garantiza que una llamada olvidada en algún lugar de tu código utilice la misma configuración.
Paso de instrucciones dinámicas
En modo directo, el prompt del sistema toma la forma de un mensaje system colocado al principio de los inputs.
response = client.beta.conversations.start(
model="mistral-large-latest",
inputs=[
{"role": "system", "content": "You are an expert in French cuisine. Answer in 3 sentences maximum."},
{"role": "user", "content": "How do I make a perfect béarnaise sauce?"}
]
)
Esto te ofrece la misma flexibilidad que las instrucciones de un agente, pero de forma efímera; y, lo que es más importante, esta cadena se puede construir en tiempo de ejecución, algo que una instrucción de agente registrado no permite.
Continuación de una conversación en modo directo
El mecanismo de persistencia funciona exactamente igual que con un agente: la primera llamada devuelve un conversation_id, las llamadas posteriores se adjuntan a él, y cada anexión devuelve a su vez un nuevo identificador.
# Primer intercambio
response1 = client.beta.conversations.start(
model="mistral-large-latest",
inputs=[{"role": "user", "content": "Tell me about the French Revolution."}]
)
# Segundo intercambio — el contexto se conserva
response2 = client.beta.conversations.append(
conversation_id=response1.conversation_id,
inputs="Who were the main figures?"
)
# El modelo sabe que estamos hablando de la Revolución Francesa
La segunda pregunta no nombra su sujeto y no lo necesita: la persistencia no depende de la existencia de un agente, solo de la conversación.
Agente frente a modo directo: cómo decidir
Crea un agente tan pronto como la misma configuración sirva para múltiples conversaciones, porque entonces ganas un único punto de modificación: corregir una instrucción actualiza todos los hilos futuros. Esta es también la única vía si tus instrucciones son estables de sesión en sesión, si planeas traspasos entre varios agentes —lo que detallará la lección dedicada al tema— o si tu organización requiere una configuración centralizada y auditable donde puedas responder a la pregunta: «¿Con qué instrucciones se ejecutó este asistente?».
Mantente en modo directo para los casos simétricos: un prototipo o un uso puntual, instrucciones que cambian con cada conversación, sin necesidad de traspasos, o el deseo de reducir las llamadas a la API eliminando la creación y eliminación de agentes. En el desarrollo, esta última razón suele ser suficiente por sí sola.
Ejemplo: pregunta dentro de un contexto forzado
La siguiente función ilustra perfectamente el modo directo. El contexto es un argumento, por lo que difiere en cada llamada, y el prompt del sistema se construye en torno a él para evitar que el modelo recurra a conocimientos externos. Ningún agente registrado podría llevar esta restricción, ya que cambia en cada invocación.
def ask_question(context: str, question: str):
"""Ask a question within a given context, without creating an agent."""
response = client.beta.conversations.start(
model="mistral-large-latest",
inputs=[
{"role": "system", "content": f"Context: {context}. Answer using only this context."},
{"role": "user", "content": question}
]
)
return response.outputs[-1].content
# Usage
answer = ask_question(
context="Corsen AI is a French startup specializing in sovereign AI, founded in 2025.",
question="When was Corsen AI founded?"
)
Reutiliza este patrón para tus propias necesidades sustituyendo el contexto codificado por el texto realmente relevante —la ficha de producto consultada, el extracto del documento seleccionado— y obtendrás un bloque de construcción de preguntas y respuestas enmarcadas sin ninguna configuración que administrar.
Puntos clave
- Las conversaciones pueden iniciarse con
model=en lugar deagent_id= - El modo directo ofrece persistencia sin la capa de configuración del Agente
- Puedes pasar herramientas e instrucciones directamente en la solicitud
- El modo directo es ideal para la creación de prototipos y usos puntuales
- Para traspasos y configuraciones reutilizables, es preferible crear un agente