Lewati ke konten utama

Gunakan Claude untuk Microsoft 365 dengan platform pihak ketiga

Jika organisasi Anda menggunakan AWS Bedrock, Google Cloud Vertex AI, atau gateway LLM untuk mengakses Claude, Anda dapat menggunakan add-in Claude untuk Excel, Claude untuk PowerPoint, Claude untuk Word, dan Claude untuk Outlook tanpa akun Claude. Add-in terhubung melalui infrastruktur organisasi Anda, sehingga prompt dan respons Anda tetap berada dalam batas kepercayaan yang ada.

Ada empat jalur koneksi, tergantung pada cara organisasi Anda mengakses Claude:

  • Gateway LLM: Add-in mengirimkan permintaan ke gateway Anda (LiteLLM, Portkey, Kong, dll.), yang merutekannya ke penyedia pilihan Anda. Ini adalah pola yang sama yang digunakan oleh Claude Code. Jika organisasi Anda sudah menjalankan Claude Code melalui gateway LLM, Anda dapat mengarahkan add-in Office ke endpoint yang sama—tidak diperlukan infrastruktur baru.

  • Bedrock langsung: Add-in melakukan autentikasi melalui Microsoft Entra ID dan memanggil AWS Bedrock secara langsung, tanpa gateway di antaranya.

  • Vertex AI langsung: Add-in melakukan autentikasi melalui Google OAuth dan memanggil Vertex AI secara langsung.

  • Foundry langsung: Add-in melakukan autentikasi melalui sumber daya Azure AI Foundry Anda secara langsung menggunakan kunci API-nya.

Admin IT Anda memilih jalur selama penyebaran. Sebagai pengguna akhir, pengalaman sama terlepas dari jalur mana yang digunakan organisasi Anda.


Persyaratan

Persyaratan bervariasi menurut jalur koneksi.

Semua jalur:

  • Claude untuk Excel, Claude untuk PowerPoint, Claude untuk Word, atau Claude untuk Outlook terpasang (dari Microsoft AppSource atau disebarkan oleh admin Anda)

  • Microsoft 365 dengan Entra ID (untuk persetujuan admin dan, di jalur cloud langsung, penerbitan token)

  • Persetujuan admin Microsoft Graph untuk Mail.ReadWrite, Calendars.Read, People.Read, dan User.Read (melalui aplikasi Anthropic atau pendaftaran aplikasi Entra Anda sendiri).

Gateway LLM:

  • URL gateway dan token API dari tim IT Anda

Bedrock langsung:

  • Akun AWS dengan akses model Claude diaktifkan di wilayah target

  • Penyedia identitas OIDC IAM dan peran yang dikonfigurasi untuk mempercayai token Microsoft Entra ID

Vertex AI langsung:

  • Proyek Google Cloud dengan API Vertex AI diaktifkan dan akses model Claude di wilayah target

  • Klien Google OAuth yang dikonfigurasi dengan URI pengalihan add-in

Foundry langsung:

  • Sumber daya Azure AI Foundry dengan setidaknya satu model Claude yang disebarkan (Claude Opus 4.6, Opus 4.5, Sonnet 4.6, atau Sonnet 4.5)

  • Nama penyebaran harus dibiarkan sebagai ID model default (misalnya claude-opus-4-6); nama penyebaran khusus belum didukung. Adapter menyelidiki berdasarkan ID model, jadi penyebaran yang diganti nama tidak akan ditemukan.

  • Kunci API sumber daya, dari Azure Portal → sumber daya Foundry Anda → Keys and Endpoint → KEY 1

Tim IT organisasi Anda mengelola sumber daya ini. Jika Anda tidak memiliki kredensial yang Anda butuhkan, hubungi mereka—Anthropic tidak dapat menyediakan atau mengatur ulang untuk Anda.


Daftar izin jaringan

Add-in perlu menjangkau domain tertentu untuk berfungsi. Domain mana yang tergantung pada apakah organisasi Anda menggunakan API Anthropic secara langsung (1P) atau platform pihak ketiga (3P). Bagikan tabel yang berlaku dengan tim jaringan atau keamanan Anda sehingga mereka dapat menambahkan domain ini ke daftar izin.

Penting: Di semua konfigurasi—termasuk pihak ketiga—prompt Anda dan respons Claude hanya bepergian ke penyedia inferensi pilihan Anda (gateway, Bedrock, Vertex AI, atau Azure AI Foundry Anda). Domain yang tercantum di bawah yang menunjuk ke Anthropic (seperti pivot.claude.ai) melayani antarmuka add-in, konfigurasi fitur, dan telemetri operasional. Mereka tidak membawa konten prompt atau respons.

API Anthropic (1P)

Gunakan tabel ini jika orang-orang di organisasi Anda masuk dengan akun Claude dan inferensi pergi ke api.anthropic.com.

Domain

Diperlukan saat

Tujuan

pivot.claude.ai

Selalu

Host add-in. Melayani UI panel tugas dan proxy analitik, pencarian ikon, unduhan keterampilan, dan telemetri.

claude.ai

Selalu

Masuk OAuth Anthropic dan evaluasi bendera fitur.

api.anthropic.com

Selalu

API inferensi Claude, unggahan file, kontainer eksekusi kode, dan registri konektor MCP.

appsforoffice.microsoft.com

Selalu

Skrip runtime Microsoft Office.js. Diperlukan oleh setiap add-in Office.

o1158394.ingest.us.sentry.io

Opsional

Pelaporan kerusakan dan kesalahan. Memblokir ini hanya mengurangi diagnostik; add-in masih berfungsi.

mcp-proxy.anthropic.com

Jika menggunakan konektor MCP

Proxy untuk panggilan alat konektor MCP.

bridge.claudeusercontent.com

Jika menggunakan bekerja lintas aplikasi

Jembatan WebSocket untuk fitur bekerja lintas aplikasi.

Platform pihak ketiga (3P)

Gunakan tabel ini jika orang-orang di organisasi Anda masuk dengan Microsoft Entra ID dan inferensi menuju ke gateway LLM, Bedrock, atau Vertex AI Anda.

Domain

Diperlukan saat

Tujuan

pivot.claude.ai

Selalu

Host add-in. Melayani UI panel tugas dan proxy analitik, pencarian ikon, dan telemetri.

claude.ai/api/

Selalu

Evaluasi bendera fitur. Tanpa masuk; add-in hanya mengambil konfigurasinya dari sini.

appsforoffice.microsoft.com

Selalu

Skrip runtime Microsoft Office.js (diperlukan oleh setiap add-in Office).

login.microsoftonline.com

Selalu

Masuk Microsoft Entra ID melalui Nested App Auth. Membaca konfigurasi gateway yang disediakan admin dan mengeluarkan token untuk autentikasi cloud langsung.

o1158394.ingest.us.sentry.io

Opsional

Pelaporan kerusakan dan kesalahan. Memblokir ini hanya mengurangi diagnostik; add-in masih berfungsi.

URL gateway LLM Anda

Jika menggunakan gateway LLM

Gateway LLM organisasi Anda (LiteLLM, Portkey, Kong, dll.). Inferensi menuju ke sini alih-alih api.anthropic.com.

sts.amazonaws.com

Jika menggunakan Bedrock langsung

AWS STS. Menukar token Entra ID dengan kredensial Bedrock sementara.

bedrock-runtime.<region>.amazonaws.com

Jika menggunakan Bedrock langsung

Titik akhir inferensi Bedrock. Ganti <region> dengan wilayah AWS yang dikonfigurasi (misalnya, us-east-1).

accounts.google.com

Jika menggunakan Vertex AI langsung

Layar persetujuan Google OAuth.

oauth2.googleapis.com

Jika menggunakan Vertex AI langsung

Pertukaran dan penyegaran token Google OAuth.

aiplatform.googleapis.com

Jika menggunakan Vertex AI langsung

Titik akhir inferensi global Vertex AI.

<region>-aiplatform.googleapis.com

Jika menggunakan Vertex AI langsung

Titik akhir inferensi regional Vertex AI. Ganti <region> dengan wilayah GCP yang dikonfigurasi (misalnya, us-east5).

<resource>.services.ai.azure.com

Jika menggunakan Foundry langsung

Titik akhir inferensi Azure AI Foundry. Ganti <resource> dengan nama sumber daya Anda.


Terapkan add-in untuk penggunaan pihak ketiga (Admin IT)

Gunakan plugin claude-in-office untuk mengonfigurasi dan menerapkan add-in di seluruh organisasi Anda. Alat ini menangani penyediaan sumber daya cloud (jika menggunakan Bedrock atau Vertex AI langsung), menghasilkan manifes add-in, dan memperoleh persetujuan admin dalam satu alur terpandu.

Gunakan asisten penyiapan

Instal plugin dan jalankan asisten penyiapan interaktif:

claude plugin marketplace add anthropics/financial-services-plugins
claude plugin install claude-in-office@financial-services-plugins
/claude-in-office:setup

Asisten memandu Anda melalui jalur koneksi Anda:

  • Gateway LLM: Mengumpulkan URL dan token gateway Anda, menentukan format API mana yang akan digunakan, menghasilkan manifes, dan menangani persetujuan admin Azure.

  • Bedrock langsung: Membuat penyedia identitas OIDC IAM dan peran, menghasilkan manifes, dan menangani persetujuan admin Azure.

  • Vertex AI langsung: Memandu Anda membuat klien OAuth Google, menghasilkan manifes, dan menangani persetujuan admin Azure.

  • Foundry langsung: Menangkap azure_resource_name dan azure_api_key, kemudian menghasilkan manifes.

Ketika asisten selesai, add-in siap untuk diterapkan di seluruh penyewa.

Catatan: Jalur Bedrock dan Vertex AI memerlukan Node.js untuk pembuatan dan validasi manifes. Asisten memeriksa dan meminta Anda untuk menginstalnya jika tidak ada.

Anda dapat menggunakan perintah berikut di dalam sesi claude-in-office:

Perintah

Apa yang dilakukannya

/claude-in-office:setup

Asisten interaktif—menyediakan sumber daya cloud, persetujuan admin, menulis manifes

/claude-in-office:manifest

Menghasilkan XML manifes add-in yang disesuaikan

/claude-in-office:consent

Menghasilkan URL persetujuan admin Azure untuk pendaftaran aplikasi add-in

/claude-in-office:update-user-attrs

Menulis konfigurasi per-pengguna melalui atribut ekstensi Microsoft Graph

/claude-in-office:bootstrap

Memandu Anda membangun titik akhir bootstrap—server MCP per-pengguna, keterampilan, dan konfigurasi dinamis

/claude-in-office:debug

Mendiagnosis masalah penerapan—konfigurasi basi, kegagalan koneksi, add-in yang hilang

Header inferensi khusus

Jika titik akhir inferensi Anda atau proxy apa pun di depannya memerlukan header tambahan—misalnya, ID aplikasi internal untuk akuntansi biaya—atur inference_headers ke objek JSON pasangan nama/nilai header. Add-in melampirkan header ini ke setiap permintaan inferensi model yang dikirimnya, sehingga Anda tidak memerlukan proxy penyuntik header terpisah.

Ini berlaku untuk penerapan gateway, Amazon Bedrock, dan Google Vertex AI.

Contoh: inference_headers={"x-application-id":"app123"}

Anda dapat mengatur inference_headers dalam manifes (di seluruh organisasi) atau dalam respons titik akhir bootstrap (per-pengguna).

Apa yang disediakan asisten

Asisten mengotomatisasi pembuatan sumber daya berdasarkan jalur koneksi Anda. Berikut adalah apa yang disisiapkan:

Gateway LLM: Tidak ada sumber daya cloud untuk disediakan. Asisten mengumpulkan URL dan token gateway Anda, kemudian menghasilkan manifes.

Bedrock langsung: Membuat penyedia identitas OIDC IAM yang mempercayai token Microsoft Entra ID, peran dengan izin bedrock:InvokeModel dan bedrock:InvokeModelWithResponseStream, dan kebijakan kepercayaan yang dibatasi pada ID aplikasi add-in Claude.

Vertex AI langsung: Memandu Anda membuat klien OAuth Google di Konsol GCP (langkah ini tidak dapat diotomatisasi melalui CLI), mengaktifkan API Vertex AI, dan menangkap ID klien dan rahasia untuk manifes.

Foundry langsung: Tidak ada sumber daya cloud untuk disediakan; asisten mengumpulkan nama sumber daya dan kunci API untuk manifes.

Konfigurasi per-pengguna dengan atribut ekstensi Microsoft Entra

Jika beberapa nilai bervariasi per pengguna—misalnya, token gateway berbeda atau peran AWS berbeda untuk tim berbeda—asisten dapat menulis konfigurasi per-pengguna melalui atribut ekstensi Microsoft Graph. Jalankan /claude-in-office:update-user-attrs dengan kunci per-pengguna setelah penyiapan awal.

Konfigurasi per-pengguna dengan titik akhir bootstrap

Jika beberapa nilai bervariasi per pengguna atau jika nilai per-pengguna memerlukan logika sisi server—misalnya, daftar server MCP, keterampilan, header inferensi, atau token gateway berumur pendek yang dijual dari penyimpanan rahasia Anda—konfigurasikan titik akhir bootstrap sebagai gantinya. Atur bootstrap_url dalam manifes ke titik akhir HTTPS yang Anda hosting; add-in memanggilnya dengan token Entra pengguna dan menerapkan JSON apa pun yang Anda kembalikan. Jalankan /claude-in-office:bootstrap untuk kontrak permintaan/respons dan perancah penangan.

Terapkan ke Microsoft 365

Setelah asisten menghasilkan manifes Anda:

  1. Buka Pusat Admin Microsoft 365 dan buka Pengaturan > Aplikasi Terintegrasi > Unggah aplikasi khusus.

  2. Pilih "Office Add-in" sebagai jenis aplikasi, kemudian unggah file upload manifest.xml (dan manifest-outlook.xml jika Anda menerapkan Outlook).

  3. Pilih siapa yang mendapatkan add-in:

    • Jika semua pengguna berbagi konfigurasi yang sama, pilih "Seluruh organisasi."

    • Jika Anda menulis atribut per-pengguna di langkah sebelumnya, tetapkan ke Pengguna/grup tertentu yang cocok persis dengan siapa yang dikonfigurasi. Siapa pun yang lain akan membuka add-in tanpa konfigurasi.

  4. Terima izin dan selesaikan penerapan.

Propagasi ke pengguna membutuhkan waktu hingga 24 jam (biasanya jauh lebih cepat). Add-in muncul di bawah Home > Add-ins di Excel, PowerPoint, Word, dan Outlook setelah tiba.

Catatan: Mulai dengan grup pilot untuk mengonfirmasi add-in berfungsi, kemudian perluas penugasan. Anda dapat mengubah penugasan nanti tanpa perlu menerapkan ulang.

Terapkan ke Outlook

Outlook memerlukan file manifest terpisah dari Excel, PowerPoint, dan Word. Microsoft menggunakan skema add-in yang berbeda untuk aplikasi mail, sehingga keduanya tidak dapat digabungkan menjadi satu file. Ketika Anda memberi tahu setup wizard bahwa Anda menerapkan ke Outlook, wizard menghasilkan file kedua bernama manifest-outlook.xml bersama manifest.xml. Unggah setiap file sebagai aplikasi kustom tersendiri di Microsoft 365 Admin Center, mengikuti langkah-langkah yang sama yang dijelaskan di bagian berikutnya.

Berikan persetujuan Microsoft Graph

Catatan: Amazon Bedrock saat ini tidak didukung untuk Claude untuk Outlook. Bedrock tetap didukung untuk Claude untuk Excel, PowerPoint, dan Word.

Claude untuk Outlook membaca data mail dan kalender melalui Microsoft Graph, yang memerlukan pemberian izin tingkat tenant satu kali dari Global Administrator. Ini terpisah dari penerapan Integrated apps di atas. Minta Global Admin membuka tautan persetujuan admin di bawah ini di browser tempat mereka masuk ke tenant Microsoft 365 Anda:

  • Admin akan melihat layar izin Microsoft yang mencantumkan Mail.ReadWrite, Calendars.Read, People.Read, User.Read, dan offline_access

  • Setelah mereka mengklik "Terima," semua pengguna di organisasi dapat menggunakan Claude untuk Outlook tanpa prompt Microsoft tambahan. Pemberian izin ini berlaku segera; hanya penerapan add-in di atas yang dapat membutuhkan waktu hingga 24 jam.

  • Jika langkah ini dilewati, setiap pengguna akan melihat pesan "Perlu persetujuan admin" ketika Claude pertama kali mencoba membaca data mail atau kalender.

Catatan: Claude untuk Outlook di platform pihak ketiga saat ini hanya mendukung Claude Opus 4.7. Model Claude lainnya tersedia di Outlook ketika pengguna masuk dengan akun Claude.

Setelah menerapkan add-in, pengguna Anda dapat terhubung dengan mengikuti langkah-langkah di bawah ini.


Instruksi koneksi untuk pengguna akhir

Gateway LLM

  1. Buka Excel, PowerPoint, Word, atau Outlook dan luncurkan add-in Claude.

  2. Di layar masuk, pilih "Enterprise gateway."

  3. Masukkan Gateway URL dan API token yang disediakan tim IT Anda.

    • Gateway URL: URL dasar HTTPS dari proxy LLM Anda (misalnya, https://llm-gateway.yourcompany.com).

    • API token: Token bearer yang diharapkan proxy Anda. Add-in mengirimkan ini di header Authorization: Bearer <token> dengan setiap permintaan.

  4. Add-in memeriksa koneksi dengan mengirimkan permintaan uji ke gateway. Jika berhasil, Anda akan melihat pengalaman aplikasi utama.

Kredensial Anda disimpan secara lokal di localStorage browser Anda dalam iframe sandbox add-in. Mereka tidak disinkronkan ke server Anthropic. Karena add-in Office berjalan di dalam iframe sandbox dalam aplikasi Microsoft, add-in tidak dapat menggunakan keychain OS Anda seperti yang dilakukan Claude Code—untuk alasan ini, hanya masukkan token yang dikeluarkan gateway, bukan kredensial penyedia cloud mentah.

Bedrock, Vertex AI, atau Foundry langsung

  1. Buka Excel, PowerPoint, Word, atau Outlook dan luncurkan add-in Claude.

  2. Autentikasi menggunakan metode penyedia Anda:

    1. Bedrock atau Vertex AI: Masuk dengan akun kerja Microsoft Anda. Add-in menggunakan token Entra ID Anda untuk autentikasi dengan penyedia cloud Anda—tidak diperlukan kredensial cloud terpisah.

    2. Foundry: Jika admin Anda telah mengisi sebelumnya nama sumber daya Azure dan kunci API, add-in terhubung secara otomatis. Jika tidak, masukkan nilai yang disediakan tim IT Anda dan pilih Hubungkan.

  3. Add-in membaca konfigurasi yang disediakan admin Anda dan terhubung ke Bedrock atau Vertex AI secara langsung.

Jika Anda melihat kesalahan saat masuk, konfirmasi dengan tim IT Anda bahwa akun Anda ada di grup yang ditugaskan ke add-in.

Ubah atau perbarui koneksi Anda

Jika token API Anda kedaluwarsa atau tim IT Anda memberi Anda URL baru, buka "Pengaturan" di sidebar add-in, masukkan nilai baru, dan pilih "Uji koneksi."


Persyaratan gateway untuk tim IT

Add-in Office mendukung format API yang sama seperti Claude Code. Atur gateway_api_format dalam manifest add-in Anda untuk memberi tahu add-in format mana yang digunakan gateway Anda.

Persyaratan CORS

Taskpane add-in dimuat dari https://pivot.claude.ai. Setiap permintaan ke gateway Anda adalah cross-origin, dan browser akan diam-diam membuang respons apa pun yang tidak memiliki header CORS.

Gateway Anda harus mengembalikan Access-Control-Allow-Origin: https://pivot.claude.ai (atau *) pada setiap respons: GET, POST, OPTIONS, dan semua respons kesalahan. Menetapkannya hanya pada preflight OPTIONS tidak cukup. Untuk preflight, kembalikan Access-Control-Allow-Headers: *.

Endpoint yang diperlukan

Endpoint yang harus diekspos gateway Anda bergantung pada format API mana yang digunakan. Atur gateway_api_format dalam manifest Anda agar sesuai.

gateway_api_format: anthropic (default)

Endpoint

Deskripsi

POST /v1/messages

Kirim pesan ke Claude. Mendukung respons streaming dan non-streaming.

GET /v1/models

Daftar model yang tersedia.

gateway_api_format: bedrock

Endpoint

Deskripsi

POST /model/{model-id}/invoke

Kirim pesan dan terima respons lengkap.

POST /model/{model-id}/invoke-with-response-stream

Kirim pesan dan terima respons streaming.

Bedrock InvokeModel pass-through asli. gateway_url harus menunjuk ke awalan pass-through (misalnya, https://litellm.example.com/bedrock).

gateway_api_format: vertex

Endpoint

Deskripsi

POST /projects/{project}/locations/{region}/publishers/anthropic/models/{model-id}:rawPredict

Kirim pesan dan terima respons lengkap.

POST /projects/{project}/locations/{region}/publishers/anthropic/models/{model-id}:streamRawPredict

Kirim pesan dan terima respons streaming.

Vertex pass-through asli. gateway_url harus menyertakan segmen versi API (misalnya, https://litellm.example.com/vertex_ai/v1). Juga memerlukan gcp_project_id dan gcp_region sehingga add-in dapat membangun jalur.

Header yang diperlukan

Untuk format anthropic dan vertex, gateway harus meneruskan header permintaan anthropic-version ke penyedia hulu.

Untuk format bedrock, SDK menempatkan anthropic_version di badan permintaan sebagai gantinya — gateway harus menyimpannya di sana.

Kegagalan untuk meneruskan header atau menyimpan bidang badan dapat mengakibatkan fungsionalitas berkurang atau mencegah add-in berfungsi.

Header otorisasi

Add-in dapat mengirim token otorisasi gateway Anda di header x-api-key atau Authorization.

Penemuan model

Saat login, add-in mencoba menemukan model Claude yang tersedia melalui GET /v1/models. Jika gateway Anda tidak mengekspos daftar model di jalur tersebut, add-in kembali ke permintaan pengguna untuk ID model secara manual.

Perbedaan dari pengaturan gateway Claude Code

Aspek

Claude Code

Claude untuk Excel, PowerPoint, Word, dan Outlook

Penyimpanan kredensial

Keychain OS atau variabel lingkungan

Browser localStorage (iframe bersandbox)

Konfigurasi autentikasi

Variabel lingkungan, file pengaturan, skrip pembantu

Entri manual di UI add-in (gateway), Entra ID (cloud langsung), atau kunci API Azure (Foundry)

Penyegaran token

Mendukung skrip pembantu untuk rotasi

Entri ulang manual di pengaturan (gateway) atau otomatis melalui Entra ID (cloud langsung)

Nama model khusus

Dapat dikonfigurasi melalui variabel lingkungan

Tidak dapat dikonfigurasi di v1


Contoh konfigurasi gateway dengan LiteLLM

Peringatan: Versi PyPI LiteLLM 1.82.7 dan 1.82.8 dikompromikan dengan malware pencuri kredensial. Jangan instal versi ini. Jika Anda telah menginstalnya:

  • Hapus paket

  • Putar semua kredensial pada sistem yang terpengaruh

  • Ikuti langkah remediasi di BerriAI/litellm#24518

LiteLLM adalah layanan proxy pihak ketiga. Anthropic tidak mendukung, memelihara, atau mengaudit keamanan atau fungsionalitas LiteLLM. Panduan ini disediakan untuk tujuan informasi dan mungkin menjadi usang. Gunakan atas kebijakan Anda sendiri.

Banyak organisasi menggunakan LiteLLM sebagai gateway mereka. Di bawah ini adalah litellm_config.yaml minimal untuk merutekan permintaan add-in Office ke Anthropic, Bedrock, atau Vertex.

Perutean ke Anthropic secara langsung

yaml

model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: claude-sonnet-4-5-20250929
api_key: os.environ/ANTHROPIC_API_KEY

litellm_settings:
drop_params: true

Perutean ke Amazon Bedrock

yaml

model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: bedrock/anthropic.claude-sonnet-4-5-20250929-v1:0
aws_region_name: us-east-1

litellm_settings:
drop_params: true

Perutean ke Google Cloud Vertex AI

yaml

model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: vertex_ai/claude-sonnet-4-5-20250929
vertex_project: your-gcp-project-id
vertex_location: us-east5

litellm_settings:
drop_params: true

Perutean ke Azure

yaml

model_list:
- model_name: claude-sonnet-4-5-20250929
litellm_params:
model: azure_ai/claude-sonnet-4-5-20250929
api_base: https://your-resource.services.ai.azure.com/anthropic
api_key: os.environ/AZURE_API_KEY
extra_headers:
x-api-key: os.environ/AZURE_API_KEY

litellm_settings:
drop_params: true

Untuk petunjuk penyiapan terperinci, lihat dokumentasi format Anthropic LiteLLM.


Apa yang dikumpulkan Anthropic

Bahkan ketika inferensi berjalan melalui infrastruktur Anda sendiri, add-in berkomunikasi dengan pivot.claude.ai untuk memuat antarmukanya dan dengan claude.ai/api/ untuk mengevaluasi flag fitur. Koneksi ini mengirimkan telemetri operasional—seperti fitur mana yang digunakan, waktu kinerja, dan tingkat kesalahan—sehingga Anthropic dapat mempertahankan dan meningkatkan pengalaman add-in. Mereka tidak mengirimkan prompt Anda atau respons Claude.

Anthropic mengumpulkan informasi sesuai dengan AWS Bedrock, Google Cloud Vertex AI, atau persyaratan Microsoft Azure, konsisten dengan pengaturan Anthropic dengan pelanggan. Anthropic tidak memiliki akses ke instans AWS, Google, atau Microsoft pelanggan, termasuk prompt atau output yang dikandungnya. Anthropic tidak melatih model generatif dengan konten tersebut atau menggunakannya untuk tujuan lain. Anthropic dapat mengakses metadata—seperti penggunaan alat, jumlah token, dan item serupa—dan menggunakan metadata tersebut untuk tujuan analitik dan peningkatan produk.

Untuk detail tentang apa yang dicatat gateway organisasi Anda atau penyedia cloud, hubungi tim IT Anda.

Untuk merutekan jejak audit lengkap—termasuk prompt, input alat, output alat, dan referensi dokumen—ke infrastruktur Anda sendiri, lihat Konfigurasikan kolektor OpenTelemetry khusus untuk agen Office.


Bagaimana ini berbeda dari masuk dengan akun Claude

Ketika Anda masuk dengan akun Claude, add-in terhubung langsung ke Anthropic. Ketika Anda terhubung melalui platform pihak ketiga, add-in mengirimkan permintaan inferensi ke infrastruktur organisasi Anda, dan tim IT Anda mengontrol bagaimana lalu lintas itu dirutekan dan dicatat.

Beberapa fitur yang bergantung pada memiliki akun Claude belum tersedia melalui platform pihak ketiga, tetapi kami sedang mengerjakan penambahan dukungan:

Fitur

Akun Claude

Platform pihak ketiga

Obrolan dengan spreadsheet, deck, atau dokumen Anda

Baca dan edit sel, slide, rumus, dan teks dokumen

Konektor (S&P, FactSet, dll.)

Bekerja di seluruh aplikasi

Keterampilan

Unggahan file

Pencarian web

Hanya Vertex

Jika tim Anda memerlukan fitur ini, bicarakan dengan admin Claude Anda tentang jalur masuk mana yang sesuai untuk organisasi Anda.

Tambahkan konektor MCP ke add-in pihak ketiga

Konektor MCP sekarang didukung di Claude untuk Excel, PowerPoint, dan Word. Sebagai administrator, Anda dapat mengatur gateway MCP di manifes add-in mengikuti dokumentasi di sini: Server MCP. Jika Anda lebih suka menggunakan titik akhir bootstrap, Anda dapat mengonfigurasi konektor MCP mengikuti dokumentasi di sini: mcp_servers.

Tambahkan Keterampilan ke add-in pihak ketiga

Keterampilan sekarang didukung di Claude untuk Excel, PowerPoint, dan Word. Keterampilan layanan keuangan Anthropic tersedia secara default. Keterampilan tambahan dapat ditambahkan oleh administrator atau secara manual oleh individu.

Administrator dapat menambahkan keterampilan menggunakan titik akhir bootstrap, mengikuti dokumentasi di sini: skills.

Individu dapat mengunggah keterampilan lokal secara manual (baik sebagai file .zip, .skill, atau SKILL.md) dan mengelolanya secara individual. Keterampilan diunggah dengan memilih tombol "+", lalu Keterampilan → "Unggah Keterampilan."

Tambahkan unggahan file ke add-in pihak ketiga

Unggahan file sekarang didukung di Claude untuk Excel, PowerPoint, dan Word. Individu dapat mengunggah file dengan memilih tombol "+", lalu "Tambahkan file atau foto".


Pemecahan masalah

"Koneksi ditolak" atau kesalahan jaringan

URL gateway atau titik akhir cloud tidak dapat dijangkau dari jaringan pengguna. Verifikasi URL sudah benar, layanan berjalan, dan tidak ada pembatasan firewall atau VPN yang memblokir koneksi. Periksa bagian Daftar izin jaringan di atas untuk mengonfirmasi semua domain yang diperlukan diizinkan.

401 Tidak Sah atau "Token tidak valid"

Token auth tidak valid atau kedaluwarsa. Untuk koneksi gateway, konfirmasi token dengan tim IT Anda. Untuk koneksi cloud langsung, verifikasi akun Entra ID pengguna ada di grup yang ditugaskan dan kepercayaan OIDC atau klien OAuth dikonfigurasi dengan benar. Untuk Foundry, buat ulang kunci di Azure Portal → Kunci dan Titik Akhir.

403 Terlarang atau "Akses ditolak"

Token valid tetapi tidak memiliki izin yang tepat. Untuk Bedrock, verifikasi peran IAM memiliki izin bedrock:InvokeModel. Untuk Vertex, verifikasi akun layanan memiliki izin aiplatform.endpoints.predict. Untuk gateway, periksa cakupan token dengan admin IT Anda. Untuk Foundry, periksa aturan jaringan sumber daya, atau konfirmasi kunci milik sumber daya yang tepat.

404 Tidak ditemukan

Add-in tidak dapat menjangkau jalur API yang diharapkan. Untuk gateway, verifikasi bahwa URL adalah URL dasar (misalnya, https://litellm-server:4000)—jangan sertakan /v1/messages di bidang URL.

Kesalahan server 500 atau kesalahan server lainnya

Gateway atau penyedia cloud mengalami kesalahan internal. Periksa log gateway Anda (misalnya, docker logs litellm jika menggunakan LiteLLM) untuk kesalahan penyedia upstream. Coba permintaan lagi, dan hubungi admin IT Anda jika masalah berlanjut.

"Tidak ada model yang tersedia"

Add-in tidak dapat menemukan model Claude. Untuk gateway, gateway Anda mungkin tidak mengekspos daftar model di GET /v1/models. Tim IT Anda dapat mengonfigurasi gateway untuk melayani daftar model atau memberi Anda ID model tertentu untuk dimasukkan secara manual. Untuk Bedrock atau Vertex, konfirmasi bahwa setidaknya satu model Claude (Claude Sonnet 4.5 atau lebih baru) diaktifkan di akun dan wilayah Anda. Untuk Foundry, konfirmasi setidaknya satu model Claude digunakan dalam sumber daya (Katalog Model).

Respons streaming gagal atau hang

Verifikasi bahwa gateway Anda mendukung pass-through Server-Sent Events (SSE). Beberapa konfigurasi proxy menghapus atau membuffer koneksi SSE, yang mencegah respons streaming mencapai add-in.

Fitur yang saya harapkan tidak tersedia

Konektor, keterampilan, unggahan file, dan Bekerja Lintas Aplikasi belum tersedia melalui platform pihak ketiga. Jika Anda membutuhkan ini, tanyakan kepada admin Anda tentang masuk dengan akun Claude.

Apakah pertanyaan Anda terjawab?