API Reference

Rotas para o assistente de IA integrado às notas. O assistente classifica a intenção do usuário em chat, plan ou suggestion e adapta o comportamento automaticamente.

GET /api/ai/models

Lista os modelos de IA disponíveis.

Resposta 200

{
  models: {
    id: string;
    provider: string;
    label: string;
    description: string;
  }[];
}

GET /api/ai/settings

Retorna as configurações de IA do workspace.

Resposta 200

{
  settings: {
    workspaceId: string;
    defaultModelId: string;
    systemPrompt: string | null;
  };
}

PATCH /api/ai/settings

Atualiza as configurações de IA do workspace.

Corpo da requisição

Resposta 200

Retorna as configurações atualizadas.

POST /api/ai/chat

Envia uma mensagem ao assistente. Retorna uma stream de resposta.

Corpo da requisição

{
  messages: {
    role?: string;
    parts?: { type?: string; text?: string }[];
  }[];
  noteId?: string;         // ID da nota para contexto
  modelId?: string;        // Sobrescreve o modelo padrão do workspace
  selectionContext?: {
    hasSelection?: boolean;
    text?: string;         // Texto selecionado na nota
  };
}

Comportamento por intenção

Resposta

Stream text/event-stream com os chunks da mensagem e metadados (intenção classificada).

Nota: O modelo é escolhido na ordem: modelId da requisição → defaultModelId do workspace → modelo padrão do sistema.