跳转到主要内容

用户输入请求

配置 onUserInputRequest 处理器后,代理就可以通过 ask_user 工具向用户提问。
use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Contracts\CopilotSession;
use Revolution\Copilot\Types\UserInputRequest;
use Revolution\Copilot\Types\UserInputResponse;

Copilot::start(function (CopilotSession $session) {
    $response = $session->sendAndWait(prompt: '请询问用户喜欢的语言');
    dump($response->content());
}, config: [
    'model' => 'gpt-5',
    'onUserInputRequest' => function (UserInputRequest $request): UserInputResponse {
        // $request->question - 问题内容
        // $request->choices - 多选选项数组(可选)
        // $request->allowFreeform - 是否允许自由输入(默认: true)

        dump("Question from agent: {$request->question}");
        if ($request->choices) {
            dump('Choices: '.implode(', ', $request->choices));
        }

        // 返回用户的回答
        return new UserInputResponse(
            answer: 'PHP',
            wasFreeform: true, // 是否是自由输入而非从选项中选择
        );
    },
]);

UserInputRequest 类

来自代理的用户输入请求。
属性类型说明
questionstring向用户提出的问题
choices?array多选时的选项(可选)
allowFreeform?bool是否允许自由输入(默认: true

UserInputResponse 类

对用户输入请求的响应。
属性类型说明
answerstring用户的回答
wasFreeformbool回答是否是自由输入(不是来自选项时为 true

实用示例

在交互式命令中使用的情形。
use Revolution\Copilot\Facades\Copilot;
use Revolution\Copilot\Contracts\CopilotSession;
use Revolution\Copilot\Types\UserInputRequest;
use Revolution\Copilot\Types\UserInputResponse;

// 在 Artisan 命令内
Copilot::start(function (CopilotSession $session) use ($command) {
    $response = $session->sendAndWait(prompt: '进行项目配置');
    $command->info($response->content());
}, config: [
    'onUserInputRequest' => function (UserInputRequest $request) use ($command): UserInputResponse {
        if ($request->choices) {
            // 有选项时使用 choice 方法
            $answer = $command->choice(
                $request->question,
                $request->choices,
                $request->choices[0] ?? null
            );

            return new UserInputResponse(answer: $answer, wasFreeform: false);
        }

        // 自由输入
        $answer = $command->ask($request->question);

        return new UserInputResponse(answer: $answer, wasFreeform: true);
    },
]);
最新信息请参考 GitHub 仓库
最后修改于 2026年7月13日