> ## Documentation Index
> Fetch the complete documentation index at: https://phaseo.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 实用指南

> 使用 Phaseo 构建应用的实用场景指南。

明确要构建什么，并需要从设置到验证的可用流程时，可使用本指南。

## 从一个可用请求开始

<Columns cols={2}>
  <Card title="使用免费路由器上线" icon="route" href="./free-router-first-deploy.mdx">
    无需先选择或充值某个特定模型，即可发送真实请求。
  </Card>

  <Card title="构建 Next.js 网页聊天应用" icon="message-square" href="./build-a-nextjs-web-chat-app.mdx">
    构建浏览器聊天界面，同时将 Phaseo API 密钥保留在服务器端。
  </Card>

  <Card title="构建 Node REST 冒烟测试应用" icon="terminal" href="./build-a-node-rest-smoke-app.mdx">
    通过最精简的实用示例使用原始 HTTP 验证后端集成。
  </Card>

  <Card title="使用 Python 构建网关 CLI" icon="terminal-square" href="./build-a-python-gateway-cli.mdx">
    使用 Python SDK 构建命令行工作流。
  </Card>
</Columns>

<Tip>
  想让编程 Agent 搭建项目框架？请从[迷你应用入门提示词](./mini-app-starter-prompts.mdx)开始。
</Tip>

## 按目标选择指南

<Columns cols={2}>
  <Card title="构建应用" icon="layout-template" href="./build-a-nextjs-web-chat-app.mdx">
    查看浏览器应用、经过身份验证的工作台、后端脚本和 CLI 的完整教程。
  </Card>

  <Card title="控制路由和策略" icon="route" href="./preset-rollout-and-routing-debug.mdx">
    逐步推出预设、选择供应商、落实数据驻留要求并控制 API 密钥。
  </Card>

  <Card title="搜索并返回结构化数据" icon="search-check" href="./sdk-typescript-managed-search.mdx">
    通过网页搜索或抓取为请求提供依据，然后验证并修复结构化输出。
  </Card>

  <Card title="从 Agent SDK 入手" icon="bot" href="./agent-sdk-durable-loop.mdx">
    使用 TypeScript、Python、Go、C#、Java、PHP 或 Ruby 构建受限的工具循环。
  </Card>

  <Card title="构建高级 Agent 工作流" icon="workflow" href="./agent-sdk-research-brief.mdx">
    添加研究、人工审核、并行工具、结构化输出和编程工作流。
  </Card>
</Columns>

## 热门指南

* [按价格、延迟或吞吐量对供应商排序](./sort-providers-by-price-latency-or-throughput.mdx)
* [仅路由到欧盟或 ZDR 供应商](./route-only-to-eu-or-zdr-providers.mdx)
* [修复格式错误的结构化 JSON](./response-healing-for-structured-json.mdx)
* [使用 Agent 驱动的网页搜索进行研究](./agent-sdk-research-brief.mdx)
* [并行运行本地 Agent 工具](./agent-sdk-parallel-tools.mdx)

## 相关指南

* [快速入门](../quickstart.mdx)
* [示例](../guides/examples.mdx)
* [路由与回退](../guides/routing-and-fallbacks.mdx)
* [Agent SDK 概览](../sdk-reference/agent-sdk/overview.mdx)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.