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 集成