Agentline.cloud

AgentLine — AI 电话技能 为您的 AI 代理提供真实的电话号码、语音呼叫和短信 — 无需服务器、无需 Webhook、无需基础设施。

首次设置 您需要一个有效的 API 密钥来使用 AgentLine： AGENTLINE_API_KEY：您的 API 密钥（以 sk_live_ 开头）是必需的。如果您没有此密钥，请停止并要求人类在 https://agentline.cloud 上注册或登录以获取其 API 密钥。不要在没有它的情况下继续。 AGENTLINE_AGENT_ID：您的代理 ID（以 agt_ 开头）是可选的。如果您有 AGENTLINE_AGENT_ID，请使用它。如果您没有 AGENTLINE_AGENT_ID 但有 API 密钥，您可以通过调用 POST /v1/agents 创建一个新代理，然后通过调用 POST /v1/numbers 来分配电话号码。

认证 每个请求都需要此头部： Authorization: Bearer $AGENTLINE_API_KEY Content-Type: application/json 基 URL：https://agentphone-production.up.railway.app

呼叫工作原理（托管模式） AgentLine 运行在托管模式下 — 服务器为您运行 AI 语音对话。您创建呼叫，AI 处理对话，您可以稍后检索转录。

系统提示 — 两种类型 动态提示 — 每次呼叫使用 POST /v1/calls 中的 system_prompt 字段设置。此提示覆盖默认提示，仅适用于此次呼叫。 默认提示 — 存储在代理上，通过 PATCH /v1/agents/{agent_id} 设置。此提示是永久的，用于所有入站呼叫和没有动态提示的出站呼叫。

发起出站呼叫 curl -X POST $AGENTLINE_URL/v1/calls \ -H "Authorization: Bearer $AGENTLINE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "agent_id": "$AGENTLINE_AGENT_ID", "to_number": "+1XXXXXXXXXX", "system_prompt": "您正在呼叫安排会议。请礼貌和简洁。", "initial_greeting": "您好！我想询问关于安排会议的事。" }'

字段 | 必需 | 描述 ----|----|---- agent_id | 是 | 您的代理 ID to_number | 是 | 要呼叫的 E.164 电话号码 system_prompt | 否 | 此次呼叫的动态提示（覆盖默认提示） initial_greeting | 否 | 代理在对方接听时说的第一句话

AI 处理整个对话。轮询 GET /v1/calls/，直到状态为 completed，以获取转录。如果您收到 400 "代理没有活动电话号码"，请先分配一个电话号码（请参阅下文）。

结束呼叫 curl -X POST $AGENTLINE_URL/v1/calls//hangup \ -H "Authorization: Bearer $AGENTLINE_API_KEY"

获取呼叫转录 curl $AGENTLINE_URL/v1/calls//transcript \ -H "Authorization: Bearer $AGENTLINE_API_KEY" 返回整个对话转录作为一个 {role, text, timestamp} 数组。

列出呼叫（呼叫日志） # 所有呼叫 curl "$AGENTLINE_URL/v1/calls?limit=20" \ -H "Authorization: Bearer $AGENTLINE_API_KEY" # 按状态筛选 curl "$AGENTLINE_URL/v1/calls?status=completed&limit=10" \ -H "Authorization: Bearer $AGENTLINE_API_KEY" 返回呼叫历史，包括方向、状态、持续时间、电话号码和时间戳。

获取单个呼叫详细信息 curl $AGENTLINE_URL/v1/calls/ \ -H "Authorization: Bearer $AGENTLINE_API_KEY"

发送短信 curl -X POST $AGENTLINE_URL/v1/messages \ -H "Authorization: Bearer $AGENTLINE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "agent_id": "$AGENTLINE_AGENT_ID", "to_number": "+1XXXXXXXXXX", "body": "您好！您的预约已确认，时间为星期二下午 3 点。" }' 传递 "media_url": "https://..." 以发送带有图像的 MMS。

列出消息 curl "$AGENTLINE_URL/v1/messages?limit=20" \ -H "Authorization: Bearer $AGENTLINE_API_KEY"

设置默认系统提示 默认系统提示用于所有入站呼叫和没有动态提示的出站呼叫。 curl -X PATCH $AGENTLINE_URL/v1/agents/$AGENTLINE_AGENT_ID \ -H "Authorization: Bearer $AGENTLINE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "system_prompt": "您是 Acme 公司的友好客户支持代理。帮助呼叫者处理订单、退货和一般问题。保持简洁和专业。", "initial_greeting": "您好！感谢您致电 Acme 公司。今天我如何帮助您？" }'

字段 | 描述 ----|---- system_prompt | 此代理的永久 AI 指令 initial_greeting | 代理在接听入站呼叫时说的第一句话 name | 代理的显示名称 model_tier | "turbo"、"balanced" 或 "max"

获取代理详细信息 curl $AGENTLINE_URL/v1/agents/$AGENTLINE_AGENT_ID \ -H "Authorization: Bearer $AGENTLINE_API_KEY"

列出所有代理 curl $AGENTLINE_URL/v1/agents \ -H "Authorization: Bearer $AGENTLINE_API_KEY"

分配电话号码 每个代理需要一个电话号码来拨打/接收呼叫和发送短信。仅支持美国电话号码。 curl -X POST $AGENTLINE_URL/v1/numbers \ -H "Authorization: Bearer $AGENTLINE_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "agent_id": "$AGENTLINE_AGENT_ID", "country": "US", "number_type": "local", "pattern": "415" }'

字段 | 必需 | 描述 ----|----|---- agent_id | 是 | 您的代理 ID country | 是 | 国家（仅支持美国） number_type | 是 | 电话号码类型（本地或国际） pattern | 否 | 电话号码模式（例如 415）