parlant

环境要求

• Python 环境，且 pip 可正常使用（README 用 pip install 安装）
• 能访问 PyPI 网络源以下载 parlant 包
• Python 环境支持 async/await 语法（示例代码使用 async with）

安装与启动步骤

1. 1安装 parlant

   在命令行执行 pip 安装。README 只给出这一条安装命令，未提供 Docker 或源码安装方式。

   pip install parlant

   复制

2. 2编写代理脚本

   按 README 示例导入 parlant.sdk，用 p.Server() 上下文创建服务器与客服代理，并定义观察与指导方针。

   import parlant.sdk as p
   
   async with p.Server():
       agent = await server.create_agent(
           name="Customer Support",
           description="Handles customer inquiries for an airline",
       )
   
       # Evaluate and call tools only under the right conditions
       expert_customer = await agent.create_observation(
           condition="customer uses financial terminology like DTI or amortization",
           tools=[research_deep_answer],
       )
   
       # When the expert observation holds, always respond
       # with depth. Set the guideline to automatically match
       # whenever the observation it depends on holds...
       expert_answers = await agent.create_guideline(
           matcher=p.MATCH_ALWAYS,
           action="respond with technical depth",
           dependencies=[expert_customer],
       )
   
       beginner_answers = await agent.create_guideline(
           condition="customer seems new to the topic",
           action="simplify and use concrete examples",
       )
   
       # When both match, beginners wins. Neither expert-level
       # tool-data nor instructions can enter the agent's context.
       await beginner_answers.exclude(expert_customer)

   复制

3. 3运行脚本

   把上一步代码保存为脚本文件后运行，启动 parlant 服务器并加载代理定义。文件名可自行修改。

   python main.py

   复制

4. 4完成完整快速上手

   README 指向官网 5 分钟 quickstart，按该链接的完整流程走一遍，补齐工具函数等未在 README 中给出的内容。

如何确认成功

脚本运行后 p.Server() 上下文正常启动且控制台无报错，即说明 parlant 已安装并可创建代理；完整功能按官网 quickstart 验证。

常见问题

注意事项

• README 仅提供 pip install parlant 一种安装方式，未涉及 Docker、源码编译或云服务部署。
• 示例代码中的 research_deep_answer 等工具需自行实现，直接复制运行可能报错。
• 完整上手请参考官网 5-minute quickstart：https://www.parlant.io/docs/quickstart/installation
• 遇到问题可加入官方 Discord 社区：https://discord.gg/duxWqxKk6J