Saltar al contenido principal

Inicio rápido de agente

Al final de esta guía, tendrás un agente configurado en el panel, probado en chat y listo para ser llamado a través de la API pública.

Requisitos previos

  • Un espacio de trabajo de Fetch Hive
  • Una clave de API del espacio de trabajo si quieres ejecutar el ejemplo público de cURL — consulta Claves de API

Paso 1: Crear un agente

Abre Agents en la barra lateral y luego haz clic en Add Agent. Ingresa un Name. Si tu espacio de trabajo usa categorías, también puedes elegir una Category. Haz clic en Save para abrir el editor del agente.

Paso 2: Configurar el agente raíz

En el editor, haz clic en el nodo del agente raíz para abrir Agent Settings. Agrega un breve Instruction Prompt que le indique al agente qué hacer. También puedes confirmar el Model, pero puedes dejar la configuración predeterminada para este primer intento. Por ejemplo:
You are a research assistant. Answer clearly and keep responses brief unless the user asks for more detail.

Paso 3: Probar el agente en chat

Haz clic en Chat en el encabezado del editor. Envía un mensaje corto de prueba en el panel de chat y confirma que el agente responde como esperas. Este panel de chat es para pruebas en el panel. La interfaz indica explícitamente que estos mensajes no se guardan, así que considéralo un lugar seguro para iterar sobre el comportamiento antes de conectar el agente a tu app.

Paso 4: Copiar el fragmento de invocación pública

Abre Code Snippet en el encabezado del editor, o usa More en la barra lateral y haz clic en Get Code. Selecciona tu Agent y API Key. El diálogo muestra el ejemplo público de cURL para POST /v1/agent/invoke. El diálogo proporciona un fragmento de cURL aquí. Las pestañas Python y TypeScript aún están marcadas como Coming Soon.
curl 'https://api.fetchhive.com/v1/agent/invoke' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  --data-raw '{
    "agent": "YOUR_AGENT_ID",
    "message": "Summarize the latest AI infrastructure trends",
    "streaming": true
  }' \
  --compressed
Reemplaza YOUR_API_KEY y YOUR_AGENT_ID con tus valores reales. El panel Chat dentro de la app usa un flujo privado de pruebas del panel. El fragmento de arriba es el flujo de la API pública que usas fuera del panel.

Próximos pasos