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

# 个人 Profile

> 读取你在 Dashboard Profile 保存的财务背景，作为 Agent 的个性化上下文。

<Note icon="sparkles">
  **可作为 MCP tool 调用**：`personal_profile` —— 可直接在 Claude / Cursor / 任意 MCP 客户端中调用。接入方式见 [MCP Server](/zh-CN/integration/mcp-server)。
</Note>

<Badge color="green" icon="circle-check">已上线</Badge>
 
<Badge color="gray" size="sm">免费 · 0 credits</Badge>

## 它为 Agent 做什么

`personal_profile` 返回你在 **Dashboard → Profile** 保存的财务背景：风险偏好、投资期限、基准币种和备注。Agent 需要按你的个人约束调整措辞、假设或组合分析时调用它。

这个工具只读。它不会修改你的 Profile，不会下单，也不会替你推断没填写的答案。如果你还没有保存 Profile，接口会返回 `data: null` 和 `200 OK`。

只返回你自己账号的 Profile 数据。

## 返回值

<ResponseField name="data" type="PersonalProfile | null" required>
  当前调用者自己账号的已保存 Profile；没有保存时为 `null`。

  <Expandable title="PersonalProfile fields">
    <ResponseField name="risk_preference" type="string" nullable>
      保存的风险偏好，例如 conservative 或 aggressive。
    </ResponseField>

    <ResponseField name="investment_horizon" type="string" nullable>
      保存的投资期限。
    </ResponseField>

    <ResponseField name="base_currency" type="string" required>
      Profile 使用的基准币种代码。默认 `USD`。
    </ResponseField>

    <ResponseField name="extra_notes" type="string" nullable>
      用来描述个人约束或偏好的备注。较长备注会缩短到 1,000 个字符。
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta.creditsUsed" type="number">始终为 `0` —— 这次读取免费。</ResponseField>
<ResponseField name="meta.remainingCredits" type="number">账号剩余 credits。</ResponseField>

```json title="200 OK · personal_profile" expandable theme={null}
{
  "data": {
    "risk_preference": "moderate",
    "investment_horizon": "5-10 years",
    "base_currency": "USD",
    "extra_notes": "Prefer diversified ETFs and avoid concentrated single-stock positions."
  },
  "meta": { "creditsUsed": 0, "remainingCredits": 100 }
}
```

```json title="200 OK · 未保存 Profile" expandable theme={null}
{
  "data": null,
  "meta": { "creditsUsed": 0, "remainingCredits": 100 }
}
```

## 说明

<Tip>
  用户问需要个人背景的问题时，先调用 `personal_profile`，如果还需要持仓上下文，再结合 [`personal_holdings`](/zh-CN/api/personal/holdings)。
</Tip>

<Warning>
  你账号下任何仍有效的 API key 或 Remote MCP URL 都可以读取这些已保存的 Profile 数据，直到你删除 Profile 或吊销对应凭证。
</Warning>

<Warning>
  Profile 值是用户保存的偏好和备注，是给 Agent 使用的上下文，不是经过核验的财务建议。
</Warning>

## 直接调用

<Accordion title="HTTP / SDK 示例" icon="terminal">
  <CodeGroup>
    ```typescript MCP (Claude / Cursor) theme={null}
    {
      "method": "tools/call",
      "params": {
        "name": "personal_profile",
        "arguments": {}
      }
    }
    ```

    ```python Python (HTTP) theme={null}
    import os, requests

    resp = requests.get(
        "https://api.llmquantdata.com/api/personal/profile",
        headers={"Authorization": f"Bearer {os.environ['LLMQUANT_API_KEY']}"},
    ).json()
    print(resp["data"])
    ```

    ```bash cURL theme={null}
    curl "https://api.llmquantdata.com/api/personal/profile" \
      -H "Authorization: Bearer $LLMQUANT_API_KEY"
    ```
  </CodeGroup>
</Accordion>

## 完整参数参考

<Accordion title="全部请求参数" icon="sliders">
  这个接口不接受请求参数。
</Accordion>

## 相关接口

<Columns cols={2}>
  <Card title="个人持仓" icon="wallet" href="/zh-CN/api/personal/holdings">
    读取 Dashboard Profile 中保存的持仓。
  </Card>

  <Card title="MCP Server 接入" icon="plug" href="/zh-CN/integration/mcp-server">
    60 秒接入 Claude / Cursor / 任意 agent harness。
  </Card>
</Columns>