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

使用PromptQL Program API实现动态集成的新方式

PromptQL程序API为业务工作流带来了全新的灵活性和智能性。通过HTTP触发PromptQL计划，您可以轻松实现自动化流程或增强分析报告。这种API的引入，突破了PromptQL Playground聊天界面的限制，提供了无缝集成的可能性。

什么是PromptQL程序？

PromptQL程序是由LLM（任务的自动化。

PromptQL程序的主要功能包括：

调用Python函数读取、写入或搜索数据。
使用PromptQL代理持续生成高质量的程序，提升PromptQL的整体有效性。

PromptQL程序API规范

PromptQL程序API提供了简单的接口，以下是其主要规范：

API端点

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

请求头

Content-Type: application/json

请求正文示例

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

响应格式

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

使用PromptQL游乐场生成API代码

在PromptQL Playground中，您可以通过点击API按钮，快速生成交互所需的API代码。这种方式极大地简化了开发过程。

默认情况下，程序API使用短暂的Hasura DDN令牌进行身份验证。这种方式适用于测试和内部应用程序，但在生产环境中，建议采用更强大的身份验证机制。

配置生产环境的身份验证

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

通过以上设置，您可以确保只有授权用户能够与API交互，从而符合行业安全标准。

PromptQL程序API的实际应用场景

PromptQL程序API的引入，拓展了其在聊天界面之外的应用可能性。以下是一些典型的应用场景：

使用GitHub Webhooks自动生成摘要

在GitHub中设置Webhook，以在创建问题等事件时触发。
配置Webhook调用PromptQL程序API端点。
使用API按标签对问题进行分类或生成摘要，为团队提供即时洞察。

客户支持工作流程优化

触发PromptQL程序分析客户查询或生成响应草稿。
将API与票务系统集成，简化支持操作，提高效率。

电子商务数据分析

监控购物车活动或生成客户行为报告。
通过无服务器功能触发API，分析用户趋势并发送实时通知。

这些实际案例展示了PromptQL程序API如何帮助开发人员将其功能嵌入到不同的业务场景中，从而实现更高效的工作流。

总结

PromptQL程序API为开发人员提供了一种强大的工具，可以轻松实现动态集成和自动化任务。无论是用于数据分析、客户支持还是电子商务场景，这种API都能显著提升业务效率。如果您正在寻找一种灵活且智能的解决方案，不妨尝试探索PromptQL程序API的潜力。

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