Click: API para agentes de IA dentro do seu produto

Para que serve o Click, em linguagem simples?

O Click é uma API para agentes de IA gerenciados, voltada a desenvolvedores que querem colocar agentes dentro do próprio produto. Você fornece a chave do modelo, as instruções e as ferramentas autorizadas. O Click executa as chamadas ao modelo e às ferramentas, mantém o histórico e cuida da recuperação da execução. O aplicativo recebe resultados por API, eventos ou webhooks.

Um exemplo é um assistente que analisa um CSV de vendas e entrega um relatório. Seu aplicativo controla usuários, dados e aprovações; o Click fornece a execução do agente. Operado pela Click AI Labs, Inc., atende fluxos com várias etapas e tarefas longas em segundo plano. A integração exige trabalho de backend e conferência dos resultados.

O que entra no custo de operação

Os preços públicos mensais em dólar foram verificados em 3 de novembro de 2026 na página oficial de planos. Não são valores finais em reais nem incluem uma conversão ou tributação brasileira confirmada.

• Free: US$ 0/mês. Duas sessões residentes simultâneas, 100 MB de arquivos e, por mês, uma hora de sandbox, uma hora de navegador gerenciado e 100 buscas.
• Pro: US$ 199/mês. 50 sessões residentes simultâneas, 10 GB e, por mês, 100 horas de sandbox, 100 de navegador e 5.000 buscas.
• Enterprise: preço e capacidade personalizados.

O modelo é BYOK: você usa suas próprias chaves e deve calcular os custos do provedor de IA separadamente. Serviços externos de sandbox ou navegador também podem cobrar à parte. Armazenamento é capacidade atual, não uma nova franquia mensal. Os limites gerenciados são compartilhados pelo tenant: Free segue o mês civil UTC e Pro o período pago da assinatura.

Sessões ativas e ociosas com runtime contam na concorrência; standby não conta. Ao esgotar uma franquia, ferramentas podem ser bloqueadas e trabalhos podem parar. A documentação informa que não há cobrança automática por excedente.

Como integrar e executar o primeiro agente

1. Prepare uma chave API do Click e outra de um provedor de modelos compatível. A documentação exige verificar um cartão antes de criar ou alterar recursos, com possíveis dispensas para contas existentes. A verificação não cobra nem inicia uma assinatura paga.
2. Armazene a chave do modelo com POST /credentials e guarde o ID retornado. Mantenha as duas chaves no backend.
3. Consulte GET /models e escolha um modelo do provedor correspondente.
4. Use POST /agents para definir modelo, instruções e permissões. Salve latest_version.id e crie uma sessão com POST /sessions.
5. Envie a tarefa a POST /sessions/{session_id}/submissions. Uma request_id permite recuperar o envio original ao repetir a solicitação.
6. Aguarde done, cancelled ou failed. Leia a resposta indicada quando houver sucesso e confira o motivo nos demais casos.

HTTP 202 só confirma o armazenamento da entrada. Relacione a sessão ao ticket ou documento do seu sistema para continuar com o histórico e verifique o acesso do usuário antes de retornar dados.

Ferramentas próprias e processamento de arquivos

É possível conectar servidores MCP Streamable HTTP e endpoints HTTP próprios por HTTPS público. Depois de criar a conexão, conceda explicitamente as ferramentas. Ferramentas HTTP descrevem os argumentos com JSON Schema e recebem um POST JSON, com timeout documentado de 120 segundos.

Um endpoint de tickets pode validar um token temporário restrito ao cliente correto. Autenticação, orçamento, aprovações e regras de negócio continuam sob responsabilidade do aplicativo.

O Click inclui busca web, automação de navegador e operações de arquivos e comandos em sandbox. A documentação também contempla Blaxel, Daytona e credenciais próprias do Browserbase. Custos e requisitos variam conforme o serviço escolhido.

Para arquivos, use a sandbox gerenciada pelo Click: envie a entrada por POST /files, inclua o ID na tarefa e faça o agente publicar a saída com publish_file. Consulte os artifacts e baixe com GET /files/{file_id}. O arquivo de trabalho da sandbox ainda precisa ser publicado para virar uma entrega durável; confira seu conteúdo.

Acompanhar tarefas longas sem prender o usuário

GET /sessions/{session_id}/events começa com um snapshot completo e depois envia mudanças de texto, ferramentas e status. Ao reconectar, substitua o estado local pelo novo snapshot. A desconexão não interrompe o trabalho; o fluxo fecha quando a sessão entra em standby.

Webhooks assinados para submission.updated e artifact.created permitem receber resultados em segundo plano. Depois da notificação, consulte o recurso para conhecer seu estado atual antes de atualizar o produto.

Dados, credenciais e controle do aplicativo

A declaração de privacidade inclui instruções, mensagens, arquivos, chamadas de ferramentas e credenciais. Dados podem ser enviados aos provedores de modelos e ferramentas para executar tarefas, também sujeitos às políticas desses serviços.

A equipe Click pode acessar conteúdo para integração inicial, suporte, diagnóstico e melhoria. A retenção segue necessidades razoáveis, sem prazo fixo universal. O processamento pode ocorrer nos EUA e em outros países. Isso não garante hospedagem no Brasil, retenção zero ou proibição geral de treinamento.

Segredos devem ficar nas configurações ou endpoints de credenciais, não em prompts ou arquivos. A política pede que informações reguladas altamente sensíveis não sejam enviadas.

Perguntas frequentes

Dá para começar no Click de graça?

Sim, dentro das franquias Free. O provedor do modelo pode cobrar separadamente e a criação de recursos normalmente exige verificação do cartão.

O preço inclui os modelos de IA?

O fluxo documentado usa suas próprias chaves de provedor. Considere esses gastos fora da assinatura e confira os modelos disponíveis em GET /models.

Posso conectar minhas próprias ferramentas?

Sim, por MCP ou ferramentas HTTPS com permissões explícitas. A autorização dos clientes e a aprovação de ações importantes continuam no seu aplicativo.

Recursos oficiais para desenvolvedores

• Referência da API: ferramentas, eventos, webhooks e arquivos.
• Início rápido: configuração do primeiro agente e sessão.
• Termos e suporte: condições do serviço e acesso ao suporte oficial.