sk·core
Para equipes técnicas

Documentação técnica da SK Core.

Tudo que sua equipe técnica precisa: SDK TypeScript, REST API documentada em OpenAPI 3.1, arquitetura multi-tenant com Row-Level Security, modelos de IA suportados e infraestrutura como código.

SDK TypeScript

Comece em minutos

Instale o SDK, autentique e faça sua primeira chamada.

  • npm install @SeekST/sk-core-sdk
  • Auto-paginação, refresh de JWT e schemas Zod inclusos.
import { createClient } from '@SeekST/sk-core-sdk'

const sk = createClient({
  baseUrl: 'https://api.sk-core.com',
  token: process.env.SK_TOKEN,
})

// Listar work items de um projeto (auto-paginado)
const items = await sk.project.workItems.list({
  projectId: 'proj_123',
  status: 'in_progress',
})

// Disparar um agente sobre um work item
const execucao = await sk.agentic.agents.run({
  agentId: 'anubis',
  capability: 'gmud-review',
  input: { workItemId: items.data[0].id },
})

// Acompanhar steps em tempo real
for await (const step of sk.agentic.executions.stream(execucao.id)) {
  console.log(step.name, step.status)
}

Pilares técnicos

Arquitetura da plataforma, em detalhe.

Cada pilar técnico documentado — sem caixa-preta, com auditoria total.

SDK TypeScript

Pacote `@SeekST/sk-core-sdk` com tipos, schemas Zod e clientes prontos para os 46 endpoints da API.

  • Tipagem completa para todas as 56 entidades
  • Schemas Zod v4 com mensagens em pt-BR
  • Auto-paginação transparente
  • Refresh automático de JWT
  • Tree-shakable, ESM + CJS

REST API

46 endpoints organizados por módulo, documentados em OpenAPI 3.1 e prontos para uso em qualquer linguagem.

  • Base URL versionada por módulo (`/core/v1`, `/project/v1`, etc.)
  • Autenticação JWT Bearer + refresh token
  • Body direto sem wrapper (sem `data.data`)
  • Erros padronizados (RFC 7807)
  • Rate limiting por organização
  • Eventos via webhook + WebSocket para streaming

Segurança multi-tenant

Isolamento de dados por organização com Row-Level Security no PostgreSQL, audit triggers e RBAC controlado em controllers.

  • PostgreSQL Row-Level Security em toda tabela tenant
  • Chave composta com `organization_id` + audit triggers automáticos
  • RBAC em 3 níveis (plataforma / organização / aplicação)
  • Criptografia at-rest (AES-256) e in-transit (TLS 1.3)
  • Secrets via AWS SSM Parameter Store
  • Autenticação corporativa (SSO/SAML) opcional

Arquitetura agentic

Agentes configuráveis com três pilares: capabilities (habilidades nomeadas), steps (etapas estruturadas com tool calls) e memory (contexto persistido por organização).

  • Capabilities: habilidades nomeadas (`gmud-review`, `pr-review`, etc.)
  • Steps: análise → decisão → ação → artefato
  • Memory: contexto persistido entre execuções por organização
  • Tool calls: integrações estruturadas com sistemas externos
  • Streaming via WebSocket de cada step em tempo real
  • Audit log estruturado: prompt enviado, resposta, tokens, latência, modelo

Modelos de IA suportados

Integração nativa com AWS Bedrock. Escolha do modelo por capability, otimizando custo/qualidade por caso de uso.

  • Claude (Anthropic) — Sonnet, Haiku, Opus
  • Llama (Meta) — Llama 3.1 / 3.2
  • Mistral — Large 2, Small
  • Amazon Nova — Pro, Lite, Micro
  • Seleção do modelo por capability do agente
  • Fallback automático entre modelos em caso de falha

Integrações nativas

Conectores prontos para os sistemas que sua operação já usa — sem código glue.

  • Jira (sync bidirecional de issues)
  • GitHub (review de PRs via Agentic)
  • AWS Bedrock (modelos LLM)
  • BCB (cotações de câmbio)
  • CEPEA (índices de commodities)
  • Webhooks de saída para integrações customizadas

Infraestrutura como código

Toda a stack provisionada via Terraform na AWS, com pipeline OIDC e SHA-pinning.

  • Terraform 1.14+ em sk-core-iac
  • ECS Fargate + ALB + RDS PostgreSQL
  • WAF v2 + Route53 + ACM
  • CI/CD com OIDC (sem long-lived keys)
  • Multi-ambiente (dev us-east-1, prd us-east-2)
  • Backup automático + point-in-time recovery

Observabilidade

Telemetria estruturada e métricas detalhadas por agente, execução e endpoint.

  • OpenTelemetry: traces + métricas + logs
  • Logs estruturados em JSON
  • Streaming via WebSocket de eventos de execução
  • Latência de cada step + tokens consumidos por modelo
  • Dashboards prontos para CloudWatch + Grafana

Compliance & auditoria

Audit log imutável por entidade, pronto para LGPD e auditorias internas.

  • Audit log imutável por entidade (quem, o quê, quando)
  • PII tagging e mascaramento automático
  • Retenção configurável por organização
  • Backup automático + point-in-time recovery
  • Logs estruturados de toda execução agentic

Glossário

Termos técnicos da plataforma.

Referência rápida para conceitos arquiteturais usados no resto desta página.

Agent-native

Plataforma desenhada desde a fundação para ter agentes de IA como cidadãos de primeira classe — não como plugin posterior.

Capability

Habilidade nomeada de um agente (ex.: `gmud-review`, `pr-review`). Define o que o agente sabe fazer e qual modelo de IA usa.

Step

Etapa estruturada da execução de um agente: análise, decisão ou ação. Cada step tem entrada, saída e pode chamar ferramentas externas (tool calls).

Memory

Contexto persistido por organização entre execuções de agentes. Mantém histórico de feedback, decisões e padrões da empresa.

Multi-tenant

Arquitetura em que múltiplas organizações compartilham a mesma infraestrutura, mas com isolamento real entre seus dados.

RLS (Row-Level Security)

Mecanismo do PostgreSQL que garante que uma organização nunca consegue ler dados de outra, aplicado a nível de banco de dados.

RBAC

Role-Based Access Control. Controle de permissões baseado em funções, aplicado em 3 níveis na SK Core (plataforma, organização e aplicação).

JWT

JSON Web Token. Padrão de token de autenticação usado na API REST, com refresh automático no SDK.

OpenAPI 3.1

Especificação aberta para documentar APIs REST. A SK Core publica a especificação completa para geração de clientes em qualquer linguagem.

AWS Bedrock

Serviço gerenciado da AWS que expõe modelos de IA de múltiplos provedores (Anthropic, Meta, Mistral, Amazon) por trás de uma API única.

Acesso completo

Documentação completa, exemplos e credenciais.

Especificação OpenAPI 3.1, guias de integração e exemplos completos do SDK. Acesso liberado após o aceite comercial — fale conosco para receber as credenciais.

Solicitar acesso