Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.mka1.com/llms.txt

Use this file to discover all available pages before exploring further.

Usa Archivos para subir documentos una sola vez. Usa Almacenes Vectoriales para indexar esos archivos y realizar búsquedas semánticas y recuperación de información. Este es el patrón estándar para asistentes respaldados por documentos, flujos de trabajo de recuperación y respuestas fundamentadas.

​
Subir un archivo

Sube el archivo usando multipart/form-data. La especificación OpenAPI en vivo requiere file y purpose. 
mka1 llm files upload \
  --file ./support-manual.pdf \
  --purpose assistants \
  -H 'X-On-Behalf-Of: <end-user-id>'
La respuesta devuelve un objeto file con un ID como file-abc123.

​
Crear un almacén vectorial

Crea un almacén vectorial y adjunta uno o más IDs de archivos subidos. 
mka1 llm vector-stores create --body '{
  "name": "Base de conocimientos de soporte",
  "description": "Manuales de soporte y documentos del centro de ayuda indexados",
  "file_ids": ["file-abc123"],
  "expires_after": { "anchor": "last_active_at", "days": 30 }
}'
Esta respuesta devuelve un ID de almacén vectorial como vs_abc123.

​
Agregar más archivos después

Puedes agregar más archivos a un almacén vectorial existente sin tener que recrearlo. 
mka1 llm vector-stores create-file \
  --vector-store-id vs_abc123 \
  --file-id file-def456 \
  --attributes '{"category":"manual","version":"2.0"}'
El archivo del almacén vectorial puede devolver status: "in_progress" mientras se realiza la indexación. Consulta los endpoints de Archivos y Almacenes Vectoriales en la Referencia de la API si necesitas consultar el estado.

​
Buscar en el almacén vectorial

Usa la búsqueda semántica para recuperar los fragmentos más relevantes para una pregunta de usuario. 
mka1 llm vector-stores search \
  --vector-store-id vs_abc123 \
  --body '{
    "query": "¿Cómo restablezco mi contraseña?",
    "max_num_results": 5
  }'
La respuesta devuelve coincidencias ordenadas con file_id, filename, datos de puntuación y el contenido del fragmento.

​
Flujo de trabajo típico

Utiliza esta secuencia para la mayoría de configuraciones de recuperación:
  1. Sube el archivo fuente.
  2. Crea un almacén vectorial con file_ids, o adjunta el archivo más tarde.
  3. Espera a que se complete el procesamiento del archivo.
  4. Busca en el almacén vectorial cuando necesites contexto relevante.
Luego puedes utilizar el texto devuelto en la lógica de tu propia aplicación o en una solicitud de Respuestas.