Talkform

io.github.msanchezgrice由 GitHub 帳號 msanchezgrice 發布v0.1.1更新於 Oct 29, 2026

Collect reviewed human answers through hosted handoffs, plus local templates and config validation.

發布方自己的服務:Public

已驗證Streamable HTTP可網頁執行效率與工作流溝通與協作商業與電商

概覽

AI 產生的概覽

Talkform 讓助理建立語音或文字訪談表單、分享私密受訪者連結,並取回結構化答案。

可以做什麼
  • 列出並檢視公開的對話式表單範本
  • 依訪談問題產生經驗證的表單草稿,可設定品牌資訊與主題色,且不儲存
  • 註冊機器專案並建立託管交接,回傳私密受訪者連結與分享文字
  • 查詢交接狀態並取得已完成的結構化答案
  • 刪除已儲存的交接與答案
  • 設定、檢視與停用完成交接的 Webhook
適用情境
適合需要蒐集經審核的人工回答的情境,例如資料填寫、到職流程或研究訪談,讓受訪者透過連結作答,而不是在對話中回答。也適合在發布前先驗證表單草稿。
執行需求
可作為遠端端點使用,也可作為本機 npm 套件透過 stdio 執行。託管交接需要已註冊的機器專案及其 API 金鑰,或具備 handoffs:read、handoffs:write、handoffs:delete 權限的 OAuth 帳號。Webhook 需要 HTTPS 端點。自行部署完整應用需要 OpenAI API 金鑰及相關環境變數。
安裝前請注意
register_agent 會一次性回傳 API 金鑰,configure_webhook 會一次性回傳簽章金鑰,請妥善保存。機器專案每天限 10 次託管交接。delete_handoff 會永久刪除已儲存的設定與答案,且需要使用者確認。結果在提交 7 天後過期。受訪者連結與答案儲存在 Talkform 的託管服務上。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Talkform,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.msanchezgrice%2Ftalkform/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "talkform": {
      "type": "http",
      "url": "https://www.talkform.ai/api/mcp"
    }
  }
}

README

Talkform

Turn any form into a live audio interview.

Talkform is a config-driven audio intake utility. Products define the fields they need, Talkform asks for them conversationally, binds structured values directly into the form, and exports JSON-ready session results.

Workspace

  • apps/web: hosted app for talkform.ai
  • packages/core: config schema, realtime prompt/tool generation, session/result helpers
  • packages/react: embeddable React widget
  • packages/http: process-local transient session and HTTP helpers
  • packages/cli: agent-friendly CLI
  • packages/mcp: local MCP schema, template, and config-validation server
  • docs: markdown documentation rendered in the web app

Core commands

bash
pnpm installpnpm devpnpm buildpnpm typecheck

Environment

  • OPENAI_API_KEY
  • OPENAI_REALTIME_MODEL default gpt-realtime-2.1
  • OPENAI_REALTIME_VOICE default marin
  • TALKFORM_ENABLE_IMPORT_AI_REFINEMENT optional; only true enables paid AI copy refinement after deterministic import
  • NEXT_PUBLIC_AUDIOFORM_VENDOR
  • NEXT_PUBLIC_AUDIOFORM_VENDOR_URL

Transient session APIs and public Realtime client-secret issuance are disabled in hosted production by default. A production deployment needs a durable session store, a distributed rate limiter, and server authentication before those endpoints should be enabled. The current in-memory store and quotas are development/reference implementations; they do not provide cross-instance durability or enforcement.

Machine clients use two matching environment variables:

  • TALKFORM_API_TOKEN: server-only bearer token accepted by the web API
  • AUDIOFORM_API_TOKEN: client-side token read by the Talkform CLI

For a controlled deployment, TALKFORM_ENABLE_IN_MEMORY_SESSIONS=true and TALKFORM_ENABLE_PUBLIC_REALTIME=true opt into the reference endpoints. Do not use these flags to represent the current process-local implementations as production-ready infrastructure.

來源:README.md,提交 78f13d6

工具

11

talkform.list_templates

List Talkform templates

Lists the public conversational-form templates available for review.

無需輸入參數。

talkform.get_template

Review a Talkform template

Returns one public template as a structured, reviewable conversational form draft.

輸入參數id必填

talkform.prepare_form

Prepare a Talkform draft

Turns interview questions into a validated, shareable form draft. Each promptTitle is the respondent-facing question; fromName, purpose and branding identify the originating product. Optional theme colors use hex values. Returns a draft without storing or publishing it.

輸入參數modethemetitle必填fields必填purposebrandingfromNamedescriptioninstructions

talkform.register_agent

Create a private agent workspace

Creates a persistent machine-owned project and returns its API key secret once. No email, sign-in, or human identity is created. A UUIDv4 idempotency key identifies registration; retries never replay the secret. Machine projects receive 10 hosted handoffs per day. Voice is available in hosted interviews under shared realtime limits.

輸入參數nameenvironmentidempotencyKey必填

talkform.create_handoff

Create a hosted interview

Stores a validated voice interview or text interview and returns a private respondent link plus shareText. config.fields[].promptTitle supplies each question; config.branding.fromName and branding.purpose identify the originating product. Omitted mode selects voice; text mode is available. Requires a project API key or scoped OAuth. Optional projectId selects an owned account project; required when the account has several projects. Matching idempotency keys replay the existing handoff.

輸入參數config必填projectIdidempotencyKey必填

talkform.get_handoff

Check interview status

Checks a hosted handoff owned by the authorized project or OAuth account. Requires handoffs:read permission.

輸入參數id必填

talkform.get_result

Retrieve reviewed answers

Returns completed structured answers for an authorized project or OAuth account with handoffs:read permission. Pending results return result_pending. Results expire 7 days after submission. No transcript is returned.

輸入參數id必填

talkform.delete_handoff

Delete a hosted interview

Permanently deletes stored configuration and answers for an authorized project or OAuth account. Requires user confirmation and handoffs:delete permission.

輸入參數id必填

talkform.configure_webhook

Configure a completion webhook

Configures one HTTPS endpoint for completed handoffs in an authorized project. Replaces any active endpoint and returns the signing secret once. Requires handoffs:write permission. Optional projectId selects an owned OAuth account project.

輸入參數url必填projectId

talkform.get_webhook

Get completion webhook

Returns active webhook metadata and recent delivery metadata for an authorized project. Signing secrets are never returned. Requires handoffs:read permission. Optional projectId selects an owned OAuth account project.

輸入參數projectId

talkform.delete_webhook

Disable completion webhook

Disables an authorized project's active webhook and cancels pending deliveries. Requires handoffs:write permission. Optional projectId selects an owned OAuth account project.

輸入參數projectId

版本歷史

2
  1. v0.1.1最新Oct 29, 2026
  2. v0.1.0Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。

其他 Myprivacyagent 整合