aixplain Agent Builder Skill
Build, run, debug, update, verify, and export production aixplain agents from plain English. The skill uses the aixplain Python SDK v2, applies safe defaults, and verifies a realistic run before reporting success.
Use the unified Claude Code plugin for one-step installation with Marketplace Search, or install Agent Builder directly in any compatible host.
Current skill SDK: aixplain==0.2.47 · Updated 2026-08-23
Choose an installation path
Claude Code: unified plugin (recommended)
The aixplain plugin installs two connected capabilities together:
- Marketplace Search — live marketplace discovery and real input-schema inspection.
- Agent Builder — SDK v2 build, run, debug, verification, update, and export guidance.
In the terminal that starts Claude Code, set your API key:
export AIXPLAIN_API_KEY="your_api_key"
Then run these commands from the Claude Code prompt:
/plugin marketplace add aixplain/aiXplain
/plugin install aixplain@aixplain
The plugin wires the Marketplace Search MCP with your environment variable. No API key is stored in plugin configuration.
Standalone skill or a host without plugin support
Agent Builder does not require Claude Code plugins or MCP support. Core build, run, debug, update, verify, and export workflows require only Python, the aixplain SDK, and AIXPLAIN_API_KEY.
| Host | Installation approach |
|---|---|
| Claude Code | Copy skills/aixplain-agent-builder/ to ~/.claude/skills/. |
| Codex | Reference or paste SKILL.md into AGENTS.md, including needed files under references/. |
| Cursor | Add SKILL.md as a rule under .cursor/rules/, with required references available to the agent. |
| Copilot or another host | Add SKILL.md and the required references using that host's instruction-file convention. |
When Marketplace Search is unavailable, Agent Builder continues with SDK searches and supported integrations or a custom Python Sandbox tool. It does not treat an unavailable plugin or MCP server as evidence that a capability is missing.
Use the same API key for the SDK, Agent Builder, and Marketplace Search. Keep it in an environment variable; never paste it into generated code or commit it to a repository.
What you can ask for
Build and verify an agent
Build an agent that creates an evidence-backed customer briefing from web research.
The skill infers routine configuration, scopes tools to the minimum actions, asks before connecting external services, deploys the agent, and verifies a realistic run.
Discover a capability
Find a web search tool, inspect its inputs, and show me Python SDK code.
When the Marketplace Search MCP is installed, the skill inspects the live schema before generating code. Without it, the skill uses SDK discovery and states only material limitations.
Debug, update, or export
Debug why agent <AGENT_ID> is not using its knowledge base.
Export agent <AGENT_ID> as portable SDK v2 code.
Exports use llm=, keep iteration limits in agent budgets, and are syntax- and constructor-validated before presentation.
Reliability and safety defaults
- Uses SDK v2 only and validates generated constructors and Python syntax.
- Requires explicit consent and minimum scopes before connecting external integrations.
- Verifies tool use, output, governance status, and spend with realistic runs.
- Keeps Marketplace discovery optional; installation packaging never blocks core Agent Builder workflows.
- Preserves existing agent IDs when updating and does not silently widen tool permissions.
Requirements
- Python 3 and
pip aixplain==0.2.47- An aixplain API key available as
AIXPLAIN_API_KEY - An AI coding agent that can load the skill or instructions
Install the tested SDK release when using the standalone workflow:
python3 -m pip install --upgrade "aixplain==0.2.47"
Keep the skill current
The canonical source is the skills/aixplain-agent-builder folder in the aixplain repository. Pull the current source and replace the installed folder when updating. The bundled plugin copy is kept byte-identical to that canonical standalone skill.