Como usá-lo, na prática
As três coisas de que uma equipa nova precisa no primeiro dia. Tudo o que está aqui descreve o produto tal como é entregue hoje.
O que é um agente, e como pedir um
Um agente é um pedaço de TypeScript escrito contra um único objeto. Não tem de o escrever: descreva o trabalho no chat e o Naski escreve-o, e depois mostra-lhe o código antes de guardar seja o que for.
- 1
Diga o que deve acontecer, e quando. «Todos os dias úteis às 8h», «sempre que chegar um PDF a uma pasta», «quando alguém escrever para este endereço». O horário e o gatilho são lidos no código sem o executar, por isso escrevem-se como valores fixos.
- 2
Leia o que ele faz antes de guardar. O código é o comportamento — não há nada escondido por trás.
- 3
Dê-lhe uma pasta se só deve ver uma parte do seu espaço. As suas ferramentas de ficheiros ficam então confinadas a essa subárvore.
- 4
Deixe-o manter um diário. Um agente escreve uma linha em linguagem clara por cada coisa que fez, marcada como pendente ou concluída, e relê-as na execução seguinte. É assim que um trabalho longo sobrevive a ser repartido por muitas execuções curtas.
- 5
Decida o que passa por si. Pedir uma aprovação põe a execução em pausa até uma pessoa responder e trata o silêncio como uma recusa; arquivar uma revisão põe um item em fila para mais tarde sem bloquear nada.
- 6
Editar um agente cria um novo, por isso a versão que funcionava continua recuperável.
Vale a pena saberOs agentes não têm acesso ambiente à rede. Tudo o que alcançam — a web, o seu espaço, uma ferramenta ligada — passa por uma chamada nomeada que a plataforma faz por eles.
Como ligar uma ferramenta
Um conector é dados, não código: um endereço base, uma forma de autenticação e uma lista de operações. O Naski constrói o pedido e injeta a sua credencial do lado do servidor.
- 1
Abra Definições → Conectores e instale a partir do catálogo. Também pode pedir ao chat que o faça por si.
- 2
Onde o fornecedor esteja registado na sua instalação, carregue em Ligar e aprove no ecrã dele. Nenhuma chave é copiada para lado nenhum.
- 3
Caso contrário, cole a chave nas Definições. Nunca cole uma chave numa mensagem do chat: as chaves vivem nas Definições, onde são guardadas cifradas e injetadas do lado do servidor.
- 4
Alguns serviços vivem no endereço da própria empresa — Salesforce, Zendesk, Jira, Confluence, Zoho CRM, Odoo, Shopify, DocuSign. Instalá-los pede o URL da sua instância e recusa sem ele.
- 5
As chamadas de saída fazem-se apenas por HTTPS, e são recusadas quando o endereço resolve para uma rede privada ou reservada.
- 6
Se um fornecedor recusar renovar um token, a ligação é apagada e é-lhe dito para voltar a ligar — em vez de deixar cada chamada falhar em silêncio.
Vale a pena saberUm serviço fora do catálogo continua ao alcance: o chat pode escrever-lhe um conector na mesma forma declarativa, e um servidor MCP remoto cobre os serviços com forma de ferramenta.
Como ligar um cliente de IA externo
O Naski expõe o seu próprio servidor MCP, para que um cliente como o Claude Code, o Claude Desktop ou o ChatGPT possa listar, criar, executar e inspecionar os seus agentes a partir de onde já trabalha.
- 1
Abra Definições → Servidores MCP. O endereço está lá indicado, e é este:
https://api.blackbox.finance/mcp - 2
O Claude Desktop e o ChatGPT ligam-se por OAuth: acrescente o endereço como conector e aprove. Não há nenhum token para copiar.
- 3
Para um cliente de linha de comandos, gere um token nas Definições e execute:
claude mcp add --transport http naski https://api.blackbox.finance/mcp --header "Authorization: Bearer YOUR_TOKEN" - 4
Um token é mostrado uma só vez e é guardado apenas como hash. Revogue-o a partir do mesmo ecrã; uma conta pode ter até vinte.
- 5
As ligações de IA externas fazem parte dos planos pagos — o plano gratuito não as inclui.
Vale a pena saberTudo o que um cliente MCP vê está limitado à conta cujo token usa: os agentes, as execuções e os créditos dessa conta, e mais nada.
Pronto para o experimentar num fluxo de trabalho real?
O plano gratuito inclui um agente ativo e uma execução agendada — o suficiente para ver se o formato encaixa antes de alguém assinar seja o que for.