开始使用
以已连接的 PyAI 工具模式作为事实来源;客户端可以给工具 ID 添加服务器名称前缀。如果 PyAI 断开连接,请引导用户前往宿主浏览器的登录页面。不要将凭据保留在聊天记录中。尊重所选项目和用户授权的任务。
工具:get_started、discover_tools、whoami
首先调用 get_started 获取当前的集成指南,然后针对用户的用例调用 discover_tools。在执行项目操作之前,请使用 whoami 确认选定的工作区和已授予的作用域;不要仅仅为了证明连接状态而读取项目数据。
如需进行连接检查,仅需使用 get_started 和查询参数为 TTS 的 discover_tools。报告它们是否成功,无需生成音频或创建资源。
对于应用开发,在编写请求字段前请查阅 https://api.pyai.com/openapi.json 和 https://docs.pyai.com。对实时媒体会话请使用官方 SDK。优先使用用户已有的文件和 ID;不要在已连接的项目中编造示例客户数据。
作用域错误需要适当的项目同意;信用额度错误需要用户采取行动。不要对两者进行循环重试。CLI 回退及设置:https://pyai.com/cli 和 https://pyai.com/mcp。