Loading...
  • Bangun
  • Admin
  • Model & harga
  • Client SDK
  • Referensi API
Search...
⌘K
Log in
Menambahkan file
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...

Solutions

  • AI agents
  • Code modernization
  • Coding
  • Customer support
  • Education
  • Financial services
  • Government
  • Life sciences

Partners

  • Amazon Bedrock
  • Google Cloud's Vertex AI

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Company

  • Anthropic
  • Careers
  • Economic Futures
  • Research
  • News
  • Responsible Scaling Policy
  • Security and compliance
  • Transparency

Learn

  • Blog
  • Courses
  • Use cases
  • Connectors
  • Customer stories
  • Engineering at Anthropic
  • Events
  • Powered by Claude
  • Service partners
  • Startups program

Help and security

  • Availability
  • Status
  • Support
  • Discord

Terms and policies

  • Privacy policy
  • Responsible disclosure policy
  • Terms of service: Commercial
  • Terms of service: Consumer
  • Usage policy
Bangun/Delegasikan pekerjaan ke agen Anda

Menambahkan file

Unggah file dan pasang di kontainer sesi Anda untuk membaca dan memproses.

Anda dapat menyediakan file ke agen Anda dengan mengunggahnya melalui Files API dan memasangnya di kontainer sesi.

Semua permintaan Managed Agents API memerlukan header beta managed-agents-2026-04-01. SDK menetapkan header beta secara otomatis.

Mengunggah file

Pertama, unggah file menggunakan Files API:

file = client.beta.files.upload(file=Path("data.csv"))
print(f"File ID: {file.id}")

Memasang file dalam sesi

Pasang file yang telah diunggah ke dalam kontainer dengan menambahkannya ke array resources saat membuat sesi:

mount_path bersifat opsional, tetapi pastikan file yang diunggah memiliki nama deskriptif sehingga agen tahu apa yang dicarinya.

file_id baru akan dibuat yang mereferensikan instansi file dalam sesi. Salinan ini tidak dihitung terhadap batas penyimpanan Anda.

Beberapa file

Pasang beberapa file dengan menambahkan entri ke array resources:

Maksimal 100 file didukung per sesi.

Mengelola file dalam sesi yang sedang berjalan

Anda dapat menambah atau menghapus file dari sesi setelah pembuatan menggunakan API sumber daya sesi. Setiap sumber daya memiliki id yang dikembalikan saat ditambahkan (atau terdaftar), yang Anda gunakan untuk penghapusan.

Daftar semua sumber daya dalam sesi dengan resources.list. Untuk menghapus file, panggil resources.delete dengan ID sumber daya:

Mendaftar dan mengunduh file sesi

Gunakan Files API untuk mendaftar file yang dibatasi pada sesi dan mengunduhnya.

Jenis file yang didukung

Agen dapat bekerja dengan jenis file apa pun, termasuk:

  • Kode sumber (.py, .js, .ts, .go, .rs, dll.)
  • File data (.csv, .json, .xml, .yaml)
  • Dokumen (.txt, .md)
  • Arsip (.zip, .tar.gz) - agen dapat mengekstrak ini menggunakan bash
  • File biner - agen dapat memproses ini dengan alat yang sesuai

Jalur file

File yang dipasang dalam kontainer adalah salinan baca-saja. Agen dapat membacanya tetapi tidak dapat memodifikasi file asli yang diunggah. Untuk bekerja dengan versi yang dimodifikasi, agen menulis ke jalur baru dalam kontainer.

  • File dipasang di jalur yang tepat yang Anda tentukan
  • Direktori induk dibuat secara otomatis
  • Jalur harus absolut (dimulai dengan /)

Was this page helpful?

  • Mengunggah file
  • Memasang file dalam sesi
  • Beberapa file
  • Mengelola file dalam sesi yang sedang berjalan
  • Mendaftar dan mengunduh file sesi
  • Jenis file yang didukung
  • Jalur file
session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    resources=[
        {
            "type": "file",
            "file_id": file.id,
            "mount_path": "/workspace/data.csv",
        },
    ],
)
resources = [
    {"type": "file", "file_id": "file_abc123", "mount_path": "/workspace/data.csv"},
    {"type": "file", "file_id": "file_def456", "mount_path": "/workspace/config.json"},
    {"type": "file", "file_id": "file_ghi789", "mount_path": "/workspace/src/main.py"},
]
resource = client.beta.sessions.resources.add(
    session.id,
    type="file",
    file_id=file.id,
)
print(resource.id)  # "sesrsc_01ABC..."
listed = client.beta.sessions.resources.list(session.id)
for entry in listed.data:
    print(entry.id, entry.type)

client.beta.sessions.resources.delete(resource.id, session_id=session.id)
# List files associated with a session
files = client.beta.files.list(
    scope_id="sesn_abc123",
    betas=["managed-agents-2026-04-01"],
)
for f in files:
    print(f.id, f.filename)

# Download a file
content = client.beta.files.download(files.data[0].id)
content.write_to_file("output.txt")