PromptQL 程序 API：轻松实现动态集成与自动化工作流

作者：API传播员 · 2025-10-24 · 阅读时间：4分钟

PromptQL Program API通过HTTP触发实现动态集成，允许开发人员将LLM生成的Python程序集成到外部系统，自动化复杂任务，提升业务工作流的灵活性和智能性。

一. 什么是 PromptQL 程序？

PromptQL 程序是由大语言模型（LLM）生成的 Python 程序，用于读取、写入或搜索数据。它通常在 PromptQL Playground 的交互式会话中执行，但借助 PromptQL 程序 API，这些程序现在可以按需在外部系统中执行，实现自动化任务。

1. 主要功能

a. 调用 Python 函数读取、写入或搜索数据

b. 使用 PromptQL 代理持续生成高质量程序，提高整体有效性

二. PromptQL 程序 API 规范

PromptQL 程序 API 提供简单的接口，可通过 HTTP 请求触发 PromptQL 程序。

1. API 端点

POST https://api.promptql.pro.hasura.io/execute_program

2. 请求头

Content-Type: application/json

3. 请求正文示例

{
  "code": "",
  "promptql_api_key": "",
  "headers": {},
  "artifacts": []
}

4. 响应示例

{
  "output": "",
  "error": null,
  "modified_artifacts": [
    {
      "identifier": "my_artifact",
      "title": "我的工件",
      "artifact_type": "table",
      "data": [
        {"my_column": 1},
        {"my_column": 2}
      ]
    }
  ],
  "llm_uses": [
    {
      "provider": "anthropic"
    }
  ]
}

三. 使用 PromptQL Playground 生成 API 代码

在 PromptQL Playground 中，点击 API 按钮，即可快速生成交互所需的 API 代码，简化开发流程。

1. 身份验证配置

a. 测试与内部应用

默认使用短期 Hasura DDN 令牌，适合测试或内部应用。

b. 生产环境安全认证

在 Hasura DDN 元数据中添加 AuthConfig
定义令牌生成、过期规则及用户角色，确保安全访问

四. PromptQL 程序 API 的应用场景

PromptQL 程序 API 打破聊天界面限制，可嵌入多种业务场景，实现自动化和智能化操作。

1. GitHub Webhooks 自动生成摘要

a. 设置 GitHub Webhook，触发事件（如创建 Issue）

b. Webhook 调用 PromptQL 程序 API

c. 按标签分类或生成摘要，为团队提供即时洞察

2. 客户支持工作流程优化

a. 自动分析客户查询或生成响应草稿

b. 与票务系统集成，简化支持操作，提高效率

3. 电子商务数据分析

a. 监控购物车活动或生成客户行为报告

b. 使用无服务器功能触发 API，实时分析用户趋势并发送通知

五. 总结

PromptQL 程序 API 为开发者提供了灵活、智能的工具，可实现动态集成和自动化任务。无论是数据分析、客户支持还是电子商务场景，都能显著提升业务效率。

对于希望快速扩展自动化工作流或增强分析能力的开发者，探索 PromptQL 程序 API 是高效选择。

原文链接: https://hasura.io/blog/introducing-promptql-program-api-dynamic-integrations-made-simple