让 Pallas 与你的 Agent 配合工作。

Engineering Alpha 0.1.4 的安装、授权与使用帮助。

安装指南

你需要 Python 3.12 或 3.13、macOS 或 Linux，以及支持的 Agent。当前完整测试包面向 macOS + Codex；Claude Code 使用独立配置路径。安装依赖需要联网。

你还需要通过测试安排取得 Pallas wheel 安装文件。本页没有公开下载或 PyPI 安装入口；以下步骤从已收到对应的 0.1.4 wheel 开始。已配置的测试包与源码构建版本可能有不同的授权前提。

新建 pallas-test 文件夹，将 wheel 放入其中，并在该目录打开终端。以 Python 3.13 为例：

python3.13 -m venv .venv
.venv/bin/python -m pip install ./pallas_ads-0.1.4-py3-none-any.whl

若安装的是 Python 3.12，请将首行改为 python3.12。配置完成后保留 .venv 文件夹。

为 Pallas 使用新建或空的项目目录。配置命令会写入项目内的配置、工作区、分析 Skills 和报告模板，不会自动替你登录媒体平台。

.venv/bin/pallas agent setup --client codex --directory "$PWD/codex-test"

在 Codex 中打开生成的项目并开始新任务。该通用命令不启用特殊的 Meta 测试路径；如需使用 Meta，请按所用宿主的已配置测试包说明操作。当前 Codex 路径使用预注册应用和本地 HTTPS 证书信任，不能套用 Claude Code 的流程。

.venv/bin/pallas agent setup --client claude --directory "$PWD/claude-test"

在 Claude Code 中打开生成的项目，审阅服务器权限；Meta 授权由宿主的官方 MCP 连接管理。

无需广告账户也可以运行示例，输出目录必须是新目录：

.venv/bin/pallas demo --output-dir "$PWD/demo-output"

这些是合成示例数据，不是真实广告账户结果。

Google Ads：使用已配置安装包的浏览器授权流程，并确认账户满足应用与 API 准入条件。源码构建版本可能需要另行配置应用。外部用户仍受应用及 Google Ads API 准入条件限制，实盘绩效对账验证仍有限。登录成功不会赋予你原本无权访问的账户权限。

Meta Ads：由宿主连接官方 MCP 并持有授权。宿主配置及应用受众限制仍然适用。Pallas 当前提供有限证据审阅；宿主的工具调用限制不会改变平台 OAuth 授权本身的范围。

TikTok Ads：使用官方 MCP 的浏览器授权路径。访问取决于账户权限与平台服务。存在报表分析实现，不代表每项实盘指标都已验证。

支持哪些 Agent？

当前有文档依据的接入是 Codex 与 Claude Code，配置和授权路径有所不同。图标不代表已接入 ChatGPT 对话网站。

Pallas 会调用大模型或自动优化投放吗？

不会。你的 Agent 负责推理和交互，Pallas 提供本地工具与报告，不修改广告。

授权失败怎么办？

检查所选宿主、安装包版本和媒体账户权限，阅读错误信息及撤销授权未确认、凭据清理未完成等警告。重复重试不能解除应用准入限制。如需支持，请发送脱敏的错误描述，不要发送凭据。

能直接使用已有项目吗？

配置命令要求新建或空目录。不要为了强行配置而覆盖现有 Agent 设置。

如何撤销授权或删除数据？

请按数据删除页分别处理平台授权、本地或宿主凭据及报告副本。

如有任何问题，请通过电子邮件联系我们。请说明操作系统、Agent、Pallas 版本、媒体平台及简短的问题描述。示例中应移除 token、密码、账户标识和敏感广告数据。支持请求由开发者处理，不承诺固定响应时限。