Agent Configuration (SDS-040)

Configure AI agents with Prompt Management DSL.


Configuration Schema

1
2
3
4
5
6
7
8
9
10
{
  "agentId": "string",
  "name": "string",
  "role": "string",
  "baseModel": "GPT-4 | Claude | Ollama",
  "promptTemplate": "string with {{placeholders}}",
  "contextSources": [...],
  "skills": [...],
  "behaviorAdapters": [...]
}

API Endpoints

Endpoint Method Description
/ai-agents/configure POST Create/update config
/ai-agents/{id}/config GET Get config
/ai-agents GET List all agents
/ai-agents/{id}/deploy POST Deploy agent

Context Sources

1
2
3
4
5
6
7
8
9
10
11
12
"contextSources": [
  {
    "sourceType": "knowledgeGraph",
    "query": "MATCH (e:Entity) WHERE e.domain = $domain RETURN e",
    "injectionPoint": "{{entities}}"
  },
  {
    "sourceType": "userConversation",
    "query": "last_5_messages",
    "injectionPoint": "{{conversation}}"
  }
]

Skills (Capabilities)

1
2
3
4
5
6
7
8
9
10
"skills": [
  {
    "skillId": "review-code",
    "description": "Review code for quality issues",
    "toolCallDefinition": {
      "name": "review_code",
      "parameters": { "code": "string" }
    }
  }
]

Behavior Adapters (LoRA)

1
2
3
4
5
6
7
8
9
"behaviorAdapters": [
  {
    "adapterType": "LoRA",
    "configuration": {
      "modelPath": "adapters/code-specialist",
      "rank": 16
    }
  }
]

Complete Example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
POST /ai-agents/configure
{
  "agentId": "artifact-recommender",
  "name": "Artifact Recommendation Agent",
  "role": "ArtifactRecommender",
  "baseModel": "GPT-4",
  "promptTemplate": "Based on context: {{context}}, suggest artifacts.",
  "contextSources": [
    {
      "sourceType": "knowledgeGraph",
      "query": "MATCH (e:Entity) WHERE e.domain = $domain RETURN e",
      "injectionPoint": "{{entities}}"
    }
  ],
  "skills": [
    {
      "skillId": "generate-checklist",
      "description": "Generate a checklist artifact"
    }
  ],
  "behaviorAdapters": [
    {
      "adapterType": "LoRA",
      "configuration": {
        "modelPath": "adapters/artifact-specialist",
        "rank": 16
      }
    }
  ]
}

Last Updated: January 2026