Agent skill

agenticx-agent-builder

Guide for creating and configuring AgenticX agents with roles, goals, tools, LLM providers, and execution strategies. Use when the user wants to create agents, assign tools to agents, configure LLM backends, set up agent execution, or build multi-agent systems.

Stars 106
Forks 12

Install this agent skill to your Project

npx add-skill https://github.com/DemonDamon/AgenticX/tree/main/agenticx/skills/agenticx-agent-builder

Metadata

Additional technical details for this skill

author
AgenticX
version
0.3.6

SKILL.md

AgenticX Agent Builder

Guide for creating production-grade agents in AgenticX.

Core Concepts

An Agent in AgenticX consists of:

  • Identity: id, name, role, goal
  • LLM Provider: the language model backend
  • Tools: functions the agent can invoke
  • Executor: the runtime that orchestrates agent reasoning

Creating an Agent

Minimal Agent

python
from agenticx import Agent, Task, AgentExecutor
from agenticx.llms import OpenAIProvider

agent = Agent(
    id="assistant",
    name="Assistant",
    role="General Purpose Assistant",
    goal="Help users with tasks",
    organization_id="default"
)

Agent with Rich Configuration

python
agent = Agent(
    id="research-analyst",
    name="Research Analyst",
    role="Senior Research Analyst",
    goal="Produce thorough, well-cited research reports",
    backstory="10 years experience in data-driven research",
    organization_id="research-team",
    verbose=True
)

CLI Creation

bash
agx agent create research-analyst --role "Senior Research Analyst"
agx agent list

LLM Providers

AgenticX supports multiple LLM backends through a unified interface:

python
from agenticx.llms import OpenAIProvider, LiteLLMProvider

# OpenAI
llm = OpenAIProvider(model="gpt-4")

# Any model via LiteLLM (Claude, Gemini, local models, etc.)
llm = LiteLLMProvider(model="anthropic/claude-sonnet-4-20250514")
llm = LiteLLMProvider(model="ollama/llama3")

Adding Tools

Function Decorator Tools

python
from agenticx.tools import tool

@tool
def search_web(query: str) -> str:
    """Search the web for information."""
    return f"Results for: {query}"

@tool
def calculate(expression: str) -> float:
    """Evaluate a math expression safely."""
    return eval(expression)  # use ast.literal_eval in production

Attaching Tools to Execution

python
executor = AgentExecutor(
    agent=agent,
    llm=llm,
    tools=[search_web, calculate]
)
result = executor.run(task)

Task Definition

python
task = Task(
    id="research-task",
    description="Research the latest trends in AI agents",
    expected_output="A structured report with sections and citations",
    context={"domain": "artificial-intelligence"}
)

Output Validation

AgenticX validates task outputs using Pydantic:

python
from pydantic import BaseModel

class ResearchReport(BaseModel):
    title: str
    summary: str
    findings: list[str]

task = Task(
    id="validated-task",
    description="Research AI trends",
    expected_output="Structured research report",
    output_model=ResearchReport
)

Execution Strategies

Basic Execution

python
executor = AgentExecutor(agent=agent, llm=llm)
result = executor.run(task)

With Events & Callbacks

AgenticX emits events during execution (TaskStart, ToolCall, LLMCall, etc.):

python
from agenticx.core import EventLog

event_log = EventLog()
executor = AgentExecutor(agent=agent, llm=llm, event_log=event_log)
result = executor.run(task)

for event in event_log.events:
    print(f"{event.type}: {event.data}")

Multi-Agent Patterns

Agent Handoff

python
from agenticx.core import HandoffOutput

# Agent A can hand off to Agent B
handoff = HandoffOutput(target_agent="agent-b", context={"data": result})

Communication Interface

python
from agenticx.core import BroadcastCommunication

comm = BroadcastCommunication()
comm.send(sender="agent-a", message="Task complete", data=result)

GuideRails

Constrain agent behavior with guardrails:

python
from agenticx.core import GuideRails, GuideRailsConfig

config = GuideRailsConfig(
    max_iterations=10,
    timeout_seconds=60,
    abort_on_failure=True
)
guardrails = GuideRails(config=config)

Best Practices

  1. Specific roles — narrow roles produce better results than generic ones
  2. Clear goals — state what success looks like
  3. Minimal tools — only attach tools the agent actually needs
  4. Output validation — use Pydantic models for structured outputs
  5. Event logging — always enable for debugging and monitoring

Expand your agent's capabilities with these related and highly-rated skills.

DemonDamon/AgenticX

agenticx-skill-manager

Guide for managing AgenticX skills including listing, searching, installing, uninstalling, publishing, and running a skill registry server. Use when the user wants to manage skills, find available skills, publish custom skills, set up a skill registry, or understand the skill ecosystem.

106 12
Explore
DemonDamon/AgenticX

agenticx-deployer

Guide for deploying AgenticX agents to production including Docker containerization, Kubernetes orchestration, Volcengine AgentKit cloud deployment, and API server setup. Use when the user wants to deploy agents, containerize applications, set up Kubernetes, configure cloud deployment, or run the AgenticX API server in production.

106 12
Explore
DemonDamon/AgenticX

agenticx-a2a-connector

Guide for using the A2A (Agent-to-Agent) communication protocol in AgenticX including agent discovery, skill invocation, remote agent cards, and distributed agent systems. Use when the user wants agents to communicate with each other, set up distributed agent systems, invoke remote agent skills, or build agent-to-agent workflows.

106 12
Explore
DemonDamon/AgenticX

agenticx-quickstart

AgenticX zero-to-hero quickstart guide. Use when the user wants to get started with AgenticX, create their first project, build their first agent, or run their first workflow. Covers installation, project scaffolding, agent creation, task execution, and CLI basics.

106 12
Explore
DemonDamon/AgenticX

agenticx-workflow-designer

Guide for designing and running AgenticX workflows including sequential pipelines, parallel execution, graph-based orchestration, conditional routing, and trigger services. Use when the user wants to create workflows, orchestrate multiple agents, design agent pipelines, or set up complex multi-step processes.

106 12
Explore
DemonDamon/AgenticX

agenticx-memory-architect

Guide for setting up and using the AgenticX memory system including Mem0 integration, long-term memory, context management, and memory-enhanced agents. Use when the user wants to add memory to agents, persist conversation history, build memory-aware workflows, or integrate with Mem0 for long-term recall.

106 12
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results