ARTICLE DETAIL

资讯详情

深耕编程入门与网站建设的一线实战洞察。

Automatisch 接入 Together AI:Connection 配置完整指南

Automatisch 接入 Together AI:Connection 配置完整指南 Automatisch 接入 Together AIConnection 配置完整指南【免费下载链接】automatischThe open source Zapier alternative. Build workflow automation without spending time and money.项目地址: https://gitcode.com/GitHub_Trending/au/automatisch本指南围绕 Automatisch 中 Together AI 集成的连接Connection配置展开基于 connection.md 官方文档并结合 packages/backend/src/apps/together-ai 源码深入讲解 API Key 的获取、表单字段语义、底层凭证校验机制以及连接完成后的实际用途。读完本文你将能够独立完成 Together AI 与 Automatisch 的连接配置并理解每个字段与校验步骤在源码中的真实作用。Together AI 集成概览Together AI 是一个提供开源大模型推理服务的平台通过其 API 可以调用语言、代码、图像等各类模型。在 Automatisch开源 Zapier 替代方案用于构建工作流自动化中Together AI 被实现为一个标准 App 集成支持连接Connection管理与两个动作ActionCreate chat completion查询聊天模型对话式补全见 actions.mdCreate completion查询语言、代码或图像模型普通补全。在源码层面该集成由 packages/backend/src/apps/together-ai/index.js 定义其关键配置如下export default defineApp({ name: Together AI, key: together-ai, baseUrl: https://together.ai, apiBaseUrl: https://api.together.xyz, iconUrl: {BASE_URL}/apps/together-ai/assets/favicon.svg, authDocUrl: {DOCS_URL}/apps/together-ai/connection, primaryColor: #000000, supportsConnections: true, beforeRequest: [addAuthHeader], auth, actions, dynamicData, });由此可知所有 API 请求统一发往https://api.together.xyzapiBaseUrl并且通过beforeRequest: [addAuthHeader]在每次请求前自动注入认证头。连接成功后你便可以在任意工作流中选择 Together AI 的两个动作之一来调用模型。配置 Connection 的前提获取 API KeyTogether AI 使用 API KeyBearer Token进行身份认证配置连接前必须先持有有效的 API Key登录 Together AI 控制台进入API Keys页面即文档中给出的https://api.together.ai/settings/api-keys路径点击创建Create生成新的 API Key复制生成的 Key 字符串供下一步在 Automatisch 中填写。注意API Key 是敏感凭证请妥善保管。在 Automatisch 中保存后该 Key 会被用于后续所有 Together AI 请求的Authorization头。在 Automatisch 中创建 Together AI 连接根据官方文档配置步骤如下在 Together AI 控制台的API Keys 页面复制你的 API Key在 Automatisch 中打开 Together AI 的连接创建界面将 Key 粘贴到API Key字段在Screen Name字段填写任意显示名称用于在 Automatisch 界面中标识该连接点击Save保存保存成功后即可在流程编排中使用 Together AI 集成。保存时Automatisch 会立即校验凭证的有效性见下文“凭证校验”一节校验通过后连接才可用。表单字段源码解读连接表单的两个字段定义在 packages/backend/src/apps/together-ai/auth/index.js与文档中的步骤一一对应字段 Key显示名称类型必填说明screenNameScreen Namestring是该连接在 Automatisch 界面中显示的名称仅用于展示apiKeyAPI Keystring是你的 Together AI 账户 API Key用于鉴权源码中两个字段都设置为required: true必填、readOnly: false可编辑并且apiKey字段带有指向https://automatisch.io/docs/together-ai#api-key的docUrl帮助链接。这意味着你无法在未填写 API Key 或屏幕名称的情况下保存连接。认证头注入原理保存连接后Automatisch 在每次向 Together AI 发起请求时都会先经过beforeRequest钩子。其实现位于 packages/backend/src/apps/together-ai/common/add-auth-header.jsconst addAuthHeader ($, requestConfig) { if ($.auth.data?.apiKey) { requestConfig.headers.Authorization Bearer ${$.auth.data.apiKey}; } return requestConfig; };逻辑非常清晰只要连接数据中保存了apiKey就会将其以Bearer apiKey的形式写入请求的Authorization头若没有 API Key 则不注入。因此API Key 的填写质量直接决定了所有后续模型调用是否能够通过鉴权。凭证校验保存与持续可用的保证Automatisch 对连接凭证提供两层校验都定义在 packages/backend/src/apps/together-ai/auth 目录下。保存时的即时校验verifyCredentials当你在表单中点击 Save 时Automatisch 会调用 verify-credentials.jsconst verifyCredentials async ($) { await $.http.get(/v1/models); };它向https://api.together.xyz/v1/models发送一次GET请求。该请求会携带addAuthHeader注入的 Bearer Token若 API Key 有效接口正常返回模型列表校验通过、连接创建成功若 Key 无效或过期请求失败连接创建会被拒绝并提示错误。这解释了为什么文档要求“先复制 Key、再粘贴、后保存”——保存动作本身就是一次鉴权测试。运行期的持续校验isStillVerified除了保存时校验Automatisch 还会在连接使用期间定期检查凭证是否仍然有效对应 is-still-verified.jsconst isStillVerified async ($) { await $.http.get(/v1/models); return true; };逻辑与保存时校验一致再次调用/v1/models端点请求成功即返回true。这意味着如果你的 API Key 被撤销、过期或账户欠费Automatisch 会在后续检查中识别到连接失效避免工作流在运行时静默失败。连接成功后的应用模型动作与动态数据连接保存并校验通过后就可以在 Automatisch 的工作流中使用 Together AI 的两个动作。所有动作的模型选择都依赖动态数据源 packages/backend/src/apps/together-ai/dynamic-data/list-models/index.js它会调用/v1/models并返回{ value: model.id, name: model.display_name }形式的模型下拉选项。也就是说你在动作配置里看到的模型下拉列表是运行时从 Together AI 实时拉取的。Create chat completion创建聊天补全定义于 create-chat-completion/index.js向POST /v1/chat/completions发送请求。可配置参数包括参数类型必填说明Modeldropdown是从动态数据拉取的模型列表中选择Messagesdynamic是对话消息列表每条含 Rolesystem / user / assistant与 ContentTemperaturestring否0-1 的随机度越低越偏向确定性与正确性越接近 1 输出越随机Maximum tokensstring否生成的最大 token 数量Stop sequencesdynamic否字符串序列列表生成到该 token 时停止输出Top Pstring否核采样阈值按累积概率过滤低概率 tokenTop Kstring否限制每步候选 token 数量的整数Frequency Penaltystring否-2.0 到 2.0正值降低已出现 token 的重复概率Presence Penaltystring否-2.0 到 2.0正值提高模型谈论新话题的概率源码中通过castFloatOrUndefined将空字符串转为undefined不发送该字段其余数值参数会被parseFloat后以蛇形命名max_tokens、top_p、top_k、presence_penalty、frequency_penalty组装进请求体。Create completion创建补全定义于 create-completion/index.js向POST /v1/completions发送请求。与聊天补全的区别在于使用单一Prompt字符串字段替代 Messages适用于语言、代码或图像模型的一次性补全。其余参数Temperature、Maximum tokens、Stop sequences、Top P、Top K、Frequency Penalty、Presence Penalty与聊天补全完全一致。两个动作执行成功后都会通过$.setActionItem({ raw: data })将接口原始响应作为动作输出供工作流中后续步骤通过变量引用。常见问题与排错保存时提示凭证无效API Key 复制不完整、Key 已撤销或账户权限不足。请回到 Together AI API Keys 页面重新生成并复制完整 Key 后再保存。工作流运行返回 401/403连接过期或 Key 被吊销触发isStillVerified失败。请编辑该连接更新为新的 API Key 后重新保存。模型下拉列表为空说明/v1/models请求失败通常是 API Key 无效所致请先检查连接状态。总结Together AI 的 Connection 配置虽只有两步表单但背后由「保存时即时校验 运行期持续校验 请求头自动注入」三套机制共同保障。理解 auth/index.js 中的字段定义、verify-credentials.js 与 is-still-verified.js 的校验逻辑以及 add-auth-header.js 的 Bearer 注入方式即可在 Automatisch 中稳定地使用 Together AI 完成各类模型驱动的自动化流程。【免费下载链接】automatischThe open source Zapier alternative. Build workflow automation without spending time and money.项目地址: https://gitcode.com/GitHub_Trending/au/automatisch创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表