Puca

Showing 25 of 27 from the live probe.

• Assistantjobs Createassistantjob

  ## Função da Ferramenta Cria um job periódico da Meg. No horário definido pelo cron o sistema abre um chat novo da Meg para cada destinatário, com o prompt informado, como se o próprio usuário tivesse iniciado a conversa. ## Quando Usar - O usuário quiser um lembrete periódico da Meg - Quiser uma rotina diária/semanal (cron) que a Meg execute de novo, com relatório ou resumo - Quiser agendar o envio de um processamento já feito na conversa para si e/ou outras pessoas - Um gestor quiser que a Me

• Assistantjobs Listassistantjobs

  ## Função da Ferramenta Lista os jobs periódicos da Meg que o usuário pode gerenciar. Por padrão retorna só os jobs ativos criados por ele. Com `includeHierarchy: true`, inclui também jobs criados por usuários abaixo no organograma (papéis filhos do Chefe). Jobs desativados ficam ocultos, salvo `includeInactive: true`. ## Quando Usar - O usuário perguntar quais jobs/crons da Meg existem - Antes de editar ou desativar um job - O usuário pedir os jobs da equipe / do organograma - Buscar um job pe

• Assistantjobs Updateassistantjob

  ## Função da Ferramenta Edita um job periódico da Meg (nome, prompt, cron, destinatários ou ativo). Só o criador, um superior hierárquico do criador ou puca-user pode editar. ## Parâmetros Esperados - `pucaPid` (obrigatório): pid do job - `prompt`, `cron`, `name`, `target`, `active`, `maxOccurrences` (opcionais) ## Exemplos de Uso Altere o cron do job X para 0 */12 * * * Inclua a Ana nos destinatários desse lembrete

• Assistantjobs Deactivateassistantjob

  ## Função da Ferramenta Desativa um job periódico da Meg. O registro permanece; o cron deixa de disparar. Só o criador, um superior do criador ou puca-user pode desativar. ## Parâmetros Esperados - `pucaPid` (obrigatório): pid do job ## Exemplos de Uso Desative o lembrete de visita da CASA FLORA

• Crm Basicinfoofperson

  ## Função da Ferramenta Obtém dados básicos da pessoa ou empresa do CRM. Retorna PK, chave única (UK), nome, CPF/CNPJ, endereço, telefone, email, campos personalizados user_* e outras informações cadastrais. ## Quando Usar - Use esta ferramenta quando: - O usuário solicitar informações sobre clientes, fornecedores ou parceiros - Houver necessidade de consultar dados cadastrais - A resposta depender de informações de pessoas ou empresas no CRM - Obter a PK da pessoa ou empresa para utili

• Crm Interactionofperson

  ## Função da Ferramenta Obtém interações da pessoa ou empresa. Retorna interações com data, autor, tipo e texto detalhado. ## Quando Usar - Use esta ferramenta quando: - O usuário solicitar histórico de contatos ou comunicações - Houver necessidade de consultar atendimentos anteriores - A resposta depender de relacionamento com clientes/parceiros ## Parâmetros Esperados - `pk`: PK da pessoa ou empresa (UUID) - `cpf`: CPF da pessoa ou empresa - `cnpj`: CNPJ da pessoa ou empresa - `uk`: UK

• Crm Relationshipofperson

  Obtem os relacionamentos pessoa ou empresa informada. Responde as perguntas "O que fulando é de ciclano?" e "Quem é responsável da fulano?" ## Parâmetros Esperados - `pk`: PK da pessoa ou empresa (UUID) - `cpf`: CPF da pessoa ou empresa - `cnpj`: CNPJ da pessoa ou empresa - `uk`: UK da pessoa ou empresa - `name`: Nome da pessoa ou empresa Informe apenas um dos parâmetros acima

• Crm Whatsappconversationhistory

  ## Função da Ferramenta Busca sob demanda o histórico de mensagens de uma conversa do WhatsApp anteriores a uma data/hora de corte. Use para complementar o contexto inicial da conversa (que já traz as últimas mensagens) quando o usuário perguntar por algo mais antigo do que já está disponível. ## Quando Usar - Use esta ferramenta quando: - O usuário perguntar o que o contato falou antes, em um momento anterior ao que já está no contexto - For pedido um resumo ou detalhe de um período especí

• Crm Listinteractiontypes

  ## Função da Ferramenta Lista os tipos de interação disponíveis no CRM (não internos) para escolher o interaction_type ao gravar uma interação. ## Quando Usar - Antes de InsertInteraction, para escolher o tipo mais adequado ao que o vendedor relatou - Quando o usuário pedir para registrar reunião, ligação, visita, e-mail ou outro contato ## Comportamento Esperado após Uso - Escolha o tipo cujo nome/descrição melhor descreve o fato relatado - Use o puca_pid do tipo em InsertInteraction ## Exem

• Crm Insertinteraction

  ## Função da Ferramenta Grava uma nova interação no CRM vinculada a uma pessoa ou empresa. Use após o vendedor relatar o que aconteceu (follow-up do briefing, reunião, ligação, etc.). ## Quando Usar - Sempre que o usuário relatar um fato que deve ficar no histórico do cliente - No follow-up do chat embarcado da Meg, na resposta do vendedor às perguntas do briefing — grave pelo menos uma interação ## Parâmetros Esperados - `pk`: PK da pessoa ou empresa (UUID) - `cpf`: CPF da pessoa ou empresa -

• Crm Upsertperson

  ## Função da Ferramenta Cria ou altera pessoa/empresa no CRM. Upsert por puca_pid ou puca_key: se existir, altera; se não existir, cria com o pid/key informados. ## Omit vs null - Campo ausente: não altera o banco - Campo presente com null: grava null no banco ## Quando Usar - Cadastrar ou atualizar cliente, contato, fornecedor ou empresa - Incluir, alterar ou remover (com flag) emails, endereços, tipos e vínculos ## Identidade - `puca_pid` / `pk` / `personPid`: PK (UUID) - `puca_key` / `uk`:

• Flow Kanbandocumentation

  ## Função da Ferramenta Retorna a documentação do Kanban. Retorna título, subtítulo, escopo, não escopo e detalhes de cada etapa do Kanban. ## Quando Usar - Use esta ferramenta quando: - O usuário solicitar informações sobre o escopo de um Kanban - Houver necessidade de entender etapas e documentação - A resposta depender de detalhes de um Kanban específico ## Parâmetros Esperados - `pk`: PK do Card (UUID) - `uk`: UK do Card (número) Informe apenas um dos parâmetros acima ## Comportamen

• Flow Listacardsdoresponsavel

  ## Função da Ferramenta Lista os cards do responsável. Retorna cards com informações detalhadas incluindo título, status, datas e responsabilidades. ## Quando Usar - Use esta ferramenta quando: - O usuário solicitar visualizar cards de um responsável - Houver necessidade de consultar carga de trabalho - A resposta depender de cards atribuídos a um usuário ## Parâmetros Esperados - `username`: Nome de usuário do responsável (obrigatório) - `flow`: PK ou UK do Kanban (opcional) ## Comport

• Flow Informacoesdocard

  ## Função da Ferramenta Obtém informações básicas do card e do formulário. Retorna dados do card, campos do formulário e valores preenchidos. ## Quando Usar - Use esta ferramenta quando: - O usuário solicitar detalhes sobre um card específico - Houver necessidade de consultar dados do formulário - A resposta depender de informações completas de um item no Kanban ## Parâmetros Esperados - `pk`: PK do Card (UUID) - `uk`: UK do Card (número) Informe apenas um dos parâmetros acima ## Compor

• Flow Upsertcard

  ## Função da Ferramenta Cria ou altera um card e/ou o formulário vinculado. Upsert por pk ou uk: se existir, altera; se não existir ou se pk/uk forem omitidos, cria. Na criação, o kanban (flow) é obrigatório. ## Quando Usar - Use esta ferramenta quando: - O usuário solicitar criar um card em um kanban - O usuário solicitar alterar dados de um card - Houver necessidade de preencher ou atualizar o formulário - A resposta depender de mover etapa, trocar responsável ou gravar campos ## Qua

• Flow Requisitosdocard

  ## Função da Ferramenta Lista os requisitos do card. Retorna lista detalhada de requisitos incluindo campos obrigatórios, validações e bloqueios. ## Quando Usar - Use esta ferramenta quando: - O usuário solicitar informações sobre pendências do card - Houver necessidade de verificar validações necessárias - A resposta depender de requisitos para avançar o card ## Parâmetros Esperados - `pk`: PK do Card (UUID) - `uk`: UK do Card (número) Informe apenas um dos parâmetros acima ## Comporta

• Flow Usuariospermitidosporetapa

  ## Função da Ferramenta Lista os usuários permitidos por etapa do card. Retorna lista de usuários autorizados por etapa do Kanban. ## Quando Usar - Use esta ferramenta quando: - O usuário solicitar informações sobre permissões por etapa - Houver necessidade de verificar responsabilidades - A resposta depender de quem pode trabalhar em cada etapa ## Parâmetros Esperados - `pk`: PK do Card (UUID) - `uk`: UK do Card (número) Informe apenas um dos parâmetros acima ## Comportamento Esperado

• Flow Historicodocard

  ## Função da Ferramenta Lista o histórico do card. Retorna cronologia detalhada de alterações incluindo data, usuário responsável e dados modificados. ## Quando Usar - Use esta ferramenta quando: - O usuário solicitar informações sobre mudanças no card - Houver necessidade de verificar movimentações - A resposta depender de histórico de atividades do card ## Parâmetros Esperados - `pk`: PK do Card (UUID) - `uk`: UK do Card (número) Informe apenas um dos parâmetros acima ## Comportamento

• Flow Interacoesdocard

  ## Função da Ferramenta Lista as interações (comentários) do card. Retorna histórico de interações incluindo data, autor e conteúdo dos comentários. ## Quando Usar - Use esta ferramenta quando: - O usuário solicitar informações sobre comunicações do card - Houver necessidade de verificar comentários - A resposta depender de discussões relacionadas ao card ## Parâmetros Esperados - `pk`: PK do Card (UUID) - `uk`: UK do Card (número) Informe apenas um dos parâmetros acima ## Comportamento

• Flow Incluirinteracao

  ## Função da Ferramenta Inclui uma interação (comentário) no card. Grava o texto informado como comentário do usuário autenticado. ## Quando Usar - Use esta ferramenta quando: - O usuário solicitar registrar um comentário no card - Houver necessidade de incluir uma interação - A resposta depender de gravar uma mensagem no card ## Quando NÃO Usar - Não use para consultar interações (use InteracoesDoCard) - Não use para criar ou alterar card e formulário (use UpsertCard) ## Parâmetros Esp

• Flow Tarefasrelacionadas

  ## Função da Ferramenta Lista as tarefas relacionadas ao card. Retorna lista de tarefas incluindo título, responsável, datas, descrição e status. ## Quando Usar - Use esta ferramenta quando: - O usuário solicitar informações sobre atividades do card - Houver necessidade de verificar eventos relacionados - A resposta depender de tarefas associadas ao card ## Parâmetros Esperados - `pk`: PK do Card (UUID) - `uk`: UK do Card (número) Informe apenas um dos parâmetros acima ## Comportamento

• Posting Fin Getpostingfininfo

  ## Função da Ferramenta Obtém a análise dos lançamentos financeiros de um parceiro. Retorna análise detalhada incluindo valores, status, datas de vencimento e situação dos lançamentos. ## Quando Usar - Use esta ferramenta quando: - O usuário solicitar informações sobre contas a receber - Houver necessidade de verificar lançamentos em aberto - A resposta depender de lançamentos atrasados ou vencidos ## Parâmetros Esperados - `pk`: PK da pessoa ou empresa (UUID) - `cpf`: CPF da pessoa ou e

• Ruleconfigservice Accessreport

  ## Função da Ferramenta Gera um relatório completo de permissões de acesso do usuário. Retorna detalhes sobre papéis atribuídos, módulos acessíveis e permissões herdadas. ## Quando Usar - Use esta ferramenta quando: - O usuário solicitar informações sobre suas permissões - Houver necessidade de verificar direitos de acesso - A resposta depender de dados de papéis e permissões ## Parâmetros Esperados userId (opcional): ID (PID) ou username do usuário para verificar permissões. Se não forn

• Ruleconfigservice Checkuseraccess

  ## Função da Ferramenta Verifica se um usuário tem uma permissão específica e se essa permissão foi definida diretamente ou é herdada hierarquicamente. ## Quando Usar - Use esta ferramenta quando: - O usuário perguntar se tem uma permissão específica - Houver necessidade de verificar um acesso específico - A resposta depender de uma verificação pontual de permissão ## Parâmetros Esperados permissionName (obrigatório): Nome da permissão a ser verificada. userId (opcional): ID (PID) ou use

• Sql Executor Executarsql

  ## Função da Ferramenta Executa um SQL SELECT no banco de dados do domínio e retorna os resultados. ## Quando Usar - Sempre que o usuário quiser buscar dados do sistema e não houver endpoint dedicado para isso - Mesmo quando o usuário não pedir explicitamente SQL, use esta ferramenta para obter os dados solicitados - Para consultas ad-hoc que não têm endpoint dedicado ## Parâmetros Esperados - `sql`: string com o SELECT a ser executado ## Fallbacks e Restrições - Apenas queries SELECT são sup