菜单
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.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
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.
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`.
| name | apipass-usage |
| description | 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. |
| disable-model-invocation | false |
Perguntas de contagem/listagem agregada (quantos fluxos, quais fluxos, quantas execucoes) usam os SUMARIOS, NUNCA execution-logs:
| Pergunta | Ferramenta |
|---|---|
| "quantos fluxos executaram no periodo" / "quais fluxos rodaram" | get_execution_summary(period: "flow", startDate, endDate, timezone) — retorna um item por fluxo com a contagem |
| "quantas execucoes por dia/hora/mes" | get_execution_summary(period: "daily"|"hourly"|"monthly", ...) |
| "quantas execucoes no total" / "uso da conta" / "uso do flow engine" | get_usage_summary(metric: "total"|"average"|"flow-engine-usage") |
Os execution-logs (list_flow_execution_logs, get_flow_execution_log, etc.) sao para inspecionar/depurar execucoes especificas — NAO para contar ou listar quais fluxos rodaram. Listar logs e paginado e pesado; para volume/quais-fluxos, o sumario ja vem agregado.
Duas ferramentas cobrem consumo, com formatos diferentes — escolha pela pergunta:
get_execution_summaryConsumo ao longo do tempo (para tendencias/graficos). Obrigatorios: period, startDate, endDate, timezone.
period: daily | hourly | monthly | flow (agrupa por fluxo no periodo).projectId, flowId, environmentId.order, sortBy.Use para: "consumo por dia do ultimo mes", "execucoes por hora ontem", "consumo mensal do ano", "consumo por fluxo no projeto X".
get_usage_summaryNumeros consolidados da conta (para "quanto consumi" / cobranca / quota). Todos os params sao opcionais — sem startDate/endDate retorna o consumo corrente/total.
metric: total (total de requisicoes/execucoes) | average (media) | flow-engine-usage (uso do flow-engine — relevante para cobranca/limites).startDate, endDate, accountId, timezone.Use para: "quanto consumi este mes", "uso total da conta", "uso do flow engine", "media de execucoes".
timezone nas series temporais (ex. America/Sao_Paulo) — os buckets de dia/hora dependem dele.YYYY-MM-DD ou ISO completo). Para "este mes", calcule o primeiro e o ultimo dia.accountId so e necessario se o usuario quiser olhar outra conta a que tenha acesso.Consumo (quantos/quanto) e diferente de depurar uma execucao (por que falhou) — para investigar falhas use /apipass-integrations:apipass-gotchas (list_flow_execution_logs, etc.). Use consumo para volume/uso; logs para diagnostico.