action_plan_create
ChatGPTCria (ou reaproveita) um Plano de Ação. Para Indicador, informe indicatorUid: é get-or-create, repetir a chamada devolve o mesmo plano. Para Solução de Problemas ou Projeto, informe stepId (obtido em action_plan_list_available_steps) e idempotencyKey (Guid gerado pelo chamador, obrigatório nesse caminho porque um passo aceita mais de um plano). Informe exatamente uma das duas origens (indicatorUid OU stepId), nunca as duas nem nenhuma. IMPORTANTE: se action_plan_list_available_steps devolver mais de um passo elegível, NUNCA escolha um por conta própria — pergunte ao usuário qual passo usar antes de chamar esta tool. Só prossiga sem perguntar quando houver exatamente um passo elegível.
action_plan_get
ChatGPTConsulta um Plano de Ação ou Cronograma do Stratws pelo seu identificador (Guid), devolvendo tipo, se está em execução, a entidade dona e a quantidade de tarefas visíveis. Use para confirmar o plano antes de criar uma tarefa nele com tasks_create, em vez de supor qual é. Obtenha o identificador em action_plan_list.
action_plan_list
ChatGPTLista os Planos de Ação e Cronogramas em execução aos quais o usuário do Stratws tem acesso. É o PRIMEIRO passo para qualquer pergunta sobre tarefas: tasks_list exige os identificadores (Guid) dos planos, e é aqui que eles são obtidos. Cada plano vem com o tipo (solução de problemas, cronograma, indicador, reunião, Meu Espaço etc.), a entidade dona com sua descrição, e a quantidade de tarefas. Uma mesma entidade dona costuma ter vários planos — uma solução de problemas tem um plano por ferramenta —, então para ver as tarefas de uma entidade agrupe os planos que compartilham o mesmo ownerEntityUid e informe todos de uma vez em tasks_list. Para percorrer tudo, chamar repetidamente incrementando skip até esgotar totalCount.
action_plan_list_available_steps
ChatGPTLista os Passos (etapas) de uma Solução de Problemas ou Projeto que aceitam receber um novo Plano de Ação. Use antes de action_plan_create quando a origem não tiver plano ainda: Solução de Problemas e Projeto não têm "o" plano único como o Indicador. Se a lista devolver mais de um passo, pergunte ao usuário qual deles usar — NUNCA escolha o primeiro (ou qualquer outro) por conta própria; se devolver exatamente um, use-o diretamente sem perguntar. Obtenha o ownerEntityUid em problem_solution_get/problem_solution_list ou project_get/project_list.
feedbacks_create
ChatGPTCria um novo feedback para um colega da mesma empresa, usando um template de mensagem existente.
feedbacks_edit
ChatGPTEdita os tópicos de um feedback já existente enviado pelo usuário autenticado (substituição total dos valores).
feedbacks_list
ChatGPTLista os feedbacks enviados/recebidos pelo usuário autenticado, de forma paginada, incluindo os tópicos de cada feedback com o título e a mensagem escrita.
feedbacks_list_templates
ChatGPTLista os templates de mensagem de feedback disponíveis, com os títulos de tópicos de cada um.
indicator_import_values
ChatGPTImporta, atualiza ou define valores (real, meta/target, programado, projetado) de um ou mais indicadores no Stratws para a frequência informada. Cada medida pode ser gravada/atualizada, mantida (omitir) ou anulada (clear: true).
indicator_list
ChatGPTLista indicadores de um plano de gestão do Stratws, com metadados completos (nome traduzido, código de interface, frequência, unidade de medida, área de resultados, dimensões, tolerâncias de farol, se está ativo, tipo e Guids de planos de ação vinculados). Respeita a permissão do usuário atual (comum vê só sua UG, administrador vê a hierarquia, super usuário vê tudo no tenant). Por padrão consulta o plano de gestão do ano atual; para anos anteriores, informe managementPlanId explicitamente (ver management_plan_list). Use o campo uid de cada indicador para chamar indicator_list_values (o id numérico também é aceito). Cada item também traz availableDrilldownTypes/hasDrilldown/hasCalculationFormula — que são apenas SINALIZADORES: esta tool NÃO retorna a expressão da fórmula nem os itens do desdobramento. Quando hasCalculationFormula for true ou availableDrilldownTypes não estiver vazio, chame indicator_list_drilldowns para obter a fórmula e os itens. Nunca responda que esses dados são indisponíveis sem antes chamar indicator_list_drilldowns. IMPORTANTE: por padrão retorna SOMENTE indicadores ativos — indicadores cancelados ficam fora da listagem. Para incluir os inativos, informe active como null; para ver apenas os inativos, false. RECORTE SEMPRE QUE PUDER: além de managementPlanId e managementUnitId, esta tool aceita indicatorTypeId, nature, measureUnitId e resultsAreaId, todos aplicados no banco. Um tenant grande tem dezenas de milhares de indicadores e o teto por página é 200 — recortar no servidor é a diferença entre uma chamada e centenas. NÃO liste tudo para filtrar depois: resolva os ids em indicator_type_list, indicator_measure_unit_list e indicator_results_area_list e passe-os aqui. OFEREÇA O RECORTE ANTES DE LISTAR AMPLO: se o pedido não indicar recorte além do plano e da unidade, ANTES de chamar esta tool diga à pessoa que a listagem pode ser filtrada por tipo, natureza, unidade de medida e área de resultados, e pergunte se ela quer algum desses — ninguém descobre esses filtros sozinho. É OFERTA, NÃO PRÉ-REQUISITO: se ela quiser a lista inteira, ou não responder, siga com a chamada. IDENTIFIQUE O INDICADOR PELO NOME COMPLETO: cada item traz name, fullName e interfaceCode — ao apresentar o indicador à pessoa, ou ao citá-lo em qualquer resposta, use fullName. O name é abreviado e não distingue o mesmo indicador em duas Unidades Gerenciais nem os membros de dimensão; o interfaceCode é código de integração e não diz nada a quem lê. Só recorra a eles quando fullName vier vazio. Perguntar antes é o único momento em que isso serve, porque depois da chamada os dados já ocupam a conversa. Cada item traz também a Unidade Gerencial do indicador (managementUnitId, managementUnitName e managementUnitAcronym — id, nome e sigla no plano de gestão), então NÃO é preciso listar UG por UG para saber a que UG um indicador pertence.
indicator_list_drilldowns
ChatGPTUSE ESTA TOOL sempre que precisar da fórmula de cálculo de um indicador ou dos itens do desdobramento dele. Esses dados NÃO existem em indicator_list — lá só há os sinalizadores hasCalculationFormula e availableDrilldownTypes, que dizem se vale a pena chamar esta tool. Retorna, para uma lista de indicadores, os desdobramentos de cada um e as chaves dos indicadores relacionados — como explicar de onde vem o número de um indicador. Cada desdobramento tem um tipo: 'Formula' traz a expressão matemática (campo expression, com placeholders [Item N]) e os operandos em items; 'PorCesta' compõe o resultado do indicador por média ponderada, sem expressão — o peso de cada item vem em items[].weight (1 a 100); 'PorItens' é apenas um agrupamento organizacional. ATENÇÃO: um item de 'PorItens' NÃO é necessariamente uma parcela do indicador pai — confira affectsParentCalculation antes de somar os filhos, ou você reportará divergências inexistentes. Retorna UM nível: para descer na hierarquia, chame novamente com os items[].indicatorUid retornados. 'Hierarquico' (mesmo indicador nas Unidades Gerenciais subordinadas) e 'Dimensoes' (irmãos por membro de dimensão) TAMBÉM vêm expandidos, um nível por chamada — é por 'Hierarquico' que se desce a hierarquia de UGs de um indicador. Os itens de cada desdobramento podem vir cortados em 50: compare totalItemCount com items e veja itemsTruncated antes de concluir que a lista está completa. Prefira identificar os indicadores por indicatorUids (o campo uid de indicator_list); indicatorIds, com o id numérico, segue aceito para compatibilidade. Cada item retornado traz indicatorUid, managementUnitName e measurementUnit do indicador relacionado, então dá para reusar o uid direto em indicator_list_values sem voltar ao indicator_list.
indicator_list_evidence_status
ChatGPTResponde "quais indicadores têm valor lançado no período e NÃO têm evidência (arquivo) anexada" — a pendência de comprovação que trava o fechamento de ciclo em processos de remuneração variável. Respeita a permissão do usuário atual (comum vê só sua UG, administrador vê a hierarquia, super usuário vê tudo no tenant) e nunca expõe nome de arquivo fora desse escopo. DEFINIÇÃO DE EVIDÊNCIA, importante para não reportar divergência como se fosse erro: conta apenas ARQUIVO anexado ao PRÓPRIO indicador. Link externo (Google Drive, URL) NÃO conta, e anexo feito no indicador base (template) NÃO é herdado pelos indicadores das unidades — a tela do indicador soma esses dois casos, então um indicador pode aparecer aqui como pendente e exibir anexo na tela. Isso é intencional: para auditoria, cada unidade comprova o seu resultado. NÃO AVALIE O CONTEÚDO: a tool informa que o anexo existe, o nome e a data — nunca conclua nem reporte que a evidência é válida, adequada ou suficiente; hasEvidence=true pode ser um arquivo irrelevante, e isso está fora do que o Stratws sabe. LEIA OS CONTADORES ANTES DE CONCLUIR: se indicatorsWithLaunchedValues vier 0, NADA foi avaliado — normalmente a frequência está errada (confira monthlyFrequency/weeklyFrequency/dailyFrequency em indicator_list) ou o painel informado não tem indicadores vinculados; nesse caso responda que nada foi avaliado, e JAMAIS que todos os indicadores têm evidência. Para agrupar por painel não é preciso segunda chamada: cada indicador já traz o campo panels. Para filtrar por painel use panelIds, obtendo os identificadores em results_program_list_panels — que exige resultsProgramId, vindo por sua vez de results_program_list. São duas chamadas antes desta, nessa ordem; pular a primeira faz a segunda falhar por parâmetro obrigatório ausente. AO APRESENTAR O RESULTADO, use sempre as mesmas colunas, na mesma ordem, seja a pergunta por UG, por painel ou por responsável: o indicador, se tem evidência e, para cada anexo, o nome do arquivo (fileName), QUEM ANEXOU (authorUserName), a DATA DE ENVIO (uploadedAt) e a quantidade (evidenceCount). Autor e data de envio são obrigatórios e não podem ser omitidos para encurtar a resposta: em auditoria eles são os dois eixos da rastreabilidade — sem a data não se sabe se a comprovação entrou no prazo do ciclo, e sem o autor não se sabe a quem recorrer sobre o arquivo. Anexo legado pode ter uploadedAt ou authorUserName nulo — nesse caso escreva "sem data registrada" / "autor não registrado" e mantenha a coluna, nunca estime a data a partir do período consultado nem atribua o anexo ao responsável do indicador. Não use includeAttachments=false quando a resposta for detalhar anexo: nesse modo attachments vem vazia e evidenceCount vem nulo por construção, e não há como cumprir o formato acima.
indicator_list_problem_solutions
ChatGPTResponde "este indicador já tem tratativa registrada?" e o inverso, "de qual indicador veio esta solução?". É a ÚNICA forma de cruzar indicador com solução de problemas: nem indicator_list nem problem_solutions_list trazem o outro lado. DUAS DIREÇÕES, MUTUAMENTE EXCLUSIVAS: informe indicatorUids (até 200, obtidos em indicator_list) OU problemSolutionUids (até 50, obtidos em problem_solutions_list, problem_solutions_get_detail_by_number ou project_list) — informar os dois é erro, e a tool NÃO escolhe um por você. A resposta vem sempre agrupada por indicador, nas duas direções. AUSÊNCIA DE VÍNCULO É SUCESSO, NÃO ERRO: um indicador que existe, que você alcança e que não tem tratativa volta em indicators com problemSolutions vazia — responda "não há solução de problemas vinculada", e JAMAIS que a consulta falhou. Identificador inexistente ou fora do seu alcance é coisa diferente: ele volta em unavailableIndicatorUids / unavailableProblemSolutionUids, e para esses você NÃO pode afirmar que não há vínculo, porque isso não foi apurado. Os dois casos são indistinguíveis entre si de propósito. Consultando por problemSolutionUids, a solução que existe, que você alcança e que não tem indicador vinculado volta em problemSolutionsWithoutIndicators — essa SIM é ausência de vínculo apurada, e não deve ser confundida com unavailableProblemSolutionUids. ESCOPO: responde por SOLUÇÃO DE PROBLEMAS, e só. Projeto e Ocorrência NÃO aparecem aqui — eles usam outra relação no produto, e nenhuma tela liga indicador a eles por este vínculo. Para os projetos ligados a um indicador não existe tool: diga isso ao usuário em vez de tentar deduzir por project_list. Cada item traz type (sempre ProblemSolution) e o caminho de detalhe é problem_solutions_get_detail. PERÍODO: o vínculo guarda a competência em que foi feito (o mês do desvio), que NÃO é a data de abertura da solução — uma solução aberta em abril pode estar vinculada a março, então openedAtFrom/openedAtTo de problem_solutions_list não respondem esta pergunta. Para recortar use occurrenceFrom/occurrenceTo como INTERVALO (março de 2026 = 2026-03-01 a 2026-03-31). Sem intervalo a tool devolve TODOS os vínculos, que é o comportamento da tela. ATENÇÃO ao ler o período: vínculo com appliesToWholePlan=true é o de plano de metas — vale para o exercício inteiro e não tem competência, por isso aparece mesmo quando você pede um mês. Não o relate como se fosse daquele mês. Se truncated vier true, há mais registros que os listados: totalCount tem o número real.
indicator_list_values
ChatGPTRetorna, em lote, os valores (real, meta, farol, percentual de atingimento) de uma lista de indicadores em um período/frequência — os indicadores retornados por indicator_list. Prefira identificá-los por indicatorUids (o campo uid); indicatorIds, com o id numérico, segue aceito para compatibilidade. Revalida a permissão de cada indicador: os que estiverem fora do que o usuário pode ver são silenciosamente excluídos do resultado. Sem valueType, cada ocorrência vem DUAS vezes — uma com valueType Apurado (valor do período) e outra Acumulado (acumulado até a ocorrência): não são duplicatas, não as some nem as compare entre si; para 'acumulado até uma data' use valueType Acumulado. O farol (color) e o achievementPercentage de cada item JÁ VÊM CALCULADOS pelo sistema, respeitando a polaridade do indicador (melhor para cima, para baixo, faixa) e as tolerâncias: NUNCA RECALCULE nem reinterprete farol ou percentual a partir de real e meta — apresente o que veio. Cada item traz também variance (real − target), variancePercentage e achievementComparable. QUANDO achievementComparable FOR false (meta nula ou menor ou igual a zero), o percentual existe mas não compara nada: NÃO o apresente — mostre real, target e variance no lugar. Ao citar um valor, identifique o indicador pelo indicatorUid (o uid de indicator_list) e pelo indicatorFullName, nunca pelo id numérico.
indicator_measure_unit_list
ChatGPTLista as unidades de medida cadastradas pela empresa no Stratws, com id e nome (ex.: Percentual, Reais, Toneladas, Dias). Chame esta tool quando o usuário citar uma unidade pelo nome e você precisar do identificador dela para filtrar indicadores por unidade de medida em indicator_list, e use o campo id — não o nome, que é traduzível e editável. Não tem parâmetro activeOnly: a unidade de medida não tem marcação de ativo; ela existe ou não existe.
indicator_results_area_list
ChatGPTLista as áreas de resultado da empresa no Stratws, com id e nome (ex.: Financeiro, Clientes, Processos, Pessoas). A área de resultados é o agrupamento temático dos indicadores, cadastrado pelo cliente. Chame esta tool quando o usuário citar uma área pelo nome e você precisar do identificador dela, e use o campo id — não o nome, que é traduzível e editável. Use searchText para achar a área pelo termo que o usuário falou.
indicator_type_list
ChatGPTLista os tipos de indicador cadastrados pela empresa no Stratws, com id, sigla e nome. O tipo é um cadastro do cliente, não uma entidade fixa do sistema: cada empresa registra os seus (ex.: PEX, PPR), e podem ser centenas — por isso a busca por texto e a paginação. Chame esta tool ANTES de indicator_list quando o usuário citar um tipo pelo nome ou pela sigla, e use o id retornado no filtro de indicator_list. Não tente adivinhar o id nem passar a sigla como filtro: a sigla é traduzível, editável pelo cliente e não é única. Não confunda com a natureza do indicador (quantitativo, qualitativo, cronograma), que é um atributo fixo do sistema e tem filtro próprio em indicator_list.
management_plan_list
ChatGPTLista os planos de gestão ativos do tenant do Stratws — use para descobrir o managementPlanId exigido por indicator_list, indicator_list_values e management_unit_list.
management_unit_list
ChatGPTLista as Unidades Gerenciais (UGs) que o usuário atual do Stratws pode ver em um plano de gestão — usuário comum vê só a UG vinculada, administrador vê a hierarquia, super usuário vê todas. Cada UG retornada inclui ParentId, o Guid da UG superior ('Subordinado a' na tela de Configurações > Unidades Gerenciais) — nulo quando a UG é raiz — permitindo reconstruir a árvore hierárquica completa a partir da lista. Por padrão consulta o plano de gestão do ano atual; para anos anteriores, informe managementPlanId explicitamente (ver management_plan_list). Use para descobrir o managementUnitId a passar para indicator_list.
meetings_complete
ChatGPTAntes de chamar, confirme com o usuário: mostre qual 1:1 será concluído (participante, data e horário), avise que depois de concluído o 1:1 não pode ser reaberto nem remarcado, e aguarde o "sim". Marca como concluído um 1:1 que o usuário autenticado organizou — o equivalente a "Concluir" na tela. Só quem organizou (agendou) o 1:1 pode concluí-lo; o outro participante recebe recusa. Os dois participantes são avisados no sistema e por e-mail. Concluir não altera tópicos, anotações, nota privada nem horário. Para registrar o que foi conversado, use meetings_set_topic_notes e meetings_set_private_notes (antes ou depois de concluir). Localize o meetingId com meetings_list.
meetings_create
ChatGPTCria um novo 1:1 com um colaborador em relação hierárquica direta (chefe/subordinado).
meetings_edit
ChatGPTEdita um 1:1 existente — a lista de tópicos enviada substitui totalmente a lista atual.
meetings_get_suggested_topics
ChatGPTConsulta o catálogo GENÉRICO de tópicos de pauta sugeridos pelo Stratws, por papel (líder/liderado) — as mesmas categorias para qualquer usuário, úteis para inspirar uma pauta nova. NÃO é o histórico de um 1:1 específico: para saber o que foi conversado ou combinado num encontro real, use meetings_get_topics.
meetings_get_topics
ChatGPTLê o CONTEÚDO de um 1:1 específico: os tópicos de pauta de cada participante com a anotação registrada em cada um (o que foi efetivamente conversado), mais a nota privada do próprio usuário autenticado. Use esta tool para responder o que foi combinado, tratado ou prometido num 1:1. Obtenha o meetingId por meetings_list. A nota privada de um participante nunca é visível ao outro.
meetings_list
ChatGPTLista, de forma paginada, os 1:1s dos quais o usuário autenticado participa — tanto como liderado (Follower) quanto como líder/organizador de outro colaborador (Leader). Cada item traz OrganizerId/GuestId (quem agendou e quem foi convidado) e LeaderId/FollowerId (a hierarquia) — são eixos diferentes: um liderado pode agendar o 1:1 com o próprio chefe.
meetings_set_private_notes
ChatGPTGrava a nota privada do usuário autenticado num 1:1. PRIVADA: nem o outro participante nem o RH têm acesso — é o caderno pessoal de preparação e impressões. Substitui a nota anterior por inteiro. Para o registro compartilhado do que foi conversado, use meetings_set_topic_notes.
meetings_set_topic_notes
ChatGPTRegistra a anotação dos tópicos do usuário autenticado num 1:1 — o que foi conversado em cada ponto da pauta. NÃO altera data, horário, link nem local. Substitui integralmente a lista de tópicos do usuário: chame meetings_get_topics antes e reenvie os tópicos que devem permanecer, senão eles são removidos. Registre o que a pessoa disse, não um resumo seu — esta anotação é o registro da conversa. Visível ao outro participante.
problem_solutions_create_status_reports
ChatGPTRegistra, em lote, status 3G (Entregas, Pontos de atenção e Próximos passos) em Soluções de Problema, com até 50 itens por chamada. Cada item traz problemSolutionUid, results, attentionPoints, nextActions (texto simples, até 2000 caracteres cada; use quebra de linha para listas, sem sintaxe Markdown) e idempotencyKey: um Guid novo, gerado por você para cada item. Use apenas Guids válidos: um Guid malformado recusa o lote inteiro. Os três textos são obrigatórios: se o usuário não informou algum, não invente nem preencha com valor padrão ("Nenhum", "N/A"); pergunte ao usuário. A escrita exige confirmação: antes de chamar, confirme com o usuário o texto que será gravado e aguarde o "sim". O resultado é por item: alguns itens podem falhar (campo em branco, solução sem acesso) enquanto os demais são gravados; diga ao usuário quais falharam e por quê. Se a chamada falhar sem resposta definitiva (indisponibilidade, tempo esgotado), repita UMA vez, com as MESMAS idempotencyKey: itens já gravados voltam como sucesso, sem duplicar.
problem_solutions_get_detail
ChatGPTConsulta o detalhamento de uma Solução de Problema do Stratws pelo seu identificador Guid, incluindo os campos do formulário (que variam conforme a classificação e o método) e os Planos de Ação vinculados com suas tarefas (actionPlanUids). Use o id retornado por problem_solutions_list, ou problem_solutions_get_detail_by_number quando o usuário informar o número em vez do Guid. IMPORTANTE ao inserir uma tarefa: se actionPlanUids tiver mais de um Guid, pergunte ao usuário em qual plano a tarefa deve entrar antes de chamar tasks_create — NUNCA escolha um por conta própria. Se tiver exatamente um, use-o diretamente sem perguntar. Se estiver vazio, use action_plan_list_available_steps e action_plan_create para criar o primeiro plano.
problem_solutions_get_detail_by_number
ChatGPTConsulta o detalhamento de uma Solução de Problema do Stratws pelo número (com ou sem o ano, ex. "1234" ou "1234/2026"), incluindo os campos do formulário e os Planos de Ação vinculados com suas tarefas. Use quando o usuário identificar a solução pelo número em vez do Guid — não é necessário chamar problem_solutions_list antes só para descobrir o Guid. Quando o número casar com mais de uma solução, a resposta orienta o próximo passo (informar o ano, ou buscar por descrição em problem_solutions_list e usar o id).
problem_solutions_list
ChatGPTLista as Soluções de Problema do Plano de Gestão atual às quais o usuário autenticado tem acesso, de forma paginada, com filtro opcional por unidade gerencial, intervalo de abertura, plano de gestão, busca textual na descrição (searchText) e número.
problem_solutions_list_participating
ChatGPTLista as Soluções de Problema em que o usuário autenticado é participante (em qualquer função), inclusive as de outras unidades gerenciais, de forma paginada, da mais recente para a mais antiga. Use quando o usuário perguntar pelas soluções em que participa, ou quando problem_solutions_list (que só traz as soluções das unidades gerenciais vinculadas ao usuário) não trouxer a que ele procura. Traz as em andamento, concluídas e canceladas do Plano de Gestão atual, ou do informado em managementPlanId. A resposta traz hasMore (há mais soluções depois desta página, e então basta pedir de novo com skip + take) e não traz o total. Cada item abre pelo Guid em problem_solutions_get_detail.
problem_solutions_list_status_reports
ChatGPTLista os status 3G (Entregas, Pontos de atenção e Próximos passos) registrados nas Soluções de Problema informadas, do mais recente para o mais antigo, com autor, data e se o usuário pode editar. Aceita no máximo 50 soluções por chamada. Com onlyLatest verdadeiro devolve apenas o status mais recente de cada solução. Solução sem status volta com statusReports vazio (sucesso). Solução não encontrada ou sem acesso volta em unavailableProblemSolutionUids, e os dois casos são indistinguíveis de propósito: não afirme nada sobre ela. Apresente Entregas, Pontos de atenção e Próximos passos exatamente como gravados; se resumir ou reescrever algum, diga ao usuário que resumiu.
project_get
ChatGPTConsulta um Projeto do Stratws pelo identificador (Guid) OU pelo número, e devolve — além dos dados do projeto — o identificador do cronograma em scheduleUid, todos os planos de ação em actionPlanUids (essa lista JÁ INCLUI o scheduleUid, quando existir — não são conjuntos separados), as seções dinâmicas do formulário do projeto (sections — variam conforme classificação e método, igual ao OnePage) e os participantes (participants, só presente quando o método configura exibição de participantes). PARA VER TAREFAS (tasks_list): se o usuário pedir "as tarefas do projeto" de forma genérica, use scheduleUid (é onde elas normalmente ficam); use a lista completa de actionPlanUids quando ele quiser tudo, de todos os planos. PARA CRIAR UMA TAREFA (tasks_create): NUNCA infira que é no cronograma. Trate actionPlanUids como o conjunto completo de destinos possíveis (o cronograma é só mais um item dessa lista, sem prioridade sobre os demais). Se actionPlanUids tiver mais de um Guid, pergunte ao usuário em qual plano a tarefa deve entrar antes de chamar tasks_create — inclusive quando um deles é o cronograma. Só prossiga sem perguntar quando actionPlanUids tiver exatamente um Guid. scheduleUid vem nulo quando o projeto ainda não tem cronograma, o que é normal em fase inicial — nesse caso informe que não há cronograma em vez de tratar como erro. Para criar um plano novo (fora dos que já existem em actionPlanUids), use action_plan_list_available_steps e action_plan_create. Informe projectId OU projectNumber, nunca os dois. Prefira o número quando o usuário disser algo como "o projeto 1234/2026". ATENÇÃO: o número não é garantidamente único, nem dentro do mesmo ano — quando houver mais de uma correspondência a resposta orienta o próximo passo; siga a orientação ou pergunte ao usuário, nunca escolha um por conta própria.
project_list
ChatGPTLista os Projetos do Stratws que o usuário pode ver, com busca opcional por descrição e filtro opcional por unidade gerencial. Cada projeto vem com a fase do workflow, a unidade gerencial, o líder e — o dado mais útil para avaliar execução — o percentual previsto contra o realizado. Use esta tool para BUSCAR ou NAVEGAR pelo portfólio (por nome/descrição, ou por unidade) — não para resolver um número específico: quando o usuário já der o NÚMERO de um projeto (ex.: "o projeto 1234/2026"), chame project_get diretamente. O número de um Projeto é definido por unidade gerencial/empresa/ano, nunca por plano de gestão, então repetir esta lista variando managementPlanId não é uma forma confiável de achá-lo — project_get já resolve isso corretamente (um resultado, "não encontrado", ou orientação de desambiguação quando o número não é único). Depois de identificar o projeto, o caminho para tarefas é project_get (que devolve o identificador do cronograma), depois tasks_list. Prefira este caminho a action_plan_list quando a pergunta partir do projeto, porque action_plan_list só encontra planos em que o próprio usuário tem tarefa — e quem gerencia um projeto normalmente não tem nenhuma. O campo hasSchedule diz se vale seguir para as tarefas: projeto em fase inicial pode ainda não ter cronograma. Para percorrer tudo, chamar repetidamente incrementando skip até esgotar totalCount.
project_list_change_requests
ChatGPTLista as requisições de mudança de um ou vários projetos do Stratws, até 30 projetos por chamada, com os campos do formulário: número, descrição, tipos (Escopo, Prazo, Custo), requisitante, elaborador, motivo, impacto no custo, no prazo e nos riscos, prós, contras, datas e a etapa do workflow (stage). Os projectIds vêm da project_list; para uma visão do portfólio, passe todos os ids da página de uma vez. Projeto sem requisições vem com lista vazia; projeto inexistente ou que o usuário não vê vem em unavailableProjectIds, e sobre ele nada deve ser afirmado.
project_list_costs
ChatGPTLista os custos de um ou vários projetos do Stratws, até 30 projetos por chamada, como a tela Custos do projeto os mostra. Acompanhamento financeiro: despesa e investimento orçados e realizados, no total do projeto (total) e por ano (years); variance é o orçado menos realizado — positiva ficou abaixo do orçado, negativa estourou. Os meses de cada ano só vêm com includeMonths=true: use-o apenas quando o usuário perguntar por mês. Memória de cálculo: as estimativas por ano (calculationMemory), com tipo de custo (Despesa ou Investimento), descrição, fornecedor e valor, e o total estimado (estimatedTotal). Os projectIds vêm da project_list; para os custos do portfólio, passe todos os ids da página de uma vez em vez de chamar projeto por projeto. hasCosts=false significa projeto sem custos cadastrados, não erro. Projeto inexistente ou que o usuário não vê vem em unavailableProjectIds; projeto que o usuário vê mas cujos custos não tem permissão de ver vem em costsRestrictedProjectIds. Sobre esses dois, nenhum valor deve ser afirmado: diga ao usuário que não há acesso aos custos daquele projeto.
project_list_deliveries
ChatGPTLista as entregas de um ou vários projetos do Stratws, até 30 projetos por chamada. Entregas são os produtos que o projeto se compromete a entregar, com critério de aceite e responsáveis pelo aceite — não são as tarefas do cronograma: cada entrega aponta para a tarefa vinculada em taskId, e a data da entrega (plannedFinish) e o responsável (taskResponsibles) vêm dessa tarefa. status é EmAberto, EmAprovacao, Aprovado ou Reprovado. Os projectIds vêm da project_list; para uma visão do portfólio, passe todos os ids da página de uma vez em vez de chamar projeto por projeto. Projeto sem entregas vem com lista vazia; projeto inexistente ou que o usuário não vê vem em unavailableProjectIds, e sobre ele nada deve ser afirmado.
project_list_risks
ChatGPTLista os riscos de um ou vários projetos do Stratws, até 30 projetos por chamada: descrição, probabilidade e impacto (1 a 3), a avaliação já calculada pela matriz (assessment: MuitoBaixa a MuitoAlta — não recalcule), a resposta ao risco (status), contramedida, responsável e se o risco já ocorreu. Os projectIds vêm da project_list; para uma visão do portfólio, passe todos os ids da página de uma vez. Projeto sem riscos vem com lista vazia; projeto inexistente ou que o usuário não vê vem em unavailableProjectIds, e sobre ele nada deve ser afirmado.
report_chart_add_indicator
ChatGPTAcrescenta um indicador a um componente Gráfico de um relatório do Gestão à Vista e devolve o chartItemId do item criado, o gráfico (data) e o link de acesso direto à tela do relatório. Cadeia sem pedir identificador ao usuário: indicator_list (o uid do indicador, pelo nome) → report_chart_list_models (o modelUid, apresentado pelo nome) → no modelo Waterfall (Cascata), que exige desdobramento, indicator_list_drilldowns → esta tool. O desdobramento vai por drillDownType e pelo identificador que o tipo exige: PorItens com o drillDownUid de um desdobramento PorItens ou PorCesta; Formula com o drillDownUid de um desdobramento Formula; Dimensoes com o dimensionOrder, só nos indicadores cujo indicator_list_drilldowns lista Dimensoes; Hierarquico sem identificador. A escrita exige confirmação: mostre o indicador, o modelo e o desdobramento pelos nomes e aguarde o "sim". A tool NÃO é idempotente: repetida, acrescenta outro item; se a chamada falhar sem resposta, confira o gráfico com report_component_get antes de repetir. Depois de acrescentar, devolva o link ao usuário. O usuário precisa poder editar o relatório e usar o indicador.
report_chart_list_models
ChatGPTLista os modelos de gráfico que servem para um indicador numa frequência, pelo mesmo filtro da tela: modelUid, name (como a tela mostra), type (Evolucao, Comparativo ou Waterfall, que a tela chama de Cascata) e requiresDrillDown (true no Waterfall, que exige um desdobramento). Use antes de report_chart_add_indicator e apresente os modelos ao usuário pelo nome; se houver mais de um, pergunte qual usar ou diga qual escolheu. Nunca peça o modelUid ao usuário. Obtenha o indicatorUid em indicator_list. Esta tool só consulta.
report_chart_remove_indicator
ChatGPTRemove um indicador de um componente Gráfico de um relatório do Gestão à Vista. A remoção é IRREVERSÍVEL: depois dela não há como recuperar o indicador no gráfico nem a configuração dele ali. Os demais indicadores seguem na mesma ordem relativa. Por isso a tool exige DUAS confirmações, impostas pelo servidor, em duas chamadas. 1) Chame sem confirmationToken: nada é removido, e a resposta traz executed=false e confirmation (summary, confirmationToken e expiresAt, este em UTC). Apresente ao usuário o indicador pelo nome e a posição dele no gráfico, como o summary diz, avise que não pode ser desfeito, peça a confirmação explícita dele e aguarde o "sim". 2) Só depois chame de novo com o MESMO reportUid, o MESMO componentId, o MESMO chartItemId e confirmationToken igual ao confirmation.confirmationToken recebido (vale 5 minutos, só para esse indicador desse gráfico e esse usuário; o código de outro indicador do mesmo gráfico é recusado, e também o deste chartItemId se ele passar a ser de outro indicador entre as duas chamadas); a resposta traz executed=true. As duas respostas trazem o link de acesso direto à tela do relatório, que continua existindo; devolva-o ao usuário. O usuário precisa poder editar o relatório. Obtenha o reportUid em report_list, o componentId em report_component_list e o chartItemId em data.indicators de report_component_get e apresente o indicador pelo nome (indicatorName).
report_chart_reorder_indicators
ChatGPTReordena os indicadores de um componente Gráfico de um relatório do Gestão à Vista. Informe a lista COMPLETA de chartItemId, na ordem nova: a API recusa uma lista que não tenha exatamente os itens do gráfico, sem repetição. Leia os itens em report_component_get antes. Devolve o gráfico (data) e o link de acesso direto à tela do relatório. A escrita exige confirmação: mostre a ordem atual e a nova pelos nomes dos indicadores e aguarde o "sim". A tool é idempotente: repetir com a mesma lista não muda nada. Depois de reordenar, devolva o link ao usuário. O usuário precisa poder editar o relatório.
report_chart_resize
ChatGPTAltera o tamanho de um componente Gráfico de um relatório do Gestão à Vista: Normal ou Large (ocupa mais espaço na tela). Os indicadores do gráfico não mudam. Devolve o gráfico (data) e o link de acesso direto à tela do relatório. A escrita exige confirmação: mostre o tamanho atual (data.size de report_component_get) e o novo e aguarde o "sim". A tool é idempotente: repetir com o mesmo tamanho não muda nada. Depois de alterar, devolva o link ao usuário. O usuário precisa poder editar o relatório.
report_component_add
ChatGPTAdiciona um componente HTML a um relatório do Gestão à Vista e devolve id, position, type e data do componente criado, além do link de acesso direto à tela do relatório. Nesta versão a tool só cria componentes do tipo Html; Card, Chart e Content ainda não podem ser criados por ela. O documento vem de uma de três formas, e só uma: html (o texto, para o que você escreve na conversa), htmlFile (o arquivo anexado à conversa, no ChatGPT) ou htmlUploadId (o arquivo enviado pelo link de report_component_html_upload_link). Documento que já existe em arquivo vai por htmlFile ou htmlUploadId, nunca reescrito em html: assim ele chega igual ao arquivo. O limite é 5 MB: acima disso a recusa informa o tamanho e o limite. O heightMode é Auto (altura automática) ou Fixed (altura fixa; exige height em pixels). Com position (inteiro, 0 ou maior) o componente entra naquela posição; omitida, ele vai para o fim do relatório. A escrita exige confirmação: antes de chamar, mostre ao usuário o que será adicionado (modo de altura e posição) e aguarde o "sim" dele. Depois de adicionar, devolva o link ao usuário. A tool é idempotente: repetir a chamada com a mesma idempotencyKey devolve o mesmo componente em vez de criar outro. Gere um Guid seu e informe-o em idempotencyKey; se a chamada falhar sem resposta definitiva (indisponibilidade, tempo esgotado, erro do servidor), repita UMA vez, por conta própria, com o MESMO valor, nunca com outro, antes de informar o usuário; assim não duplica o componente. Se omitida, o servidor gera uma chave e a informa na mensagem de erro dessas falhas. O usuário precisa poder editar o relatório. Obtenha o reportUid em report_list; para trocar o HTML de um componente já existente use report_component_replace_html.
report_component_get
ChatGPTConsulta um componente de um relatório do Gestão à Vista pelo reportUid e pelo componentId (ambos Guid) e devolve id, position (ordem no relatório), type e data. type pode ser Html, Card, Chart, Content, Table, IFrame, Image, News ou Text, e o formato de data varia conforme o type (Text vem sem data). A resposta traz o link de acesso direto à tela do relatório (não ao componente). Num componente Html, data.summary traz o título e os primeiros títulos do documento (ou o começo do texto, se ele não tiver títulos): use-o para achar o bloco que o usuário cita pelo assunto, sem perguntar a posição. Obtenha o reportUid em report_list e o componentId em report_component_list. O componente precisa pertencer ao relatório informado. Esta tool só consulta; para alterar o componente use as tools de escrita de componente.
report_component_get_html
ChatGPTLê o documento HTML de um componente Html de um relatório do Gestão à Vista, para corrigir só um trecho dele (um número, uma frase) sem reescrever o resto. Devolve componentId, sizeBytes, o link de acesso direto à tela do relatório e o documento, exatamente como foi publicado, de uma de duas formas. Até 30 KB, o documento vem em html: corrija o trecho e chame report_component_replace_html com o html inteiro corrigido. Acima de 30 KB, html vem null e download traz um link de uso único (url, secret e expiresAt, 10 minutos) e o command pronto, com o header X-Download-Secret: baixe o arquivo no seu ambiente de execução de código e troque o trecho com um comando (por exemplo, sed ou um script), sem ler nem escrever o arquivo inteiro na conversa; depois peça um link em report_component_html_upload_link, envie o arquivo editado e chame report_component_replace_html com o htmlUploadId. Antes de substituir, mostre ao usuário o trecho que muda e aguarde o "sim" dele. Não mostre o secret nem o command a outras pessoas. Obtenha o reportUid em report_list e o componentId em report_component_list. Esta tool só consulta.
report_component_html_upload_link
ChatGPTCria um link de envio de uso único para publicar no Gestão à Vista um documento HTML que já existe como arquivo no seu ambiente de execução de código, sem reescrevê-lo na conversa. Use quando o documento é grande ou foi gerado por script e você consegue executar comandos. Passos: 1) chame esta tool; 2) envie o arquivo com o command devolvido, trocando <caminho-do-arquivo.html> pelo caminho do arquivo; o envio é um PUT do conteúdo bruto no uploadUrl com o header X-Upload-Secret igual ao uploadSecret, e a resposta confirma o tamanho recebido; 3) chame report_component_add ou report_component_replace_html com o htmlUploadId e sem html. O link vale 10 minutos e aceita um único arquivo HTML em UTF-8 de até 5 MB, e só o mesmo usuário publica o que foi enviado; não mostre o uploadSecret nem o comando a outras pessoas. Esta tool não grava nada no Stratws: a confirmação do usuário vem antes da tool que publica. No ChatGPT, com o arquivo anexado à conversa, use htmlFile em vez desta tool.
report_component_list
ChatGPTLista os componentes de um relatório do Gestão à Vista pelo reportUid (Guid), na ordem em que aparecem no relatório (position). Cada componente traz o id (Guid, o identificador usado em report_component_get e nas demais tools de componente), position, type e data. A lista traz somente os componentes de topo do relatório: itens aninhados, como os textos dentro de um Content, não aparecem nesta lista. type pode ser Html, Card, Chart, Content, Table, IFrame, Image, News ou Text, e o formato de data varia conforme o type (Text é um texto solto no relatório, montado na tela, e vem sem data). Os tipos Table, IFrame, Image, News e Text podem ser listados, movidos e removidos, mas não podem ser criados nem editados por estas tools. A resposta traz o link de acesso direto à tela do relatório (não ao componente). Num componente Html, data.summary traz o título e os primeiros títulos do documento (ou o começo do texto, se ele não tiver títulos): use-o para achar o bloco que o usuário cita pelo assunto, sem perguntar a posição. Obtenha o reportUid em report_list. Esta tool só consulta; para alterar os componentes use as tools de escrita de componente.
report_component_move
ChatGPTMove um componente de um relatório do Gestão à Vista para outra posição e devolve id, a position nova, type e data do componente, além do link de acesso direto à tela do relatório. A position conta a partir de 0, a mesma numeração do campo position que report_component_list devolve: 0 é o primeiro componente, 1 é o segundo, e assim por diante. Para colocar o componente na 2ª posição, informe position=1; para colocá-lo em primeiro, position=0. Se o usuário falar em ordinais (1ª, 2ª, 3ª), subtraia 1. Uma position maior que a última vale como a última posição, e a resposta traz a position em que o componente de fato ficou. Os demais componentes mudam de posição para acomodar o movimento. Só move componentes de topo do relatório; funciona com qualquer type. A escrita exige confirmação: antes de chamar, diga ao usuário qual componente vai mudar de posição e para qual, e aguarde o "sim" dele. Depois de mover, devolva o link ao usuário. A tool é idempotente: repetir a chamada com a mesma position deixa o componente no mesmo lugar. O usuário precisa poder editar o relatório. Obtenha o reportUid em report_list e o componentId (com a position atual) em report_component_list.
report_component_remove
ChatGPTRemove um componente de um relatório do Gestão à Vista. A remoção é IRREVERSÍVEL: depois dela não há como recuperar o componente nem o que ele continha. Os demais componentes seguem na mesma ordem relativa. Por isso a tool exige DUAS confirmações, impostas pelo servidor, em duas chamadas. 1) Chame sem confirmationToken: nada é removido, e a resposta traz executed=false e confirmation (summary, confirmationToken e expiresAt, este em UTC). Apresente o componente ao usuário (a ordem contada do topo, 1º, 2º..., o tipo e o que ele mostra, lidos em report_component_list ou report_component_get), avise que não pode ser desfeito, peça a confirmação explícita dele e aguarde o "sim". 2) Só depois chame de novo com o MESMO reportUid, o MESMO componentId e confirmationToken igual ao confirmation.confirmationToken recebido (vale 5 minutos, só para esse componente e esse usuário); a resposta traz executed=true. As duas respostas trazem o link de acesso direto à tela do relatório, que continua existindo; devolva-o ao usuário. O usuário precisa poder editar o relatório. Obtenha o reportUid em report_list e o componentId em report_component_list.
report_component_replace_card
ChatGPTSubstitui a lista INTEIRA de indicadores de um componente Card de um relatório do Gestão à Vista e devolve id, position, type e data do card, além do link de acesso direto à tela do relatório. Um indicador que não for reenviado sai do card. Por isso, antes de chamar, leia o card com report_component_get. A escrita exige confirmação: antes de chamar, mostre ao usuário a lista nova pelos nomes dos indicadores, diga o que sai e o que entra, e aguarde o "sim" dele. Para manter um indicador, reenvie-o com os mesmos valores que a leitura devolveu (frequency, valueType, delay, showDate, name); o indicatorUid de cada item é o IndicatorId que a leitura devolve. Obtenha o uid de cada indicador novo em indicator_list. Só funciona em componentes do tipo Card. Depois de substituir, devolva o link ao usuário. A tool é idempotente: repetir a chamada com a mesma lista não muda nada. O usuário precisa poder editar o relatório. Obtenha o reportUid em report_list e o componentId em report_component_list.
report_component_replace_html
ChatGPTSubstitui o documento HTML e o modo de altura de um componente HTML já existente de um relatório do Gestão à Vista e devolve id, position, type e data do componente atualizado, além do link de acesso direto à tela do relatório. O componente mantém a mesma posição e o link do relatório continua o mesmo. O documento vem de uma de três formas, e só uma: html (o texto, para o que você escreve na conversa), htmlFile (o arquivo anexado à conversa, no ChatGPT) ou htmlUploadId (o arquivo enviado pelo link de report_component_html_upload_link). Documento que já existe em arquivo vai por htmlFile ou htmlUploadId, nunca reescrito em html: assim ele chega igual ao arquivo. O limite é 5 MB: acima disso a recusa informa o tamanho e o limite. O heightMode é Auto (altura automática) ou Fixed (altura fixa; exige height em pixels). Só funciona em componentes do tipo Html. A escrita exige confirmação: antes de chamar, mostre ao usuário o que será substituído e aguarde o "sim" dele. Depois de substituir, devolva o link ao usuário. A tool é idempotente: repetir a chamada com o mesmo conteúdo não muda nada. O usuário precisa poder editar o relatório. Obtenha o reportUid em report_list e o componentId em report_component_list. Para criar um componente novo use report_component_add.
report_content_add_text
ChatGPTAdiciona um texto a uma versão de um componente Conteúdo de um relatório do Gestão à Vista, na raiz ou como subtexto de outro (parentId), e devolve o texto criado e o link de acesso direto à tela do relatório. Antes de escrever, pergunte ao usuário se o texto vai na versão atual (isCurrent em report_content_list_versions) ou numa versão nova (crie-a com report_content_create_version); nunca escolha a versão sozinho. Com position (inteiro, 0 ou maior) o texto entra naquela posição entre os irmãos; omitida, vai para o fim. A escrita exige confirmação: mostre o texto, a versão e onde ele entra, e aguarde o "sim". Depois de adicionar, devolva o link ao usuário. A tool é idempotente: repetir com a mesma idempotencyKey devolve o mesmo texto. Gere um Guid seu e informe-o em idempotencyKey; se a chamada falhar sem resposta definitiva, repita UMA vez com o MESMO valor, nunca com outro. O usuário precisa poder editar o relatório. Obtenha o versionId em report_content_list_versions e o parentId em report_content_list_texts.
report_content_create_version
ChatGPTCria uma versão nova num componente Conteúdo de um relatório do Gestão à Vista e devolve a versão (id, description, date, isCurrent) e o link de acesso direto à tela do relatório. A versão nova herda os textos da anterior, como na tela. Use só quando o usuário escolher escrever numa versão nova: antes, pergunte se o texto vai na versão atual ou numa nova, e pergunte a data da versão nova. Só uma versão por data. A escrita exige confirmação: mostre a descrição e a data e aguarde o "sim". Depois de criar, devolva o link ao usuário. A tool é idempotente: repetir com a mesma idempotencyKey devolve a mesma versão. Gere um Guid seu e informe-o em idempotencyKey; se a chamada falhar sem resposta definitiva, repita UMA vez com o MESMO valor, nunca com outro. O usuário precisa poder editar o relatório. Obtenha o reportUid em report_list e o componentId (type Content) em report_component_list.
report_content_list_texts
ChatGPTLista os textos de uma versão de um componente Conteúdo de um relatório do Gestão à Vista, em ordem de leitura (o pai antes dos subtextos), com id, parentId (o texto pai; nulo na raiz), position (entre os irmãos, de 0), text, style, fontSize e highlighted, além do link de acesso direto à tela do relatório. Use para achar o itemId do texto que o usuário cita pelo assunto antes de editar ou remover, e para mostrar o que a versão já tem antes de escrever. O usuário precisa poder visualizar o relatório. Obtenha o versionId em report_content_list_versions. Esta tool só consulta.
report_content_list_versions
ChatGPTLista as versões de um componente Conteúdo de um relatório do Gestão à Vista: id, description, date e isCurrent (a versão que a tela mostra hoje), além do link de acesso direto à tela do relatório. Use antes de ler ou escrever textos: toda tool de texto recebe o versionId, e nenhuma escolhe a versão sozinha. Um Conteúdo criado por report_component_add já nasce com uma versão atual; lista vazia só ocorre em Conteúdo antigo, e aí crie uma com report_content_create_version antes do primeiro texto. O usuário precisa poder visualizar o relatório. Obtenha o reportUid em report_list e o componentId (type Content) em report_component_list. Esta tool só consulta.
report_content_remove_text
ChatGPTRemove um texto de uma versão de um componente Conteúdo de um relatório do Gestão à Vista. A remoção é IRREVERSÍVEL: depois dela não há como recuperar o texto. Os subtextos do texto removido NÃO são apagados: sobem para o lugar dele, na mesma ordem; o summary diz quantos. Por isso a tool exige DUAS confirmações, impostas pelo servidor, em duas chamadas. 1) Chame sem confirmationToken: nada é removido, e a resposta traz executed=false e confirmation (summary, confirmationToken e expiresAt, este em UTC). Apresente ao usuário a versão, o começo do texto e o que acontece com os subtextos, avise que não pode ser desfeito, peça a confirmação explícita dele e aguarde o "sim". 2) Só depois chame de novo com o MESMO reportUid, o MESMO componentId, o MESMO versionId, o MESMO itemId e confirmationToken igual ao confirmation.confirmationToken recebido (vale 5 minutos, só para esse texto dessa versão e esse usuário); a resposta traz executed=true. As duas respostas trazem o link de acesso direto à tela do relatório; devolva-o ao usuário. O usuário precisa poder editar o relatório. Obtenha o reportUid em report_list, o componentId em report_component_list, o versionId em report_content_list_versions e o itemId em report_content_list_texts.
report_create
ChatGPTCria um relatório do Gestão à Vista em uma unidade gerencial, com compartilhamento opcional, e devolve o uid, o nome, a unidade, se é público e o link de acesso direto à tela. A escrita exige confirmação: antes de chamar, mostre ao usuário o que será criado (nome, unidade gerencial e compartilhamento) e aguarde o "sim" dele. Depois de criar, devolva o link ao usuário. A tool é idempotente: repetir a chamada com a mesma idempotencyKey devolve o mesmo relatório em vez de criar outro. Gere um Guid seu e informe-o em idempotencyKey; se a criação falhar sem resposta definitiva (indisponibilidade, tempo esgotado, erro do servidor), repita UMA vez, por conta própria, com o MESMO valor, nunca com outro, antes de informar o usuário; assim não duplica o relatório. Se omitida, o servidor gera uma chave e a informa na mensagem de erro dessas falhas. O usuário precisa ter permissão de criação na unidade gerencial. O relatório sempre fica visível para a unidade gerencial dona: sem sharing, para todos os usuários dela; o sharing acrescenta outras unidades e usuários, mas não tira a unidade dona. isPublic=false quer dizer só que o relatório não é público para a empresa inteira, e não que apenas o usuário o vê: ao confirmar e ao relatar o resultado, diga quem passa a enxergar. Para publicar conteúdo no relatório criado, use as tools de componente.
report_delete
ChatGPTExclui um relatório do Gestão à Vista de vez. A exclusão é IRREVERSÍVEL: depois dela não há como recuperar o relatório nem os seus componentes. Por isso a tool exige DUAS confirmações, impostas pelo servidor, em duas chamadas. 1) Chame sem confirmationToken: nada é excluído, e a resposta traz executed=false e confirmation (summary, confirmationToken e expiresAt, este em UTC). Apresente o summary ao usuário (o relatório pelo NOME e quantos componentes tem), avise que não pode ser desfeito, peça a confirmação explícita dele e aguarde o "sim". 2) Só depois chame de novo com o MESMO reportUid e confirmationToken igual ao confirmation.confirmationToken recebido (vale 5 minutos, só para esse relatório e esse usuário); a resposta traz executed=true. O relatório padrão da unidade e o relatório ligado a um menu não podem ser excluídos: a resposta explica o motivo. O usuário precisa poder editar o relatório. A tool nunca devolve link, porque o relatório deixa de existir. Obtenha o reportUid em report_list.
report_get
ChatGPTConsulta um relatório do Gestão à Vista pelo reportUid (Guid) e devolve o nome, a unidade gerencial, o compartilhamento (sharing: público, unidades e usuários específicos) e os componentes do relatório em ordem de posição (components: id, position, type e data com os dados do tipo), além do link de acesso direto à tela. Num componente Html, data.summary traz o título e os primeiros títulos do documento (ou o começo do texto, se ele não tiver títulos): use-o para achar o bloco que o usuário cita pelo assunto, sem perguntar a posição. Obtenha o reportUid em report_list. Esta tool só consulta; para alterar use as tools de escrita de relatório.
report_get_link
ChatGPTDevolve o link de acesso direto à tela de um relatório do Gestão à Vista a partir do reportUid (Guid), sem consultar a API. Obtenha o reportUid em report_list. Ao abrir o link, a tela aplica a permissão do próprio usuário: quem não pode ver o relatório não consegue abri-lo. Esta tool só monta o link e não altera nada.
report_list
ChatGPTLista os relatórios do Gestão à Vista que o usuário pode ver, com busca opcional por nome. Cada relatório traz o uid (Guid, o identificador usado em report_get e nas demais tools), o nome, a unidade gerencial dona, se é público e o link de acesso direto à tela do relatório. returnedCount é a quantidade de relatórios DESTA página; a API não informa o total geral, e returnedCount nunca deve ser lido como total. Para percorrer tudo, chame de novo incrementando skip até uma página trazer menos itens que take. Esta tool só consulta. Para criar e publicar um relatório use report_create.
report_rename
ChatGPTRenomeia um relatório do Gestão à Vista e devolve o uid, o novo nome, a unidade, se é público e o link de acesso direto à tela. A escrita exige confirmação: antes de chamar, mostre ao usuário o nome atual e o novo e aguarde o "sim" dele. Depois de renomear, devolva o link ao usuário. A tool é idempotente: repetir a chamada com o mesmo nome não muda nada. O usuário precisa poder editar o relatório. Obtenha o reportUid em report_list.
report_update_sharing
ChatGPTAltera quem pode acessar um relatório do Gestão à Vista (público, unidades gerenciais e usuários específicos) e devolve o sharing resultante e o link de acesso direto à tela. O compartilhamento enviado substitui o atual por inteiro: o que não for enviado deixa de ser compartilhado, exceto a unidade gerencial dona do relatório, que nunca perde o acesso, mesmo fora de units. Para só acrescentar ou retirar alguém, leia o atual em report_get (sharing) e reenvie a lista completa com a alteração. Como muda quem acessa o relatório, a tool exige DUAS confirmações, impostas pelo servidor, em duas chamadas. 1) Chame sem confirmationToken: nada é alterado, e a resposta traz executed=false e confirmation (summary, confirmationToken e expiresAt, este em UTC). Apresente o summary ao usuário (como está hoje e como ficará, com UGs e usuários pelo NOME, e quem perde o acesso), peça a confirmação explícita dele e aguarde o "sim". 2) Só depois chame de novo com o MESMO reportUid, o MESMO sharing e confirmationToken igual ao confirmation.confirmationToken recebido (vale 5 minutos, só para esse relatório, esse compartilhamento e esse usuário); a resposta traz executed=true. Valores numéricos: shareWith 0 = todos os usuários da UG, 1 = responsável pela UG, 2 = usuários específicos; access 0 = não visível, 1 = visualizar, 2 = editar. O usuário precisa poder editar o relatório. Obtenha o reportUid em report_list, as UGs em management_unit_list e os usuários (userId) em users_list.
results_program_get_apurated_panels
ChatGPTDetalhe de notas, blocos e indicadores de uma janela já APURADA de um Programa de Resultados (RV) — o que o gestor vê ao abrir o painel de RV de um subordinado. USE SEMPRE 'results_program_list_apurations' PRIMEIRO: é lá que se descobre resultsProgramId, startDate e finishDate da janela apurada que você quer detalhar. Retorna só os titulares (usuários ou Unidades Gerenciais) que o usuário atual pode ver — nunca mais do que ele já veria no produto; um gestor comum recebe seus subordinados (árvore completa, não só diretos). Cada painel traz panelScore (decimal, para ordenar/comparar) e panelScoreFormatted (texto com a máscara do programa — use este ao responder ao usuário, nunca reformate o decimal por conta própria). Bloco sem nota (score nulo) significa que o programa não exibe nota numérica de bloco — não é ausência de dado. Gatilhos aparecem como um bloco chamado 'Gatilhos'. Se a mesma janela foi apurada mais de uma vez, usa automaticamente a execução mais recente; só falha pedindo apurationDate no caso raro em que nem isso resolve a ambiguidade com segurança. Nunca dispara apuração nem recalcula nota: lê só o que já está materializado. NOMENCLATURA e FORMATAÇÃO dos números são idênticas à tela, nunca use os termos internos do domínio nem invente símbolo: real e meta (indicador e bloco) usam esses mesmos nomes na tela — nunca chame de 'referência'/'resultado' ou 'actual'/'target' ao responder ao usuário. Ambos são grandezas cruas — mostre com separador de milhar e 2 casas decimais, SEM '%', mesmo que o indicador meça algo em percentual (o '(%)' no nome do indicador é a unidade de medida, não instrução de formatação). Só performanceAccumulatedValue e performanceValue (bloco) são percentuais de atingimento — esses sim multiplique por 100 e mostre com '%'.
results_program_list
ChatGPTLista os Programas de Resultados (Remuneração Variável) de um plano de gestão que o usuário pode acessar — use para descobrir o resultsProgramId exigido por results_program_list_panels. Retorna apenas programas do novo modelo de painéis, com o tipo (usuário ou unidade gerencial) e os donos contratados.
results_program_list_apurations
ChatGPTLista os Programas de Resultados (RV) que o usuário atual acessa em um ano, com os períodos que já foram APURADOS em cada um. Use como PRIMEIRO passo para responder qualquer pergunta sobre NOTAS ou RESULTADOS de apuração: é aqui que se descobre o programa e o período a consultar. ATENÇÃO — não confunda com results_program_list_panels, que lista a CONFIGURAÇÃO dos painéis (período contratado, blocos, pesos e quais indicadores compõem cada bloco) e NÃO retorna nota nenhuma: use aquela para saber o que foi combinado, e esta linha de tools para saber quanto a pessoa tirou. Retorna apenas os programas que o usuário já acessa no Stratws — não concede visibilidade adicional. Cada programa traz holderType ('User' ou 'ManagementUnit'), indicando se o titular do painel é uma pessoa ou uma Unidade Gerencial. A lista de apurações vazia significa que o programa existe e é acessível mas ainda NÃO foi apurado — nesse caso informe que a apuração precisa ser executada por um administrador no produto, e não tente apurar. Esta tool nunca executa apuração.
results_program_list_panels
ChatGPTLista os painéis de um Programa de Resultados, com o período contratado, os blocos e seus pesos, e os itens (indicadores/objetivos/metas) de cada bloco com seus pesos — use para saber o que já existe antes de criar ou alterar painéis em massa. Cada item traz o id do KPI (kpiId, e kpiLegacyId numérico no caso de indicador corporativo) e o nome (kpiName); o indicador corporativo traz também a unidade gerencial e o tipo cadastrado. Atenção aos dois ids distintos: o de cada painel (Panels[].Id) e o de cada contratação (Panels[].Contracts[].Id) — é o da contratação que alimenta contractIds em results_program_panel_bulk_add_block; passar o id do painel ali resulta em 'contratação não encontrada'.
results_program_panel_bulk_add_block
ChatGPTInsere UM bloco (com seus indicadores) em várias contratações já existentes de um mesmo Programa de Resultados numa única chamada. A operação não é transacional: a resposta traz o resultado por contratação, com o motivo de cada recusa; relate ao usuário quais receberam o bloco e quais não. Máximo de 200 contratações por chamada.
results_program_panel_bulk_add_indicator
ChatGPTVincula VÁRIOS indicadores corporativos a blocos já existentes numa única chamada — create-only: um indicador já vinculado ao bloco falha o item (use results_program_panel_bulk_update_indicator_weight para atualizar o peso). A operação não é transacional: a resposta traz o resultado por item, com o motivo de cada recusa. Máximo de 200 itens por chamada.
results_program_panel_bulk_create
ChatGPTCria painéis em massa (contratação, e opcionalmente blocos e indicadores) para vários alvos (usuários ou unidades gerenciais) de um mesmo Programa de Resultados, todos com o mesmo período de contrato. Um evaluatedId que já tem painel neste programa falha só para aquele alvo — a operação não é transacional: a resposta traz o resultado por alvo, com o motivo de cada recusa; relate ao usuário quais foram criados e quais não. Máximo de 200 alvos por chamada. Só funciona para Programas de Resultados SEM uma State Machine configurada — se o programa informado tiver uma, a chamada inteira é rejeitada com uma mensagem de erro clara (nenhum painel é criado); nesse caso, informe ao usuário que a criação em massa não está disponível para esse programa e que os painéis precisam ser criados pela tela. Cada alvo criado com sucesso devolve DOIS ids distintos: PanelId (o painel, usado em results_program_list_panels) e ContractId (a contratação) — é o ContractId que alimenta contractIds em results_program_panel_bulk_add_block; passar o PanelId ali resulta em 'contratação não encontrada'.
results_program_panel_bulk_swap_indicator
ChatGPTTroca o indicador vinculado a VÁRIOS blocos numa única chamada: remove o indicador atual e vincula o novo no lugar, mantendo o peso já configurado no bloco. A operação não é transacional: a resposta traz o resultado por item, com o motivo de cada recusa. Máximo de 200 itens por chamada.
results_program_panel_bulk_update_block
ChatGPTAltera nome e/ou peso de VÁRIOS blocos já existentes numa única chamada. Campo omitido em um item não é alterado. A operação não é transacional: a resposta traz o resultado por item, com o motivo de cada recusa; relate ao usuário quais foram alterados e quais não. Máximo de 200 itens por chamada. Reenviar o mesmo lote é seguro: reaplica os mesmos valores sem criar histórico novo.
results_program_panel_bulk_update_contract
ChatGPTAltera a data de início e/ou fim de VÁRIAS contratações já existentes numa única chamada — update-only: uma contractId inexistente falha o item, nunca cria contratação nova. Campo omitido em um item mantém o valor atual daquela contratação. A operação não é transacional: a resposta traz o resultado por item, com o motivo de cada recusa. Máximo de 200 itens por chamada. Reenviar o mesmo lote é seguro: reaplica os mesmos períodos sem criar histórico novo.
results_program_panel_bulk_update_indicator_weight
ChatGPTAltera o peso de VÁRIOS indicadores já vinculados a blocos numa única chamada — o indicador deve já estar vinculado ao bloco (use results_program_panel_bulk_add_indicator para criar o vínculo). A operação não é transacional: a resposta traz o resultado por item, com o motivo de cada recusa. Máximo de 200 itens por chamada. Reenviar o mesmo lote é seguro: reaplica os mesmos pesos sem criar histórico novo.
tasks_create
ChatGPTCria uma tarefa em um Plano de Ação ou Cronograma do Stratws. Só o plano, a descrição e o fim previsto são obrigatórios. O responsável pode ser um usuário do tenant (responsibleId) ou um terceiro sem usuário no sistema, informado por nome e e-mail juntos. Informe parentTaskId para criar a tarefa como subtarefa de outra. A tarefa nasce igual a uma criada pela tela, inclusive nas notificações. Repetir a chamada com a mesma descrição, responsável e datas no mesmo plano devolve a tarefa que já existe, sem criar outra.
tasks_execute
ChatGPTRegistra a execução (progresso) de uma tarefa de Plano de Ação, Cronograma ou Solução de Problemas do Stratws — o mesmo que a tela faz ao 'executar' uma tarefa. dataRealizada e comentario são OBRIGATÓRIOS, a mesma regra da tela (RealizarAtividadeModel exige os dois campos); se o usuário não informar algum dos dois, pergunte antes de chamar a tool, não invente valor. Quando percentualConcluido for 100, dataRealizada representa a CONCLUSÃO da tarefa (fim realizado) — pergunte 'quando a tarefa foi concluída', não 'qual a data de execução'. Para vincular uma tag no momento da execução, use tagNomes (não é preciso chamar tasks_update antes). Reenviar a mesma chamada (mesma tarefa, data, percentual e comentário) é seguro: não cria um segundo registro de histórico. 100% de conclusão encerra a tarefa, sujeito às mesmas regras da tela (aprovação de conclusão, tag obrigatória etc.).
tasks_execute_batch
ChatGPTExecuta VÁRIAS tarefas numa única chamada — use no lugar de repetir tasks_execute quando o usuário está reportando progresso de várias tarefas do mesmo plano. dataRealizada e comentario são obrigatórios em cada item (mesma regra da tela); tagNomes é opcional por item, para vincular tag no momento da execução. Máximo 50 tarefas por chamada, sem repetir a mesma tarefa. Não é transacional: itens recusados não impedem os outros — relate ao usuário quais foram aplicadas e quais não, nunca assuma sucesso total.
tasks_get
ChatGPTConsulta o detalhe de uma tarefa do Stratws pelo seu Guid. Além do que a listagem já traz, devolve o 5W2H completo (causa, onde, por que, como, quanto previsto e realizado), código, criticidade, se é marco, os comentários da tarefa — incluindo os registrados na execução, e limitados aos que o usuário atual escreveu ou em que foi citado, mesma regra de comments_list — e as subtarefas com responsável, datas, percentual e status. A tarefa e cada subtarefa trazem url, o link que abre a tela do Stratws — ofereça-o ao usuário. O Guid vem do campo id de tasks_list. Para os comentários de VÁRIAS tarefas (ou de solução de problema/agendamento) de uma vez, use comments_list — esta tool atende só uma tarefa por chamada, mas com o 5W2H e as subtarefas que comments_list não traz.
tasks_list
ChatGPTLista as tarefas de um ou mais Planos de Ação ou Cronogramas do Stratws, identificados por Guid. Cada tarefa retorna com o plano a que pertence, o tipo desse plano (solução de problemas, cronograma, indicador, reunião etc.) e a entidade dona com sua descrição — não existe consulta separada de planos, a origem vem junto da tarefa. Uma mesma entidade costuma ter vários planos (uma solução de problemas tem um plano por ferramenta), por isso informe todos os identificadores de interesse de uma vez. Para percorrer tudo, chamar repetidamente incrementando skip até esgotar totalCount. Cada tarefa traz url, o link que abre a tarefa na tela do Stratws — ofereça-o ao usuário.
tasks_update
ChatGPTAltera campos de uma tarefa de Plano de Ação ou Cronograma do Stratws. Informe APENAS os campos que devem mudar: campo omitido não é alterado, e nunca é apagado. Aceita a descrição, os campos do 5W2H, as metas prevista e realizada, o início e o fim previstos (o fim é o prazo) e a troca de responsável — esta última exige justificativa. Respeita as mesmas regras da tela: em cronograma de projeto o nome da tarefa não é editável, plano que exige reprogramação recusa mudança direta de data, e tarefa finalizada ou com subtarefas tem restrições próprias. A resposta traz updatedFields, os campos que o Stratws aceitou aplicar — relate esses, e não o que foi pedido, porque uma regra pode ter recusado parte do pedido. Reenviar o mesmo patch é seguro: reaplica os mesmos valores sem criar histórico novo.
tasks_update_batch
ChatGPTAltera VÁRIAS tarefas numa única chamada — use esta em vez de repetir tasks_update quando o usuário está acertando um plano inteiro. Cada item tem seu próprio conjunto de campos, e vale a mesma regra do tasks_update: campo omitido não é alterado. Máximo de 50 tarefas por chamada, e a mesma tarefa não pode aparecer duas vezes. A operação não é transacional: itens recusados por regra de negócio não impedem os outros, e a resposta traz o resultado por item, com o motivo de cada recusa — relate ao usuário quais foram aplicadas e quais não, nunca assuma que todas passaram.
tenant_list_organizations
ChatGPTLista as empresas (tenants) que o usuário autenticado do Stratws pode acessar, conforme o token atual. Use quando o usuário tiver acesso a mais de uma empresa e for necessário informar o parâmetro tenantId explicitamente nas demais tools (users_, indicator_, management_plan_list, management_unit_list).
users_get_profile
ChatGPTConsulta o perfil detalhado de um usuário do Stratws pelo seu identificador Guid (não é mais um número inteiro).
users_get_summary
ChatGPTConsulta a quantidade total, ativa e inativa de usuários cadastrados no tenant atual do Stratws.
users_list
ChatGPTLista usuários do Stratws de forma paginada, com filtro opcional por ativo/inativo. Para extrair a base consolidada de todos os usuários, chamar repetidamente incrementando skip até esgotar totalCount.
users_list_one_on_one_candidates
ChatGPTLista com quem o usuário autenticado pode agendar um 1:1 — seu chefe direto e seus subordinados diretos, cada um rotulado como "Chefe" ou "Subordinado". Use esta tool antes de meetings_create quando o usuário não indicar explicitamente com quem quer conversar.
action_plan_create
Claudeaction_plan_get
Claudeaction_plan_list
Claudeaction_plan_list_available_steps
Claudefeedbacks_create
Claudefeedbacks_edit
Claudefeedbacks_list
Claudefeedbacks_list_templates
Claudeindicator_import_values
Claudeindicator_list
Claudeindicator_list_drilldowns
Claudeindicator_list_evidence_status
Claudeindicator_list_values
Claudeindicator_measure_unit_list
Claudeindicator_results_area_list
Claudeindicator_type_list
Claudemanagement_plan_list
Claudemanagement_unit_list
Claudemeetings_create
Claudemeetings_edit
Claudemeetings_get_suggested_topics
Claudemeetings_get_topics
Claudemeetings_list
Claudemeetings_set_private_notes
Claudemeetings_set_topic_notes
Claudeproblem_solutions_get_detail
Claudeproblem_solutions_get_detail_by_number
Claudeproblem_solutions_list
Claudeproject_get
Claudeproject_list
Clauderesults_program_get_apurated_panels
Clauderesults_program_list
Clauderesults_program_list_apurations
Clauderesults_program_list_panels
Clauderesults_program_panel_bulk_add_block
Clauderesults_program_panel_bulk_add_indicator
Clauderesults_program_panel_bulk_create
Clauderesults_program_panel_bulk_swap_indicator
Clauderesults_program_panel_bulk_update_block
Clauderesults_program_panel_bulk_update_contract
Clauderesults_program_panel_bulk_update_indicator_weight
Claudetasks_create
Claudetasks_execute
Claudetasks_execute_batch
Claudetasks_get
Claudetasks_list
Claudetasks_update
Claudetasks_update_batch
Claudetenant_list_organizations
Claudeusers_get_profile
Claudeusers_get_summary
Claudeusers_list
Claudeusers_list_one_on_one_candidates
Claude