Provider Connectors

---
name: provider-connectors
description: "AgentScope provider, embedding, formatter, and TTS configuration workflows."
disable-model-invocation: true
metadata:
  disco-role: operating
license: Apache 2.0
---

# provider-connectors

Use this sub-skill when the task is about provider classes, credentials, provider extras, model names, embeddings, formatters, or TTS.

## Read first

- `references/model-overview.md` for chat model families and credential shapes.
- `references/embedding-overview.md` for embedding model families and dimension notes.
- `references/tts-overview.md` for TTS constructors and streaming defaults.
- `references/troubleshooting.md` for missing-extra, credential, and provider-specific failures.
- `scripts/provider_matrix.py` for a safe availability/import check.

## Typical triggers

- Choose the right extra for OpenAI, Anthropic, DashScope, Gemini, Ollama, Moonshot, DeepSeek, or XAI.
- Compare chat, embedding, formatter, or TTS constructor defaults.
- Fix a provider import or credential problem.
- Check which providers are available in the current environment.

## What belongs here

- `agentscope.credential`
- `agentscope.model`
- `agentscope.embedding`
- `agentscope.formatter`
- `agentscope.tts`
- provider-specific configuration, env vars, and model names

## What does not belong here

- Agent/tool/permission basics → `agent-core`
- RAG and memory workflows → `rag-memory`
- Service deployment and API bootstrap → `service-platform`
- Workspace or sandbox backend setup → `workspace-sandboxes`

## Use pattern

1. Identify the provider family first.
2. Read the matching overview reference for the constructor and default values.
3. Check whether the provider needs a dedicated extra or only the base package.
4. Use `scripts/provider_matrix.py` when you need a safe current-environment status check.
5. Escalate to `rag-memory` only if the issue is really an embedding dimension or retrieval workflow.

## Shared diagnostics

- Run `../../scripts/check_env.py` if the entire package looks stale.
- Read `references/troubleshooting.md` before changing code if the problem is a missing extra, credential class, or model name.

## Cross-links

- If the task needs the agent/tool layer, switch to `agent-core`.
- If the task needs RAG or memory, switch to `rag-memory`.
- If the task needs service bootstrapping or deployment, switch to `service-platform`.