apipass-headless

Gerar documentacao de integracoes (Word/PDF) a partir dos fluxos de um projeto APIPASS. Use quando o usuario pedir "documente os fluxos do projeto X", "gere a documentacao de integracao", "PDF dos fluxos do cliente Y", "documento tecnico das integracoes", "gerador de documentacao", "documento ABNT", "documento tecnico-funcional".

Erros comuns e armadilhas ao construir fluxos na APIPASS e o fluxo de debug de execucao (analise de logs). Carregue ao depurar um erro de fluxo ou uma execucao que falhou.

Estrutura de um fluxo da APIPASS — montagem incremental, contadores lastGeneratedStepId/lastGeneratedLoopId, leitura da estrutura, versoes e publicacao (environment).

Referencia do catalogo de acoes da APIPASS e a anatomia do FlowStep. Carregue ao montar passos de um fluxo, escolher um gatilho ou preencher mappingAttributes.

Referencia do catalogo de acoes de IA da APIPASS (Agent Builder) e a anatomia do step de Agente. Carregue ao montar um fluxo com `.service.ai.AiAgent`, modelo LLM, memoria, tools, embeddings, vector store, document loader ou splitter.

Analise de consumo/uso da APIPASS — execucoes e requisicoes por periodo, totais/medias da conta e uso do flow-engine. Carregue quando o usuario perguntar sobre "consumo", "uso", "quanto consumi", "uso do mes", "consumo por fluxo/projeto", "uso do flow engine", quota ou custo de execucoes.

Construir ou modificar fluxos de AGENTE DE IA na APIPASS (Agent Builder). Use quando o pedido envolve um agente de IA, RAG ou base de conhecimento — "crie um agente de IA que...", "agente que analisa/responde...", "chatbot com base de conhecimento", "fluxo de RAG", "ingestao para vector store", "agente que consulta o banco e responde". Ponto de entrada para fluxos com `.service.ai.AiAgent`, modelos LLM, memoria, tools, embeddings, vector store, document loaders e splitters. Carregue ANTES de montar os steps de IA. A mecanica compartilhada (trigger, stop, auth, versao, publish) e delegada a `/apipass-integrations:build-flow`.

Construir ou modificar fluxos de integracao na APIPASS. Use sempre que o usuario pedir para criar, construir ou alterar um fluxo — "construa um fluxo que...", "crie uma integracao para...", "automatize X", "modifique o fluxo que...". Ponto de entrada para TODA construcao/modificacao de fluxo. Carregue ANTES de chamar create_flow / save_flow_development.

Criar uma custom action da APIPASS a partir da documentacao de uma API (OpenAPI/Swagger, doc HTML, cURL ou descricao). Use quando o usuario pedir "crie uma action a partir desta doc", "transforme este endpoint em uma action", "gere uma action de API", "importe este OpenAPI como actions". Ponto de entrada para CRIAR/EDITAR custom action. Carregue ANTES de chamar create_custom_action / update_custom_action.

Comparar versoes de um fluxo APIPASS — ver o que mudou entre versoes, listar historico de versoes, auditar alteracoes em steps. Use sempre que o usuario pedir para comparar versoes, ver diferencas entre versoes, ver o que mudou em um fluxo, auditar historico de alteracoes, ou listar versoes de um fluxo. Carregue ANTES de chamar list_flow_versions / get_version.

Processo para pesquisar uma acao do catalogo da APIPASS — descobrir o type exato, a autenticacao e o shape do mappingAttributes antes de montar um passo do fluxo.

Audita um fluxo APIPASS contra boas práticas e convenções da plataforma — arquitetura, tratamento de erros, autorização e credenciais, código NodeJS, queries SQL, nomenclatura, variáveis de environment, sincronismo e persistência. Use quando o usuário pedir para revisar, auditar, checar ou analisar um fluxo — "revise o fluxo X", "tem algo errado neste fluxo?", "analise a arquitetura do fluxo", "verifique boas práticas", "code review do fluxo", "o que pode melhorar neste fluxo".

Como informar a conta APIPASS (accountName) que resolve o realm do Keycloak no login. No servidor hospedado, a conta vai como argumento do apipass_login (por usuario/sessao).