Conversas sem um Agente
Nesta página
Modo de Modelo Direto
Nem sempre precisa de criar um objeto Agente para utilizar a API de Conversas. A Mistral permite iniciar uma conversa diretamente com um modelo, oferecendo persistência sem a camada de configuração do Agente. Esta capacidade decorre diretamente da arquitetura que abordámos anteriormente: a conversa é independente do agente, pelo que pode existir perfeitamente por si só.
Vários cenários tornam esta abordagem preferível à utilização de um agente registado. Pode desejar persistência sem definir um agente reutilizável, por exemplo, porque cada thread na sua aplicação é único. Pode estar a testar rapidamente comportamentos com ferramentas integradas, e criar e eliminar um agente para cada tentativa abrandá-lo-ia. O seu caso de uso pode ser pontual: nada justifica guardar uma configuração que só utilizará uma vez. Ou as suas instruções podem ser dinâmicas, calculadas em tempo de execução com base no perfil do utilizador ou no documento atual — caso em que um agente estático seria a ferramenta errada.
Iniciar uma Conversa com um Modelo
Em vez de passar um agent_id, passa diretamente um 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)
Tudo depende desta escolha de parâmetro. Com agent_id, a chamada herda a configuração registada do agente: as suas instruções, ferramentas e salvaguardas. Com model, está no modo direto e configura tudo no próprio pedido — nada é memorizado para além da chamada.
Adicionar Ferramentas no Modo Direto
As ferramentas integradas não são exclusivas dos agentes. Declara-as no pedido, exatamente como faria durante a criação de um 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"}]
)
Isto é funcionalmente equivalente a um agente com web_search, mas sem persistência de configuração. A diferença manifesta-se na décima chamada: com um agente, teria alterado a temperatura de uma vez por todas; aqui, deve repeti-la em cada pedido, e nada garante que uma chamada esquecida algures no seu código utilize as mesmas definições.
Passar Instruções Dinâmicas
No modo direto, o prompt do sistema assume a forma de uma mensagem system colocada no início dos 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?"}
]
)
Isto oferece-lhe a mesma flexibilidade das instruções de um agente, mas de forma efémera — e, crucialmente, esta cadeia de caracteres pode ser construída em tempo de execução, o que uma instrução de agente registado não permite.
Continuar uma Conversa no Modo Direto
O mecanismo de persistência funciona exatamente como com um agente: a primeira chamada devolve um conversation_id, as chamadas subsequentes anexam-se a ele e cada anexação devolve, por sua vez, um novo identificador.
# Primeira troca
response1 = client.beta.conversations.start(
model="mistral-large-latest",
inputs=[{"role": "user", "content": "Tell me about the French Revolution."}]
)
# Segunda troca — o contexto é preservado
response2 = client.beta.conversations.append(
conversation_id=response1.conversation_id,
inputs="Who were the main figures?"
)
# O modelo sabe que estamos a falar da Revolução Francesa
A segunda pergunta não nomeia o seu sujeito e não precisa disso: a persistência não depende da existência de um agente, apenas da conversa.
Agente vs. Modo Direto: Como Decidir
Crie um agente assim que a mesma configuração servir múltiplas conversas, pois ganha assim um único ponto de modificação: corrigir uma instrução atualiza todos os threads futuros. Este é também o único caminho se as suas instruções forem estáveis de sessão para sessão, se planear transferências entre múltiplos agentes — o que a lição dedicada ao tema detalhará — ou se a sua organização exigir uma configuração centralizada e auditável, onde possa responder à pergunta: «Com que instruções foi executado este assistente?».
Mantenha-se no modo direto para os casos simétricos: um protótipo ou utilização pontual, instruções que mudam a cada conversa, sem necessidade de transferências, ou o desejo de reduzir chamadas à API eliminando a criação e eliminação de agentes. Em desenvolvimento, esta última razão é frequentemente suficiente por si só.
Exemplo: Pergunta num Contexto Forçado
A função abaixo ilustra perfeitamente o modo direto. O contexto é um argumento, pelo que difere a cada chamada, e o prompt do sistema é construído em torno dele para impedir o modelo de recorrer a conhecimentos externos. Nenhum agente registado poderia transportar esta restrição, uma vez que muda a cada invocação.
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?"
)
Reutilize este padrão para as suas próprias necessidades, substituindo o contexto codificado pelo texto realmente relevante — a ficha do produto visualizada, o excerto do documento selecionado — e obterá um bloco de construção de perguntas e respostas enquadrado, sem qualquer configuração para administrar.
Pontos-chave
- As conversas podem ser iniciadas com
model=em vez deagent_id= - O modo direto oferece persistência sem a camada de configuração do Agente
- Pode passar ferramentas e instruções diretamente no pedido
- O modo direto é ideal para prototipagem e utilização pontual
- Para transferências e configurações reutilizáveis, prefira criar um agente