Create an agent

Create a project agent, define its instructions, and add the tools and skills it needs.

Steps

  1. Create the agent definition.
  2. Add instructions, tools, and skills for its task.
  3. Inspect the definition before starting a run.
  4. Attach a conversation to the run when the agent needs chat history.

Try it with REST

Create a minimal agent:

POST /projects/{project_reference}/agents

bash
curl -X POST https://api.veryfront.com/projects/support-assistant/agents \
  -H "Authorization: Bearer $VERYFRONT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "triage-agent",
    "name": "Triage agent",
    "system_prompt": "Classify incoming support requests and suggest the next action."
  }'

Verify

List agents for the project and confirm triage-agent exists.

Open its source and check the instructions and attached capabilities before running it.

For catalog discovery and installation fields, see Agent catalog identity.

Agent resources

ResourceUse it for
AgentRuntime behavior and execution entry point.
PromptInstructions and reusable prompt text.
ToolCallable project or integration action.
SkillPackaged behavior an agent can use.
ConversationDurable chat state and agent runs.

API reference