Make missing OPENAI_API_KEY error actionable

The OpenAI provider raised a bare "OPENAI_API_KEY is required", which
misdirects CrewAI AMP users who configured an org-wide LLM Connection.
The error now explains the remediation (set the OPENAI_API_KEY
environment variable or pass api_key to LLM()) and clarifies that
org-wide LLM Connections do not apply to code-first AMP deployments,
which read keys from deployment environment variables.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Joao Moura
2026-07-13 21:48:34 -07:00
parent 9d72e269e4
commit 47bbb8ab44
3 changed files with 31 additions and 2 deletions

View File

@@ -383,7 +383,11 @@ def test_classify_missing_openai_key_is_warning(tmp_path: Path) -> None:
v._classify_import_error(
"ImportError",
"Error importing native provider: 1 validation error for OpenAICompletion\n"
" Value error, OPENAI_API_KEY is required",
" Value error, OPENAI_API_KEY is required. Set the OPENAI_API_KEY "
"environment variable or pass api_key to LLM(). On CrewAI AMP, "
"code-first deployments read API keys from deployment environment "
"variables — org-wide LLM Connections do not apply to code-first "
"deployments.",
tb="",
)
assert len(v.results) == 1