thais-ca

Integração Cloud para n8n com Mensagens, Lotes, Modelos, Arquivos, Habilidades, Agentes, Ambientes e Sessões.

Documentation

Thais CA para n8n

Integração Cloud para o n8n com uma única credencial de API comum. O pacote chama a API Cloud diretamente, não instala ferramentas locais, não executa plugins no servidor e não grava sua chave em arquivos temporários.

Instalação

No n8n, acesse Configurações → Community Nodes → Instalar e informe:

n8n-nodes-thais-ca

Depois, crie a credencial Thais CA — API Cloud e informe sua chave comum iniciada por sk-ant-api....

Recursos incluídos

Recurso Operações tipadas
Tarefas de Agentes Criar tarefa em um Agente Executor, Listar, Obter, Enviar Mensagem, obter Eventos/Resultado, Interromper e Arquivar. Cada tarefa é uma sessão de Agente Gerenciado, retorna task_id e preserva contexto para novas mensagens.
Mensagens Criar Mensagem e Contar Tokens.
Lotes de Mensagens Criar, Listar, Obter, Cancelar, Excluir e baixar Resultados.
Modelos Listar e Obter.
Arquivos Enviar binário, Listar, Obter metadados, Baixar e Excluir.
Habilidades Criar por binário, Listar, Obter e Excluir.
Agentes Gerenciados Criar, Listar, Obter, Atualizar e Arquivar.
Ambientes Criar, Listar, Obter, Atualizar, Arquivar e Excluir.
Sessões Criar, Listar, Obter, Atualizar, Arquivar, Excluir, Enviar Evento e Listar Eventos.
Implantações Criar, Listar, Obter, Atualizar, Pausar, Retomar, Executar Agora e Arquivar.
Recursos Beta Avançados Endpoint beta autenticado para memória, cofres, túneis, execuções em segundo plano, threads, recursos de sessão e fila de ambientes.
Chamada Personalizada Endpoint relativo autenticado para operações comuns ainda não tipadas.

Tarefas de Agentes

O recurso Tarefas de Agentes cria e opera trabalho persistente dentro de um Agente Gerenciado. Em Criar Tarefa no Agente, selecione o Agente Executor, informe o pedido e receba o task_id. O node abre uma sessão no agente selecionado, preservando as instruções, ferramentas, habilidades e integrações já configuradas nele. Para manter compatibilidade com workflows antigos, quando não houver Agente Executor salvo, o node cria ou reutiliza o agente padrão Thais CA — Executor de Tarefas.

Use Enviar Mensagem para Tarefa com esse mesmo task_id para continuar a sessão do mesmo agente, como "agora analise o próximo item". Use Obter Eventos e Resultado para ler a execução, Interromper Tarefa para enviar uma interrupção e Arquivar Tarefa quando não precisar mais do trabalho. A Política de Rede fica limitada por padrão; informe Hosts Permitidos ou escolha rede irrestrita somente quando necessário.

Limite de produto: Tarefas de Agentes não cria, lista, lê nem continua conversas do Claude web (claude.ai) ou do Claude Code. Elas são sessões independentes da API de Agentes Gerenciados.

Interface e AI Agent

Todos os recursos listáveis usam dropdown carregado da API Cloud. Campos de ID também aceitam busca e colagem manual de ID. Quando o nó está conectado como ferramenta de um Agente de IA, o recurso e a operação permanecem fixos por instância; os parâmetros operacionais compatíveis podem ser marcados como Definido pela IA.

Trigger

O Thais CA Trigger recebe eventos Cloud no webhook do n8n. Configure a URL de produção gerada pelo trigger no painel do serviço Cloud. Como nem todas as contas disponibilizam cadastro programático de webhook, o trigger não tenta criar webhook automaticamente.

Segurança

A URL base é fixa e a operação personalizada aceita apenas caminho relativo iniciado por /. Não existe campo para host arbitrário. O pacote usa exclusivamente a credencial Thais CA — API Cloud. Essa chave opera a API Cloud e não possui acesso ao histórico do Claude web.

Recursos beta podem exigir headers técnicos e liberação específica na conta. O provedor Cloud pode modificar endpoints beta antes de estabilizá-los.

Referências

Discussion