GOGOGOLLC
Volver a RecursosEn vivo

Documentación

Vista previa — el SDK y la API que se muestran son ilustrativos y aún no están disponibles.

Construye con APIs multi-agente.

Una plataforma, un esquema de autenticación, cuatro superficies de producto. Cada endpoint es una ejecución del orquestador — observable, reproducible y reversible desde el panel.

Empezar el quickstartObtener API key
GoBot in a developer terminal — multi-agent API documentation

Quickstart

Tres comandos a la primera llamada de agente.

Instalas el SDK, configuras una clave de proyecto y disparas tu primera ejecución del orquestador. La CLI te guía para limitar la clave a una superficie de producto (Goddo, GoVista, GoPeople o GoTrack) en la primera ejecución.

  • ¿Necesitas una clave primero? Escribe a [email protected].
  • SDKs listos para TypeScript, Python y Go.
  • Cada comando CLI imprime la llamada REST equivalente.
bashapi.gogogo.dev
# 1. Install the SDK
npm install @gogogo/sdk

# 2. Authenticate with your project key
export GOGOGO_API_KEY="sk_live_…"

# 3. Run your first agent call
npx gogogo agent run goddo.image.generate \
  --prompt "A neon GoBot delivering a parcel" \
  --aspect 9:16
httpapi.gogogo.dev
POST https://api.gogogo.dev/v1/agents/run
Authorization: Bearer sk_live_…
Content-Type: application/json

{
  "agent": "govista.schedule",
  "tenant": "acme-retail",
  "input": {
    "campaign": "spring-launch",
    "windows": ["weekday-am", "weekend"]
  }
}

REST API

Un verbo. Muchos especialistas.

Casi toda operación pasa por un único endpoint — /v1/agents/run — con el nombre del agente en el cuerpo. El orquestador elige el especialista y las herramientas correctas, y la respuesta lleva un trace_id que puedes reproducir de extremo a extremo.

  • Ejecuciones del orquestador

    Cada llamada API es una ejecución del orquestador. El orquestador decide qué agentes especialistas manejan cada paso, llama las herramientas y entrega resultados.

  • Tenants y alcances

    Los recursos están limitados por tenant. Las API keys llevan un prefijo de tenant; puedes emitir sub-claves limitadas por producto o por entorno.

  • Idempotencia

    Pasa una Idempotency-Key en cualquier POST. Los reintentos en 24h devuelven la ejecución original en vez de re-ejecutar los agentes.

  • Observabilidad

    Cada ejecución emite un trace_id. Ábrelo en el panel para inspeccionar cada entrega entre agentes, llamada a herramienta y decisión — reproduce o revierte desde ahí.

Superficies por producto

Cuatro productos, un orquestador.

Cada producto expone sus propios endpoints bajo /v1/<product>/…. Los esquemas son estables; el orquestador detrás se actualiza semanalmente.

  • goddo logo

    Goddo

    API de generación imagen / video

    Envía prompts, refina renders, obtén la biblioteca de assets y recibe notificación al completar.

    • POST/v1/goddo/images
    • POST/v1/goddo/refine
    • GET/v1/goddo/library
    • WEBHOOKgoddo.render.completed
  • govista logo

    GoVista

    API CMS de señalización digital

    Provisiona dispositivos, programa playlists entre zonas y transmite telemetría de eventos de audiencia a tu almacén de datos.

    • POST/v1/govista/devices
    • POST/v1/govista/playlists
    • GET/v1/govista/zones
    • WEBHOOKgovista.audience.event
  • gopeople logo

    GoPeople

    API de RR.HH. en WhatsApp

    Vincula números WhatsApp Business, enruta intenciones clasificadas, ejecuta flujos de trabajo de vacaciones / documentos, registros auditables.

    • POST/v1/gopeople/threads
    • POST/v1/gopeople/workflows
    • GET/v1/gopeople/audit
    • WEBHOOKgopeople.message.classified

  • GoTrack

    API de visión por computadora para retail

    Eventos de retiro de producto, consultas de similitud FAISS, puntuación de zonas de perchero, webhooks pulse firmados para paneles en vivo.

    • POST/v1/gotrack/zones
    • POST/v1/gotrack/similarity
    • GET/v1/gotrack/score
    • WEBHOOKgotrack.pickup.detected

Webhooks

Eventos firmados, reproducibles.

Cada producto emite su propio stream de eventos. Cada entrega lleva un HMAC x-gogogo-signature, un trace_id y un nombre de evento estable — product.entity.action. Las entregas fallidas reintentan con backoff exponencial y son reproducibles desde el panel.

  • Ejemplos: goddo.render.completed · govista.audience.event · gopeople.message.classified · gotrack.pickup.detected.
  • Rota secretos de firma por entorno. Helpers de verificación incluidos en cada SDK.
tsapi.gogogo.dev
// Verify a GOGOGO webhook with your signing secret.
import { verifyWebhook } from "@gogogo/sdk/webhooks";

export async function POST(req: Request) {
  const ok = await verifyWebhook({
    body: await req.text(),
    signature: req.headers.get("x-gogogo-signature")!,
    secret: process.env.GOGOGO_WEBHOOK_SECRET!,
  });
  if (!ok) return new Response("invalid signature", { status: 400 });
  // …handle event…
}

SDKs

Clientes tipados, generados desde OpenAPI.

El spec OpenAPI es la fuente de verdad. Los SDKs se regeneran en cada release — mantienes el tipado sin que mantengamos cuatro librerías cliente paralelas a mano.

  • TypeScript / Node

    npm install @gogogo/sdk

    Estable · v0.6

  • Python

    pip install gogogo-sdk

    Estable · v0.5

  • Go

    go get github.com/gogogollc/gogogo-go

    Beta

  • OpenAPI spec

    curl https://api.gogogo.dev/openapi.yaml

    Siempre actual

Soporte

¿Atascado en algo específico?

Envíanos tu trace_id y el endpoint que llamas. Respondemos en un día hábil, y tenemos visibilidad sobre cada ejecución desde el panel.

Habla con ingenieríaAbrir Centro de Ayuda