doc: added roles documentation

Author: TobiasGleiter

examples/agents/ollama/main.go

@@ -73,8 +73,10 @@ func main() {
 	}
 
 	task := `
-		Find all types in this codebase that implement the parser interface.
-		For each type, show which package and file it is defined in.`
+		Analyze the current Go code base and evaluate its maintainability. Produce a short report.`
+	// task := `
+	// 	Find all types in this codebase that implement the parser interface.
+	// 	For each type, show which package and file it is defined in.`
 	if err := agent.Task(ctx, task); err != nil {
 		panic(err)
 	}

inputs/roles/roles.go

@@ -1,10 +1,18 @@
+// Package roles defines the standard message roles used in large language model (LLM) conversations.
 package roles
 
+// Role represents a participant role in an LLM conversation.
+// Common roles include System, User, and Assistant, which correspond
+// to the standard roles supported by most LLM APIs.
 type Role string
 
+// Common LLM conversation roles.
 const (
-	System    Role = "system"
-	User      Role = "user"
+	// System defines instructions or context that guide the assistant's behavior.
+	System Role = "system"
+	// User represents a message from the human participant in the conversation.
+	User Role = "user"
+	// Assistant represents a message from the LLM in the conversation.
 	Assistant Role = "assistant"
 )