name: ai-agent-dev
description: Build production-ready AI agents, conversational interfaces, and MCP servers using OpenAI SDKs and modern agent patterns.
AI Agent Development
Instructions
Conversational Interfaces
- Build chat-based UIs using OpenAI ChatKit
- Support multi-turn conversations
- Handle user intent, context, and follow-ups
Agent Logic
- Implement AI behavior using OpenAI Agents SDK
- Design agent roles, goals, and constraints
- Manage reasoning, tool usage, and responses
MCP Server Development
- Create MCP servers using the Official MCP SDK
- Expose tools, resources, and prompts via MCP
- Follow Model Context Protocol specifications
State Management
- Design stateless chat endpoints
- Persist conversation state in databases
- Rehydrate context on each request
Tooling & Function Calling
- Design reusable agent tools
- Implement function calling patterns
- Validate inputs and outputs strictly
Natural Language Processing
- Interpret natural language commands
- Map user intent to agent actions
- Handle ambiguities and edge cases
Conversation Management
- Track conversation history and metadata
- Implement memory strategies (short-term vs long-term)
- Handle session lifecycle and resets
Best Practices
- Keep agents focused on a single responsibility
- Prefer stateless APIs with explicit state persistence
- Validate all tool inputs and outputs
- Design tools as composable, testable units
- Log agent decisions and tool calls for debugging
- Follow clean architecture: UI → Agent → Tools → Data
- Secure MCP servers and agent endpoints
Example Structure
// Agent definition
const agent = new Agent({
name: "SupportAgent",
instructions: "Help users by answering questions and calling tools when needed",
tools: [searchTool, databaseTool],
});
// Stateless chat endpoint
export async function chatHandler(request) {
const state = await loadConversationState(request.sessionId);
const response = await agent.run({
messages: state.messages,
input: request.userMessage,
});
await saveConversationState(request.sessionId, response.messages);
return response.output;
}
---
> Source: [muhammadyasir678/The-Evolution-of-Todo-app](https://github.com/muhammadyasir678/The-Evolution-of-Todo-app) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-16 -->
1---2name: muhammadyasir678-the-evolution-of-todo-app-ai-agent-dev3description: ---4---5---6name: ai-agent-dev7description: Build production-ready AI agents, conversational interfaces, and MCP servers using OpenAI SDKs and modern agent patterns.8---910# AI Agent Development1112## Instructions13141. **Conversational Interfaces**15 - Build chat-based UIs using OpenAI ChatKit16 - Support multi-turn conversations17 - Handle user intent, context, and follow-ups18192. **Agent Logic**20 - Implement AI behavior using OpenAI Agents SDK21 - Design agent roles, goals, and constraints22 - Manage reasoning, tool usage, and responses23243. **MCP Server Development**25 - Create MCP servers using the Official MCP SDK26 - Expose tools, resources, and prompts via MCP27 - Follow Model Context Protocol specifications28294. **State Management**30 - Design stateless chat endpoints31 - Persist conversation state in databases32 - Rehydrate context on each request33345. **Tooling & Function Calling**35 - Design reusable agent tools36 - Implement function calling patterns37 - Validate inputs and outputs strictly38396. **Natural Language Processing**40 - Interpret natural language commands41 - Map user intent to agent actions42 - Handle ambiguities and edge cases43447. **Conversation Management**45 - Track conversation history and metadata46 - Implement memory strategies (short-term vs long-term)47 - Handle session lifecycle and resets4849## Best Practices5051- Keep agents focused on a single responsibility52- Prefer stateless APIs with explicit state persistence53- Validate all tool inputs and outputs54- Design tools as composable, testable units55- Log agent decisions and tool calls for debugging56- Follow clean architecture: UI → Agent → Tools → Data57- Secure MCP servers and agent endpoints5859## Example Structure6061```ts62// Agent definition63const agent = new Agent({64 name: "SupportAgent",65 instructions: "Help users by answering questions and calling tools when needed",66 tools: [searchTool, databaseTool],67});6869// Stateless chat endpoint70export async function chatHandler(request) {71 const state = await loadConversationState(request.sessionId);7273 const response = await agent.run({74 messages: state.messages,75 input: request.userMessage,76 });7778 await saveConversationState(request.sessionId, response.messages);7980 return response.output;81}8283---84> Source: [muhammadyasir678/The-Evolution-of-Todo-app](https://github.com/muhammadyasir678/The-Evolution-of-Todo-app) — distributed by [TomeVault](https://tomevault.io).85<!-- tomevault:4.0:skill_md:2026-06-16 -->