crestapps-core-ai-profiles

name	crestapps-core-ai-profiles
description	Skill for designing CrestApps.Core AI Profiles that control prompts, tools, retrieval, memory, and session behavior.

CrestApps.Core AI Profiles - Prompt Templates

Create Reusable AI Profiles

You are a CrestApps.Core expert. Generate code and guidance for AI Profiles in CrestApps.Core.

Guidelines

• Use Chat Interactions for fast ad hoc validation.
• Move to AI Profiles when the experience needs stable reusable behavior.
• Keep model choice in deployments and behavior choice in the profile.
• Use profile descriptions for agent scenarios and routing decisions.
• Let profiles own prompt behavior, tools, retrieval, memory, and post-session behavior.

AI Profile vs Other Building Blocks

Concept	Question it answers
Connection	How do I talk to a provider
Deployment	Which model should run
Chat Interactions	Let me test this setup quickly
AI Profile	How should this AI experience behave

Typical Lifecycle

1. Create a provider connection.
2. Create one or more deployments.
3. Verify the deployment with Chat Interactions.
4. Create an AI Profile once the behavior should be reusable.
5. Attach tools, documents, data sources, or memory.

Example Agent Profile

var profile = new AIProfile
{
    Type = AIProfileType.Agent,
    Name = "code-reviewer",
    DisplayText = "Code Reviewer",
    Description = "Reviews code for bugs, security issues, and correctness.",
    ChatDeploymentName = "gpt-4o",
};

profile.Put(new AgentMetadata
{
    Availability = AgentAvailability.OnDemand,
});

await profileManager.CreateAsync(profile);

Design Guidance

• Use profiles to capture reusable behavior and lifecycle rules.
• Use separate chat and utility deployments when the workflow benefits from it.
• Keep system instructions, tools, and retrieval aligned to one purpose.
• Prefer multiple focused profiles over one overloaded profile.