GOGOGOLLC
Kaynaklara dönCanlı

Dokümantasyon

Önizleme — buradaki SDK ve API örnek amaçlıdır, henüz genel kullanıma açık değildir.

Çoklu ajan API'leriyle geliştir.

Tek platform, tek kimlik doğrulama şeması, dört ürün yüzeyi. Her endpoint bir orkestratör çalıştırması — gözlemlenebilir, yeniden oynatılabilir ve panelden geri alınabilir.

GoBot in a developer terminal — multi-agent API documentation

Hızlı Başlangıç

İlk ajan çağrısına üç komut.

SDK'yı yüklersin, bir proje anahtarı belirlersin ve ilk orkestratör çalıştırmanı tetiklersin. CLI ilk çalıştırmada anahtarı bir ürün yüzeyine (Goddo, GoVista, GoPeople veya GoTrack) bağlamak için sana yol gösterir.

  • Önce anahtar mı lazım? [email protected]'a yaz.
  • TypeScript, Python ve Go için hazır SDK'lar.
  • Her CLI komutu eşdeğer REST çağrısını yazdırır.
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

Tek fiil. Çok uzman.

Neredeyse her işlem tek bir endpoint'ten geçer — /v1/agents/run — gövdede ajan adı ile. Orkestratör doğru uzmanı ve aracı seçer; cevap baştan sona yeniden oynatabileceğin bir trace_id taşır.

  • Orkestratör çalıştırmaları

    Her API çağrısı bir orkestratör çalıştırmasıdır. Orkestratör hangi uzman ajanın hangi adımı işleyeceğine karar verir, araçları çağırır ve sonuç üretir.

  • Tenant ve kapsamlar

    Kaynaklar tenant başına kapsamlanır. API anahtarları bir tenant öneki taşır; ürün ya da ortam başına alt anahtarlar oluşturabilirsin.

  • Idempotency

    Herhangi bir POST'ta Idempotency-Key gönder. 24 saat içindeki yeniden denemeler ajanları tekrar çalıştırmak yerine orijinal çalıştırmayı döner.

  • Gözlemlenebilirlik

    Her çalıştırma bir trace_id üretir. Panelden aç, her görev devrini, araç çağrısını ve kararı incele — oradan yeniden oynat ya da geri al.

Ürün yüzeyleri

Dört ürün, tek orkestratör.

Her ürün kendi endpoint'lerini /v1/<product>/… altında sunar. Şemalar stabildir; arkadaki orkestratör haftalık güncellenir.

  • goddo logo

    Goddo

    Görsel / video üretim API'si

    Prompt gönder, render'ları rafine et, asset kütüphanesini al, tamamlanınca bildirim al.

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

    GoVista

    Dijital tabela CMS API'si

    Cihaz kaydı, bölgeler arası oynatma listesi planlama ve audience-event telemetrisini veri ambarına akıt.

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

    GoPeople

    WhatsApp İK API'si

    WhatsApp Business numaralarını bağla, sınıflandırılmış niyetleri yönlendir, izin / belge iş akışlarını çalıştır, denetlenebilir kayıtlar.

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

    Bilgisayarlı görü perakende API'si

    Ürün alma olayları, FAISS benzerlik sorguları, askılık bölgesi skorlaması, canlı panel için imzalı pulse webhook'ları.

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

Webhook'lar

İmzalı olaylar, yeniden oynatılabilir.

Her ürün kendi olay akışını yayar. Her teslim bir x-gogogo-signature HMAC, bir trace_id ve sabit bir olay adı taşır — product.entity.action. Başarısız teslimler üstel geri çekilme ile yeniden denenir ve panelden yeniden oynatılabilir.

  • Örnekler: goddo.render.completed · govista.audience.event · gopeople.message.classified · gotrack.pickup.detected.
  • İmzalama sırlarını ortam başına döndür. Doğrulama yardımcıları her SDK'da gelir.
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…
}

SDK'lar

Typed istemciler, OpenAPI'den üretilir.

OpenAPI spec'i tek doğru kaynaktır. SDK'lar her sürümde yeniden üretilir — biz dört paralel istemci kütüphanesini elle bakım yapmadan tip güvenliğin korunur.

  • TypeScript / Node

    npm install @gogogo/sdk

    Stabil · v0.6
  • Python

    pip install gogogo-sdk

    Stabil · v0.5
  • Go

    go get github.com/gogogollc/gogogo-go

    Beta
  • OpenAPI spec

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

    Daima güncel

Destek

Belirli bir konuda mı takıldın?

Bize trace_id'ni ve çağırdığın endpoint'i gönder. Bir iş günü içinde yanıtlarız ve panelden her çalıştırmayı izliyoruz.