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

# 文件上传

> 了解如何将 Anthropic 的 Files API 与 Agno 一起使用。

使用 Anthropic 的 [Files API](https://docs.anthropic.com/en/docs/build-with-claude/files)，您可以上传文件并在其他 API 调用中引用它们。
当同一流程中多次引用文件时，这会很方便。

## 用法

<Steps>
  <Step title="上传文件">
    初始化 Anthropic 客户端并使用 `client.beta.files.upload`：

    ```python theme={null}
    from anthropic import Anthropic

    file_path = Path("path/to/your/file.pdf")

    client = Anthropic()
    uploaded_file = client.beta.files.upload(file=file_path)
    ```
  </Step>

  <Step title="初始化 Claude 模型">
    初始化 `Claude` 模型时，传递必要的 beta 标头：

    ```python theme={null}
    from agno.agent import Agent
    from agno.models.anthropic import Claude

    agent = Agent(
        model=Claude(
            id="claude-opus-4-20250514",
            default_headers={"anthropic-beta": "files-api-2025-04-14"},
        )
    )
    ```
  </Step>

  <Step title="引用文件">
    您现在可以在与 Agno 代理交互时引用已上传的文件：

    ```python theme={null}
    agent.print_response(
        "Summarize the contents of the attached file.",
        files=[File(external=uploaded_file)],
    )
    ```
  </Step>
</Steps>

请注意，此功能附带一些存储限制。您可以在 Anthropic 的[文档](https://docs.anthropic.com/en/docs/build-with-claude/files#file-storage-and-limits)中了解更多相关信息。

## 工作示例

```python cookbook/models/anthropic/pdf_input_file_upload.py theme={null}
from pathlib import Path

from agno.agent import Agent
from agno.media import File
from agno.models.anthropic import Claude
from agno.utils.media import download_file
from anthropic import Anthropic

pdf_path = Path(__file__).parent.joinpath("ThaiRecipes.pdf")

# 使用 download_file 函数下载文件
download_file(
    "https://agno-public.s3.amazonaws.com/recipes/ThaiRecipes.pdf", str(pdf_path)
)

# 初始化 Anthropic 客户端
client = Anthropic()

# 将文件上传到 Anthropic
uploaded_file = client.beta.files.upload(
    file=Path(pdf_path),
)

if uploaded_file is not None:
    agent = Agent(
        model=Claude(
            id="claude-opus-4-20250514",
            default_headers={"anthropic-beta": "files-api-2025-04-14"},
        ),
        markdown=True,
    )

    agent.print_response(
        "Summarize the contents of the attached file.",
        files=[File(external=uploaded_file)],
    )
```