Depois de ligar um assistente à CUTL (ver Ligar assistentes de IA), fala com ele em linguagem simples e ele escolhe as ferramentas da CUTL certas. Esta página indica o que cada conjunto de ferramentas lhe permite fazer, que ferramentas custam moedas e quinze exemplos práticos de pedidos reais.
Nunca escreve nomes de ferramentas: aparecem aqui em code porque alguns assistentes os mostram enquanto trabalham. Cada ferramenta verifica o mesmo direito que a ação correspondente na aplicação web exige, pelo que o assistente só pode fazer o que a sua função permite.
Principal
Endereço /mcp, 16 ferramentas. Para orçamentar peças 2D, enviar orçamentos por e-mail, lançar a produção, nesting, relatórios e estado da produção.
| Ferramenta | O que faz | Custo |
|---|---|---|
get_account | Em nome de quem a ligação age, o saldo da equipa, o preço de cada ação faturada, os limites de moedas e quanto resta deles | Gratuito |
find_reference | Procura os seus materiais, modos de corte, clientes ou organizações por texto | Gratuito |
search_projects | Encontra projetos por nome, número, cliente ou datas de criação, dos mais recentes para os mais antigos, até 20 | Gratuito |
create_project | Cria um projeto. Se o nome do cliente não corresponder a nenhum ou corresponder a vários, nada é criado e os candidatos são devolvidos | Gratuito |
request_upload | Obtém um link de carregamento para um ficheiro | Gratuito |
add_files_to_project | Adiciona até 20 desenhos (DXF, STEP, PDF) como peças, cada um com material e quantidade; a CUTL começa a calculá-los | Faturado: um cálculo de peça por peça criada |
get_quote | As peças do projeto com preços e totais, ou porque é que uma peça não tem preço e que ferramenta o resolve; um link de 15 minutos para o PDF do orçamento quando todas as peças têm preço | Gratuito |
update_part | Altera o material, o modo de corte, a quantidade ou o comentário de uma peça e calcula de novo o preço | Gratuito |
explain_price | Porque é que uma peça custa o que custa, e quanto custaria em até 5 outros materiais. Nada é alterado | Gratuito |
send_quote | Envia o PDF do orçamento por e-mail ao cliente (predefinição) ou para outro endereço | Gratuito, confirma o utilizador |
reorder | Copia um projeto com todas as suas peças como novo projeto, pronto a alterar e orçamentar de novo | Faturado: um cálculo por peça |
launch_production | Envia para produção um projeto com todas as peças com preço: fica bloqueado para alterações e são criadas tarefas de turno | Gratuito, confirma sempre na página de confirmação |
run_nesting | Dispõe as peças do projeto em chapas de um tamanho indicado, por material (o habitual) ou por peça | Gratuito |
nesting_result | O nesting mais recente: chapas, aproveitamento, retalhos e um link para o layout de cada chapa | Gratuito |
order_status | Com um projeto, o progresso da sua produção por tarefa de turno; sem projeto, a oficina de hoje | Gratuito |
report | Consumo de material, análise de retalhos ou execução de turnos para um intervalo de datas: até 50 linhas e um link CSV de 15 minutos | Gratuito |
Regras a conhecer:
- As peças só podem ser adicionadas ou alteradas enquanto o projeto está no estado CREATED, e só um projeto CREATED pode ser lançado.
- Um orçamento só pode ser enviado por e-mail ou lançado quando todas as peças têm preço.
get_quotediz porque é que uma peça não tem preço: ainda em cálculo, o cálculo falhou, o PDF contém vários desenhos e tem de escolher quais orçamentar (na CUTL), sem material, sem modo de corte para o material, ou sem preço para o material ou o modo de corte. - Uma data de entrega para a produção tem de ser no futuro.
- Adicionar ou alterar uma peça descarta o nesting do projeto; execute-o de novo depois. Consulte Nesting.
- Nos assistentes que os mostram, o servidor Principal oferece também três prompts prontos: Quote these files (orçamentar estes ficheiros), Explain this quote to a customer (explicar este orçamento a um cliente: escreve o texto, não envia nada) e Morning production brief (resumo matinal da produção).
STEP e MBD
Endereço /mcp/step, 20 ferramentas, todas gratuitas. Para o visualizador STEP, o PMI e as conversões.
| Ferramenta | O que faz |
|---|---|
request_upload | Link de carregamento para um modelo STEP, um DXF, ou um desenho PDF ou QIF |
create_step_review | Transforma um ficheiro STEP carregado numa revisão STEP; o mesmo ficheiro devolve a revisão já existente da equipa |
upload_step_version | Adiciona um modelo alterado como próxima versão da revisão; os comentários mantêm-se |
list_step_reviews | As revisões da equipa, das que tiveram atividade mais recente para as mais antigas, até 20 |
step_review_summary | O que contém o modelo analisado: contagens, lista de materiais, montagens de nível superior com as respetivas referências #N, quanto PMI, uma miniatura |
step_comments | As conversas de comentários da revisão, das mais recentes para as mais antigas |
add_step_comment | Publica um comentário ou uma resposta; todos os que seguem a revisão recebem um e-mail, por isso confirma-o na conversa |
resolve_step_comment | Marca uma conversa como resolvida ou reabre-a |
invite_reviewer | Convida uma pessoa por e-mail para uma revisão, opcionalmente ocultando montagens ou peças, até um último dia de acesso. Apenas administradores da equipa. Confirma na conversa, ou na página de confirmação para um endereço que a sua equipa ainda não convidou |
archive_step_review | Arquiva uma revisão; os revisores externos perdem o acesso. Apenas administradores da equipa, confirmado na conversa |
start_enrichment | Lê as cotas, tolerâncias, referências e notas dos desenhos 2D da peça (PDF ou QIF) para o modelo 3D; uma pessoa verifica as leituras na CUTL |
enrichment_status | Em que ponto está uma execução de enriquecimento: a trabalhar, à espera de uma pessoa, concluída ou parada |
accept_enrichment | Torna o modelo enriquecido de uma execução concluída a próxima versão da revisão, confirmado na conversa |
list_pmi | O PMI que o modelo contém, até 100 linhas |
pmi_export | Todo o PMI em CSV ou Excel, como link de 15 minutos |
propose_pmi_change | Adiciona, edita ou elimina PMI no próprio ficheiro STEP; o resultado é a próxima versão, escrita em cerca de um minuto |
inspection_report | A partir de um enriquecimento concluído: desenho com balões (PDF), tabela de inspeção (Excel), QIF, o STEP enriquecido ou um certificado de conformidade (PDF) |
convert_to_step | Um modelo STEP 3D a partir de uma peça configurada no editor de peças da CUTL (quinada nas suas dobras), ou a partir de um DXF simples com uma espessura (uma chapa plana sem dobras). Consulte DXF para STEP |
pdf_to_step | Reconstrói as peças de um desenho PDF como modelos STEP em 10 a 30 minutos. Consulte PDF para STEP |
conversion_status | Acompanha qualquer das conversões até estar concluída, à espera de uma pessoa ou falhada |
Montagens e documentos
Endereço /mcp/assembly, 15 ferramentas. Para a orçamentação de montagens, os roteiros e os documentos de produção.
| Ferramenta | O que faz | Custo |
|---|---|---|
request_upload | Link de carregamento para um modelo STEP | Gratuito |
start_assembly | Cria uma montagem (submontagens e peças, cada uma a fabricar ou a comprar) a partir de uma revisão STEP ou de um ficheiro STEP carregado | Gratuito |
assembly_detail | A árvore com quantidades, fabricar ou comprar, classe da peça, material, estado do preço e roteiro | Gratuito |
reanalyse_assembly | Atualiza a árvore com o modelo atual da revisão | Gratuito |
set_assembly_quantities | Define até 3 escalões de quantidade de 1 a 1 000 000, e o mais provável | Gratuito |
quote_assembly_parts | Calcula o preço das peças de chapa e tubo a fabricar através do cálculo de corte; uma peça que já tem preço não é cobrada de novo | Faturado: um cálculo de peça por peça iniciada |
assembly_quote | O orçamento em PDF ou Excel, variante interna ou para o cliente, para um número de unidades | Gratuito |
request_supplier_offer | Cria um link de preço para um item comprado. A CUTL não envia e-mail a ninguém: é o utilizador que envia o link. Confirmado na conversa | Gratuito |
get_route | O roteiro de um nó: operações, equipamento, tempos, trabalho subcontratado, custo unitário | Gratuito |
set_route | Substitui as linhas manuais do roteiro de um nó; uma linha inválida não altera nada, um roteiro aprovado é recusado | Gratuito |
copy_route | Copia as linhas manuais de um nó para até 20 nós do mesmo tipo | Gratuito |
drawing_pdf | Desenhos de fabrico a partir de uma revisão STEP num único PDF pronto a imprimir (A4, A3, A2, A1 ou A0) | Gratuito |
route_card | A ficha de roteiro como PDF pronto a imprimir: ficha de acompanhamento (predefinição) ou formato GOST 3.1118 | Gratuito |
assembly_lists | Lista de compras, lista de fabrico ou lista de kit, até 50 linhas e um link CSV | Gratuito |
erp_export | A montagem como documento ERP da CUTL (lista de materiais, roteiros, custeio, peças em bruto) em JSON ou XML | Gratuito |
Configuração e base de conhecimento
Endereço /mcp/setup, 17 ferramentas, todas gratuitas. O assistente tem instruções para lhe perguntar o custo horário de uma máquina e nunca inventar preços.
| Ferramenta | O que faz |
|---|---|
setup_status | O que a CUTL ainda precisa antes de poder calcular preços de peças. O ponto de partida |
browse_catalogue | O catálogo de corte integrado da CUTL: tipos de máquina e gamas de potência, o que cada máquina corta, os materiais com grau, espessura e preço conhecido |
add_from_catalogue | Cria a máquina, os materiais escolhidos, os modos de corte, os tamanhos de chapa padrão e os preços de material conhecidos numa só chamada; executá-la duas vezes não cria nada em duplicado |
list_materials, list_cutting_modes, list_equipment | Os materiais, modos de corte e máquinas da oficina |
create_equipment, create_cutting_mode, create_material | Adicionam uma máquina, um modo de corte ou um material |
assign_cutting_mode | Define o modo de corte com que um material é cortado |
add_sheet_size | Adiciona um tamanho de chapa a um material, para o nesting e o custo de material |
update_material_price, update_cutting_mode | Alteram o preço por m² de um material, ou os preços ou tempos de um modo de corte. As peças com preço calculado antes mantêm o seu preço até serem calculadas de novo |
create_customer | Adiciona um cliente, para que possam ser feitos orçamentos em seu nome |
report_bug | Informa a equipa da CUTL sobre algo na CUTL que não funciona. O seu endereço de e-mail não é incluído |
search, fetch | Pesquisam na documentação da CUTL (até 8 secções) e leem uma secção completa. Nunca pesquisam os seus projetos nem dados |
Demonstração
Endereço /mcp/demo no servidor de demonstração separado, 6 ferramentas só de leitura sobre uma oficina fictícia: search_projects, order_status, explain_price (sem comparar materiais), report (no máximo 20 linhas), find_reference e nesting_result. Nada pode ser alterado nem cobrado. Consulte o servidor de demonstração.
O que custa moedas
Apenas três ferramentas gastam moedas, exatamente como a mesma ação na aplicação web. Tudo o resto é gratuito.
| Ferramenta | Cobrança |
|---|---|
add_files_to_project | Um cálculo de peça por peça criada |
reorder | Um cálculo por peça copiada |
quote_assembly_parts | Um cálculo de peça por peça iniciada |
As três podem fazer primeiro uma simulação ("Quanto custaria isso? Ainda não o faça"), e as três estão sujeitas aos limites de moedas do assistente da sua equipa. Consulte Moedas e faturação e Limites de moedas do assistente.
Exemplos práticos
Os exemplos usam uma oficina fictícia, Kramer Lasertechniek (administradora da equipa Anna Kramer), o seu cliente Van Dijk Staalbouw e um preço de exemplo de 100 moedas por cálculo de peça. Os seus números, nomes e preços serão diferentes.
1. Orçamentar três peças DXF
Diz: "Crie um projeto para a Van Dijk Staalbouw chamado 'Suportes T4' a partir de bracket-a.dxf, plate-b.dxf e cover-c.dxf, S235 de 3 mm, 50 de cada, e diga-me o total."
O assistente verifica o seu saldo, cria o projeto #000123 para a Van Dijk Staalbouw BV e dá-lhe três links de carregamento. Larga cada ficheiro e diz "enviado". Faz uma simulação ("Adicionar os três ficheiros vai custar 300 moedas. Avanço?"), responde que sim, e ele adiciona os ficheiros e lê o orçamento. Recebe o total (1284,00 EUR), o preço por peça e um link para o PDF do orçamento. Custo: 300 moedas.
2. Um ficheiro precisa de uma escolha de material
Diz: "Adicione hinge.dxf ao projeto 123, inox 2 mm, 10 unidades."
O assistente encontra o projeto, obtém o carregamento do ficheiro e encontra dois materiais correspondentes, por isso pergunta: "Qual inox: AISI 304 ou AISI 316L?". Responde "304" e ele adiciona a peça e lê o orçamento. Custo: 100 moedas.
3. Comparar materiais e depois mudar um
Diz: "Porque é que a plate-b é tão cara? S355 ou DC01 sairiam mais baratos?"
O assistente explica o preço sem alterar nada: "Por unidade: material 6,1, corte 3,4, perfuração 0,8, 10,3 no total. A maior parte é material." S355J2 custaria mais 1,2, DC01 menos 0,9. Diz "Mude-a para DC01" e ele altera a peça e dá o novo total. Custo: gratuito, nada a confirmar.
4. Enviar o orçamento ao cliente
Diz: "Envie o orçamento à Van Dijk, com cópia para mim."
O assistente mostra uma pré-visualização: para o endereço do cliente, uma cópia para si, projeto #000123, 3 peças, 1284,00 EUR, o PDF e o idioma, e pergunta "Envio?". Confirma na conversa e ele indica "O orçamento foi enviado". Custo: gratuito.
5. Enviar o orçamento para um endereço novo
Diz: "Envie-o também ao comprador deles, p.smit@vandijk-groep.example."
Esse endereço não é do cliente nem seu, por isso o assistente dá-lhe um link de confirmação. Abre-o, vê Para destacado com Destinatário: um endereço que a CUTL ainda não viu para este projeto, prime Confirmar e diz ao assistente "Confirmado". Ele envia o orçamento. Custo: gratuito.
6. Lançar a produção
Diz: "Lance o projeto 123, com entrega a 2 de novembro."
O lançamento exige sempre a página de confirmação. O assistente dá-lhe um link com uma pré-visualização das peças, 150 unidades no total, 1284,00 EUR e a data de entrega. Verifica, prime Confirmar e diz "avance". Ele indica "O projeto #000123 Suportes T4 está em produção com 3 tarefas de turno." Mais tarde, "Em que ponto está o 123?" mostra o progresso por tarefa de turno. Se esperar mais de 10 minutos, ele recomeça com um novo link. Custo: gratuito.
7. Nesting
Diz: "Faça o nesting do projeto 123 em chapas de 3000 × 1500, com 5 mm de espaçamento."
O assistente inicia o nesting em segundo plano e aguarda o resultado: por material, 2 chapas, 78 % de aproveitamento, 3 retalhos e um link para o layout de cada chapa. Custo: gratuito. Consulte Nesting.
8. Relatórios e a oficina
Diz: "O que está hoje no laser, e qual foi o nosso desvio de material em setembro?"
O assistente lista as tarefas de turno de hoje com as unidades feitas e planeadas, e depois executa o relatório de consumo de material de 1 a 30 de setembro: até 50 linhas, o desvio total em dinheiro e um link CSV de 15 minutos. Custo: gratuito.
9. Copiar a encomenda do mês passado
Diz: "A Van Dijk quer o projeto 98 outra vez. Quanto custaria copiá-lo?"
O assistente faz uma simulação: copiar o #000098 (4 peças) custaria 400 moedas. Diz "Faça-o" e ele cria o novo projeto, aberto a alterações, e lê o seu orçamento. Custo: 400 moedas.
10. Configurar uma oficina nova a partir do catálogo
Diz: "Temos um laser de fibra de 3 kW e cortamos S235 e inox de 1 a 6 mm. Configure a CUTL."
O assistente verifica o que falta, consulta o catálogo da CUTL para a gama de fibra de 3 kW e para os aços carbono e inoxidáveis, e depois pergunta "Quanto lhe custa uma hora de laser?". Responde "75 euros" e ele cria a máquina, os materiais, os modos de corte, os tamanhos de chapa e os preços conhecidos de uma só vez, e depois diz-lhe o que ainda falta (por exemplo o perfil de custos). Custo: gratuito.
11. Revisão STEP com um revisor externo
Diz: "Abra housing.step como revisão e convide a nossa fornecedora Lisa Bos (l.bos@bos-plaatwerk.example) até 30 de novembro, sem o módulo eletrónico."
O assistente obtém o carregamento do ficheiro, cria a revisão e lê o seu resumo (48 peças, com #17 Módulo eletrónico no nível superior). O endereço é novo para a sua equipa, por isso dá-lhe um link de confirmação. Verifica Verão: o modelo sem #17 e Acesso até, prime Confirmar e informa o assistente. A Lisa recebe um e-mail com um código de utilização única. Convidar é exclusivo dos administradores da equipa. Custo: gratuito. Consulte Visualizador STEP.
12. Desenho PDF para STEP
Diz: "O cliente só enviou flange.pdf. Faça um modelo STEP a partir dele."
O assistente obtém o carregamento do ficheiro e inicia a conversão (10 a 30 minutos). Mais tarde indica que uma pessoa tem de responder a uma pergunta sobre o desenho na CUTL (responde lá), ou que está concluída, com links para os ficheiros STEP válidos durante 15 minutos. Para ver um deles na CUTL, carrega-o de novo como revisão STEP. Custo: gratuito. Consulte PDF para STEP.
13. Orçamento de montagem com escalões de quantidade e um preço de fornecedor
Diz: "Orçamente a montagem da estrutura de housing.step para 10, 50 e 200 unidades, 50 a mais provável. A mola a gás é comprada: peça um preço à Hydro-Tech."
O assistente cria a montagem (31 nós, 12 com preço calculável, a mola a gás é um item comprado) e define as três quantidades. Uma simulação indica que calcular o preço das 12 peças custa 1200 moedas; diz "OK". Prepara um link de preço para fornecedor para a mola a gás, confirma na conversa, e ele entrega-lhe o link: "Envie este link à Hydro-Tech; a CUTL não o envia por e-mail." Quando tudo tem preço, dá-lhe o orçamento para o cliente como link PDF de 15 minutos. Custo: 1200 moedas. Consulte Orçamentar montagens STEP.
14. PDF de desenhos e uma ficha de roteiro
Diz: "Preciso de desenhos A3 de toda a caixa para a oficina, e da ficha de roteiro."
O assistente cria o PDF de desenhos A3 (após uma ou duas chamadas), indica que peças não foram desenhadas e porquê (por exemplo peças compradas) e cria o PDF da ficha de roteiro. Os dois links funcionam durante 15 minutos; abre-os e imprime-os. Custo: gratuito. Consulte Roteiros.
15. Pesquisa na documentação
Diz: "Como é que a CUTL decide o preço de uma dobra?"
O assistente pesquisa na documentação da CUTL, lê a secção mais adequada e responde com base nela. Isto pesquisa a documentação da CUTL, nunca os seus projetos. Custo: gratuito.