PHPackages                             jeeinn/qf\_app\_builder - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. jeeinn/qf\_app\_builder

ActiveLibrary[API Development](/categories/api)

jeeinn/qf\_app\_builder
=======================

qianfan app builder php sdk base on openApi

v1.1.0(2y ago)113MITPHPPHP ^7.4|^8.0

Since Apr 30Pushed 2y ago1 watchersCompare

[ Source](https://github.com/jeeinn/qf_app_builder)[ Packagist](https://packagist.org/packages/jeeinn/qf_app_builder)[ RSS](/packages/jeeinn-qf-app-builder/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (2)Versions (5)Used By (0)

qf\_app\_builder
================

[](#qf_app_builder)

qianfan AppBuilder openApi sdk wrapper

百度千帆 AppBuilder openApi sdk wrapper

官方文档地址：

安装
--

[](#安装)

```
composer require jeeinn/qf_app_builder
```

示例
--

[](#示例)

```
require_once __DIR__ . '/vendor/autoload.php';
use Jeeinn\QfAppBuilder\Agent;
use Jeeinn\QfAppBuilder\Utils;
$appId = 'your app id';
$appToken = 'your app token';

// 创建会话
$agent = new Agent($appId, $appToken);
$conversationId = $agent->newConversation();
echo Utils::formatMsg("conversation_id created, conversation_id: {$conversationId}");

// 上传文件
// 注意，在实际测试中发现传入的路径需包含后缀名称 2024/5/9
// 否则千帆会报错：未知文件类型
$fileId = $agent->uploadFile(__DIR__ . '/your_test_file.xlsx', $conversationId);
echo Utils::formatMsg("file uploaded, file id: {$fileId}");

// 对话
$query = "我该如何描述和总结表格中的数据？";
$answer = $agent->talk($conversationId, $query, $fileId);
echo Utils::formatMsg("answer: {$answer}");

// 流式对话
$query = '你好，你是如何对我的数据进行安全处理的？';
ob_end_flush();
ob_start();
$answer = $agent->talkStream($conversationId, $query, null, function ($eventMsg){
    echo Utils::formatMsg($eventMsg);
    ob_flush();
    flush();
}, function ($errInfo){
    echo Utils::formatMsg($errInfo);
    ob_flush();
    flush();
});

echo Utils::formatMsg("answer: {$answer}");
```

测试用例
----

[](#测试用例)

请先修改 `tests/AgentTest.php` 中的 $appId 和 $appToken 参数

```
./vendor/bin/phpunit --filter testComplete tests/
```

#### 单元测试

[](#单元测试)

```
PHPUnit 9.6.19 by Sebastian Bergmann and contributors.

.                                                                   1 / 1 (100%)[2024-04-30 11:43:42] conversation_id created, conversation_id: 19a40e06-1729-42e1-a039-a37bbcdf80a5
[2024-04-30 11:43:43] file uploaded, file id: b6c06579-2523-4db6-a795-92d60a609657
[2024-04-30 11:43:54] answer: 为了描述和总结表格中的数据，首先需要明确表格的内容和目的。你可以使用以下步骤来进行描述和总结：

1. **理解数据**：首先，仔细阅读表格中的数据，了解每列和每行的含义。确定表格的主要目的和展示的信息。
2. **确定关键指标**：从表格中找出关键指标或重要数据。这些指标可能是销售额、增长率、市场份额等，根据表格的目的和内容来确定。
3. **描述数据**：使用简洁明了的语言描述表格中的数据。可以描述数据的整体趋势、分布或异常值等。
4. **总结数据**：在描述的基础上，对数据进行总结。可以指出数据的主要特点、亮点或需要关注的问题。
5. **使用图表辅助**：如果可能的话，可以使用图表来辅助描述和总结数据。图表可以更直观地展示数据的趋势和关系。

请注意，具体的描述和总结方式可能因表格的内容和目的而有所不同。如果你能提供具体的表格或数据示例，我可以为你提供更具体的建议。

Time: 00:12.963, Memory: 8.00 MB
```

方法列表
----

[](#方法列表)

- newConversation()
- uploadFile($filePath, $conversationId)
- talk($conversationId, $query, $fileId)
- talkStream($conversationId, $query, $fileId, $callback, $callbackErr)

> 其中 talkStream() 方法暂时废弃，并没有很好的解决 stream 模式下的数据乱序问题，请使用 talk() 方法。

有能力和精力的话，希望有人可以帮忙重新实现这个方法。

2024/5/9： 测试 `talkStream()` 方法已经可以正常调用，方便自己重新组装 [EventStream](https://developer.mozilla.org/zh-CN/docs/Web/API/Server-sent_events/Using_server-sent_events) 数据流。

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Total

4

Last Release

735d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/b4c1467c33e60574b9120ed16208140d0edbae8ab77aa2f6c7badac1df7da71f?d=identicon)[jeeinn](/maintainers/jeeinn)

---

Top Contributors

[![jeeinn](https://avatars.githubusercontent.com/u/13930054?v=4)](https://github.com/jeeinn "jeeinn (12 commits)")

---

Tags

sdkwrapperqianfanapp-builder

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/jeeinn-qf-app-builder/health.svg)

```
[![Health](https://phpackages.com/badges/jeeinn-qf-app-builder/health.svg)](https://phpackages.com/packages/jeeinn-qf-app-builder)
```

###  Alternatives

[openai-php/laravel

OpenAI PHP for Laravel is a supercharged PHP API client that allows you to interact with the Open AI API

3.7k7.6M74](/packages/openai-php-laravel)[mailchimp/transactional

458.9M16](/packages/mailchimp-transactional)[crowdin/crowdin-api-client

PHP client library for Crowdin API v2

611.5M5](/packages/crowdin-crowdin-api-client)[kronusme/dota2-api

DotA 2 Web API PHP wrapper

4782.7k](/packages/kronusme-dota2-api)[yoti/yoti-php-sdk

Yoti SDK for quickly integrating your PHP backend with Yoti

27539.9k1](/packages/yoti-yoti-php-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)