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.

Utilice la API de Agentes cuando desee objetos de agente de primera clase y reutilizables en lugar de construir una solicitud de Respuestas desde cero cada vez. Un agente almacena la elección del modelo, instrucciones y configuración de herramientas. Cada ejecución persiste la entrada más el resultado de la API de Respuestas aguas arriba. Referencia de la API:

​
Crear un agente

Cree un agente una vez y luego reutilice su comportamiento guardado en múltiples ejecuciones. El siguiente ejemplo almacena instrucciones y una herramienta web_search para que ejecuciones posteriores puedan llamar a herramientas externas cuando sea necesario. 
mka1 agents create --body '{
  "name": "release-research-agent",
  "description": "Looks up current release information before answering.",
  "model": "meetkai:functionary-es-mini",
  "instructions": "Use web search when the question depends on current external information.",
  "tools": [
    {
      "type": "web_search",
      "search_context_size": "medium"
    }
  ],
  "tool_choice": "meetkai:functionary-es-mini",
  "parallel_tool_calls": true,
  "metadata": {
    "team": "docs"
  }
}' \
  -H 'X-On-Behalf-Of: <end-user-id>'
La respuesta es un objeto agent con un id estable como agt_.... Consulte la Referencia de la API para crear un agente para ver el esquema completo.

​
Listar y recuperar agentes

Utilice el endpoint de colección para listar los agentes guardados para el llamador actual. Utilice el endpoint de ítem cuando ya conozca el ID del agente. 
# Listar agentes
mka1 agents list --order desc

# Recuperar un solo agente por id
mka1 agents get --agent-id agt_123
Consulte la Referencia de la API para listar agentes y la Referencia de la API para recuperar un agente para ver las formas completas de respuesta.

​
Ejecutar un agente guardado

Ejecute el agente enviando solo la entrada por ejecución y metadatos opcionales. El servicio combina esto con la configuración guardada del agente y reenvía la solicitud a la API de Respuestas a través de mkllm-gateway. 
mka1 agent-runs create --agent-id agt_123 --body '{
  "input": [
    {
      "type": "text",
      "text": "What is Bun'"'"'s current stable version? Use web search before answering."
    }
  ],
  "metadata": {
    "request_source": "docs"
  }
}'
La respuesta de la ejecución incluye:
  • el ID de la ejecución persistida
  • el estado de la ejecución
  • gateway_response_id de la llamada a Respuestas aguas arriba
  • gateway_response, que contiene la salida almacenada del asistente y cualquier actividad de herramientas
Si la ejecución utilizó web_search, el gateway_response persistido incluirá las entradas correspondientes de llamadas a herramientas. Consulte la Referencia de la API para ejecutar un agente guardado para ver el esquema completo de solicitud y respuesta de ejecución.

​
Inspeccionar el historial de ejecuciones

Utilice la colección de ejecuciones para listar ejecuciones previas de un agente. Utilice el endpoint de detalle de ejecución para recuperar un resultado almacenado nuevamente más tarde. 
# Listar ejecuciones para un agente
mka1 agent-runs list --agent-id agt_123

# Recuperar una sola ejecución
mka1 agent-runs get --agent-id agt_123 --run-id run_123
Para recuperar una ejecución directamente: 
curl https://apigw.mka1.com/api/v1/agents/agt_123/runs/run_123 \
  --header 'Authorization: Bearer <mka1-api-key>' \
  --header 'X-On-Behalf-Of: <end-user-id>'
Consulte la Referencia de la API para listar ejecuciones de un agente y la Referencia de la API para recuperar una ejecución de agente para ver el esquema completo del historial de ejecuciones.

​
Actualizar o eliminar un agente

Utilice POST /api/v1/agents/{agent_id} para actualizar la configuración almacenada. Utilice DELETE /api/v1/agents/{agent_id} para eliminar suavemente el agente cuando ya no deba aceptar nuevas ejecuciones. 
curl https://apigw.mka1.com/api/v1/agents/agt_123 \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <mka1-api-key>' \
  --header 'X-On-Behalf-Of: <end-user-id>' \
  --data '{
    "instructions": "Use web search for current information. Reply in 3 bullets max."
  }'

curl https://apigw.mka1.com/api/v1/agents/agt_123 \
  --request DELETE \
  --header 'Authorization: Bearer <mka1-api-key>' \
  --header 'X-On-Behalf-Of: <end-user-id>'
Consulte la Referencia de la API para actualizar un agente y la Referencia de la API para eliminar un agente para los detalles del endpoint. Revise la Guía de la API de Respuestas si desea comparar la ejecución de agentes guardados con solicitudes de respuesta puntuales.