​
Understanding Agent Settings

Agent settings provide global configuration options that control how your agent behaves, what instructions it follows, and how it interacts with other agents. These settings are applied automatically in the agent runtime and can also be accessed or overridden via the SDK.

​
Accessing Agent Settings

To access the agent settings:
  1. Navigate to your agent in the xpander.ai dashboard
  2. Click the “Settings” icon in the top-right corner
  3. Select from the settings categories in the left sidebar

​
Configuration Categories

The General settings control basic agent configuration:
General Agent Settings

​
SDK Integration

All agent settings can be accessed and modified programmatically using the xpander.ai SDK: 
from xpander_sdk import XpanderClient

# Initialize client
xpander_client = XpanderClient(api_key="your-api-key")

# Get existing agent
agent = xpander_client.agents.get("your-agent-id")

# Update instructions
agent.update_instructions(
    role="You are the LinkedIn Research Assistant, specialized in finding and analyzing profile data.",
    goal="Help users discover relevant professionals and understand their background and experience.",
    instructions="Always maintain a professional tone. Prioritize accuracy over speed."
)

# Update model settings
agent.update_model(provider="openai", model="gpt-4.1")

# Configure delegation
agent.configure_delegation(type="router")

# Add example prompts
agent.add_prompt("Find LinkedIn profiles of AI researchers in California")
agent.add_prompt("Summarize the career trajectory of [username]")

# Save changes
agent.sync()

​
Next Steps