Orquestre times de agentes de IA, com tipos de ponta a ponta.

import { z } from 'zod'
import { defineAgent, defineProject, defineSupervisor, defineTool } from '@blull/circuitai'

// O contexto compartilhado — o "blackboard" do time, tipado com Zod.
const Contexto = z.object({
  conta: z.object({ id: z.string(), valorEmAberto: z.number(), diasEmAtraso: z.number() }),
  scoreRecuperacao: z.number().min(0).max(1).optional(),
  proximaAcao: z.enum(['sms', 'ligacao', 'acordo', 'juridico']).optional(),
})
type Ctx = z.infer<typeof Contexto>

// Uma ferramenta tipada que o agente pode chamar no seu turno.
const historicoPagamentos = defineTool({
  name: 'historicoPagamentos',
  description: 'Busca o histórico de pagamentos de 90 dias do devedor.',
  schema: z.object({ contaId: z.string() }),
  handler: async ({ contaId }) => ({ contaId, promessasQuebradas: 2 }),
})

// Um agente: papel, meta, regras, schemas e a fatia de contexto que lê.
const scorer = defineAgent({
  name: 'scorer-recuperacao',
  goal: 'Estimar a probabilidade de recuperar esta conta em atraso',
  rules: 'Você é analista de crédito. Responda apenas em JSON.',
  model: openai,
  outputSchema: z.object({ scoreRecuperacao: z.number().min(0).max(1) }),
  contextSelector: (ctx: Ctx) => ({ conta: ctx.conta }),
  tools: [historicoPagamentos],
})

// O projeto reúne o time e um supervisor que roteia o trabalho.
const projeto = defineProject({
  name: 'decisao-cobranca',
  goal: 'Definir a próxima melhor ação para cada conta em atraso',
  contextSchema: Contexto,
  agents: [scorer, seletorDeAcao],
  supervisor: defineSupervisor<Ctx>({
    model: openai,
    rules: 'Calcule o score, depois escolha a ação. Pare quando proximaAcao existir.',
    terminationCondition: (ctx) => ctx.proximaAcao !== undefined,
    maxTurns: 8,
  }),
})