用途:面向 Go 开发者,通过 telnyx-go SDK 调用 Telnyx AI Assistants 接口,构建和运维带有自定义指令、知识库与工具集成的 AI 语音助手。
安装与初始化:使用 go get github.com/team-telnyx/telnyx-go 安装,导入 telnyx 包与 option 包,通过 telnyx.NewClient(option.WithAPIKey(os.Getenv("TELNYX_API_KEY"))) 初始化客户端。
主要能力:创建助手(client.AI.Assistants.New,POST /ai/assistants,必填 Name、Instructions,可选 Tags、Model 等,Tools 对新集成已弃用);与助手对话(Chat,POST /ai/assistants/{assistant_id}/chat,必填 Content、ConversationId);创建助手测试(Tests.New,POST /ai/assistants/tests,必填 Name、Destination、Instructions、Rubric);以及获取、更新、列表、导入外部助手(Provider 枚举 elevenlabs、vapi、retell,需 ApiKeyRef)、标签管理、测试套件与运行记录查询等操作。
使用方式:电话号码须用 E.164 格式(如 +13125550001),需带 + 与国家代码;分页可用 ListAutoPaging() 自动迭代。需处理网络错误、401、403、404、422 与 429 等错误码,429 可用指数退避重试。未内联给出的参数、枚举、响应字段或 webhook 字段不应臆造,应先查 references/api-details.md。
限制:资料未提供收费、价格、平台支持范围与具体效果等信息;Tools 参数对新集成已弃用;文档内容以 SDK 用法与接口说明为主。