Pular para o conteúdo

Documentação do trulyform

Crie formulários com um assistente de IA

Como assistentes de IA criam, editam e publicam formulários no trulyform via MCP: endereço do servidor, login, ferramentas e a definição do formulário.

Ver em Markdown (inglês)

Todas as páginas da documentação
Nesta página

O trulyform é uma ferramenta para criar formulários online. Com o servidor MCP do trulyform, seu assistente de IA trabalha direto na sua conta: cria formulários, edita perguntas, lógica e design, publica e lê as respostas.

O que você precisa saber

  • Servidor: https://trulyform.com/mcp, MCP remoto via HTTP. O passo a passo da configuração está em Conectar.
  • Login: você entra no trulyform pelo navegador e autoriza o acesso. Não é preciso chave de API.
  • Cada formulário é um único documento JSON, a definição do formulário. O fluxo é ler com get_form, editar e salvar o documento inteiro com save_form_draft.
  • Salvar nunca publica. A publicação é uma chamada à parte, feita só quando você pedir.
  • Comece por Crie um formulário, passo a passo. Para os detalhes, consulte Tipos de pergunta e Limites e erros.

As ferramentas

O servidor tem 10 ferramentas.

A referência técnica a seguir é gerada a partir do código e está em inglês, como os assistentes de IA a leem.

Ferramenta O que faz
read_docs Read trulyform’s docs for building forms, as Markdown.
list_forms List forms in your organization, newest IDs first.
get_form Read the complete current draft definition, revision, validation issues, and publication information.
list_field_types List every question kind with its settings, logic operators, answer shape and a ready-to-edit template, plus the rich-text shape and definition limits.
create_form Create an unpublished form in your organization and return its full initial draft.
save_form_draft Replace a form’s entire draft definition and name, preserving draft history.
publish_form Publish the exact reviewed draft revision for new respondents.
list_responses List response IDs, status, version, and timestamps for a form, newest IDs first.
get_response Read one private response with resolved question labels, display answers, active-path indicators, calculations, and file names/sizes.
form_stats Count currently stored completed responses and, when your plan permits partial responses, started responses.

O que um formulário pode ter

  • Uma tela de boas-vindas, até 200 perguntas, mostradas uma por vez, e uma tela final.
  • 17 tipos de pergunta, de texto curto e e-mail a avaliações, rankings, matrizes e envio de arquivo.
  • Regras de lógica que mostram, ocultam, tornam obrigatórias ou pulam perguntas conforme as respostas anteriores.
  • Cálculos que transformam respostas em números, como um orçamento ou uma pontuação.
  • Referências de resposta: uma resposta anterior ou o resultado de um cálculo aparece numa pergunta seguinte ou na tela final.
  • Um tema: cores, fonte, arredondamento dos cantos e espaçamento.

O formulário não tem páginas nem seções, tem uma única tela final e não redireciona para outro endereço depois do envio.

Para agentes

  • Conectado via MCP? Chame read_docs para ler qualquer uma destas páginas, ou só uma seção, como question-types#file_upload. As páginas também estão disponíveis como recursos MCP em trulyform://docs/{page}. O que os agentes leem está em inglês.
  • Cada página tem uma versão em Markdown, em inglês: basta acrescentar .md ao endereço da página em inglês, por exemplo https://trulyform.com/docs/question-types.md.
  • https://trulyform.com/llms.txt lista todas as páginas, e https://trulyform.com/llms-full.txt traz todas elas num só arquivo.

Pronto para criar?
Conecte seu assistente.

Escolha o assistente que você usa, entre no trulyform e peça o formulário de que precisa.

Escolher assistente