Lewati ke konten utama

Gunakan Claude untuk Excel, PowerPoint, dan Word dengan platform pihak ketiga

Diperbarui hari ini

Jika organisasi Anda menggunakan AWS Bedrock, Google Cloud Vertex AI, Azure AI Foundry, atau gateway LLM untuk mengakses Claude, Anda dapat menggunakan add-in Claude for Excel, Claude for PowerPoint, dan Claude for Word 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 for Excel, Claude for PowerPoint, atau Claude for Word terinstal (dari Microsoft AppSource atau disebarkan oleh admin Anda)

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

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 IAM OIDC 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 menuju 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 bekerja di seluruh aplikasi

Jembatan WebSocket untuk fitur bekerja di seluruh 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 sebagai gantinya dari 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 wizard pengaturan

Instal plugin dan jalankan wizard pengaturan interaktif:

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

Wizard memandu Anda melalui jalur koneksi Anda:

  • Gateway LLM: Mengumpulkan URL gateway dan token Anda, menentukan format API mana yang 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 wizard selesai, add-in siap untuk diterapkan di seluruh tenant.

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

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

Perintah

Apa yang dilakukannya

/claude-in-office:setup

Wizard 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

Apa yang disediakan wizard

Wizard mengotomatisasi pembuatan sumber daya berdasarkan jalur koneksi Anda. Berikut yang disiapkan:

Gateway LLM: Tidak ada sumber daya cloud untuk disediakan. Wizard mengumpulkan URL gateway dan token 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 GCP Console (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; wizard mengumpulkan nama sumber daya dan kunci API untuk manifes.

Konfigurasi per-pengguna

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

Terapkan ke Microsoft 365

Setelah wizard menghasilkan manifes Anda:

  1. Buka Microsoft 365 Admin Center dan buka Pengaturan > Aplikasi Terintegrasi > Unggah aplikasi kustom.

  2. Pilih "Office Add-in" sebagai jenis aplikasi, kemudian unggah file manifest.xml.

  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 memakan waktu hingga 24 jam (biasanya jauh lebih cepat). Add-in muncul di bawah Beranda > Add-in di Excel, PowerPoint, dan Word setelah tiba.

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

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, atau Word dan luncurkan add-in Claude.

  2. Di layar masuk, pilih "Gateway perusahaan."

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

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

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

  4. Add-in memeriksa koneksi dengan mengirim 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 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, atau Word 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 diberikan 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 bilah sisi add-in, masukkan nilai baru, dan pilih "Uji koneksi."


Persyaratan gateway untuk tim IT

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

Persyaratan CORS

Panel tugas add-in dimuat dari https://pivot.claude.ai. Setiap permintaan ke gateway Anda adalah lintas asal, 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: *.

Titik akhir yang diperlukan

Titik akhir yang harus diekspos gateway Anda bergantung pada format API mana yang digunakan. Atur gateway_api_format dalam manifes Anda agar sesuai.

gateway_api_format: anthropic (default)

Titik Akhir

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

Titik Akhir

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.

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

gateway_api_format: vertex

Titik Akhir

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.

Pass-through Vertex 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 mempertahankannya di sana.

Kegagalan untuk meneruskan header atau mempertahankan 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 masuk, 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, dan Word

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 kustom

Dapat dikonfigurasi melalui variabel lingkungan

Tidak dapat dikonfigurasi di v1


Contoh konfigurasi gateway dengan LiteLLM

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

  • Hapus paket

  • Rotasi 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 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 memelihara dan meningkatkan pengalaman add-in. Mereka tidak mengirimkan prompt Anda atau respons Claude.

Anthropic mengumpulkan informasi sesuai dengan syarat AWS Bedrock, Google Cloud Vertex AI, atau 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 oleh 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 Konfigurasi kolektor OpenTelemetry kustom 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.)

Segera hadir

Bekerja di seluruh aplikasi

Keterampilan

Segera hadir

Unggahan file

Pencarian web

Hanya Vertex

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


Pemecahan masalah

"Koneksi ditolak" atau kesalahan jaringan

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

401 Tidak Sah atau "Token tidak valid"

Token autentikasi tidak valid atau sudah kadaluarsa. 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 Endpoint.

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 URL adalah URL dasar (misalnya, https://litellm-server:4000)—jangan sertakan /v1/messages di bidang URL.

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 tersedia"

Add-in tidak dapat menemukan model Claude. Untuk gateway, gateway Anda mungkin tidak menampilkan 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 setidaknya satu model Claude (Claude Sonnet 4.5 atau lebih baru) diaktifkan di akun dan wilayah Anda. Untuk Foundry, konfirmasi setidaknya satu model Claude diterapkan di sumber daya (Katalog Model).

Respons streaming gagal atau macet

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, minta admin Anda tentang masuk dengan akun Claude sebagai gantinya.

Apakah pertanyaan Anda terjawab?