# AI Agents

AI Agents classify incoming messages and contacts using a connected LLM. Agents have a prompt, an LLM configuration, and metrics about their classification accuracy.


## List AI Agents

 - [GET /flows/api/ai-agents](https://api.grinfi.io/openapi/ai-agents/listaiagents.md): Returns all AI agents in the team with their LLM configuration and metadata.

## Create an AI Agent

 - [POST /flows/api/ai-agents](https://api.grinfi.io/openapi/ai-agents/createaiagent.md): Create a new AI agent that will use the configured LLM for classification and similar tasks. Requires a connected LLM (classification_llm_uuid).

## Get an AI Agent

 - [GET /flows/api/ai-agents/{uuid}](https://api.grinfi.io/openapi/ai-agents/getaiagent.md): Retrieve a single AI agent by UUID.

## Update an AI Agent

 - [PUT /flows/api/ai-agents/{uuid}](https://api.grinfi.io/openapi/ai-agents/updateaiagent.md): Update fields on an existing AI agent. Only the supplied fields are changed.

## Delete an AI Agent

 - [DELETE /flows/api/ai-agents/{uuid}](https://api.grinfi.io/openapi/ai-agents/deleteaiagent.md): Permanently delete an AI agent. Cannot be undone.