Build a New Project

​

Overview

In this tutorial, you’ll build a News Aggregator Project that collects articles from multiple sources, summarizes them, and outputs a daily digest. You’ll learn to:

• Create a Project from scratch
• Build Actions for data collection
• Design Flows for orchestration
• Configure an Agent for summarization
• Test and deploy your system

Time required: 20-30 minutes

​

Step 1: Create the Project

1. Click the Home icon in the Top Bar
2. Click New Project
3. Name it News Aggregator
4. Add description: Collects and summarizes news from multiple sources
5. Click Create

Your Canvas now shows an empty Project node.

​

Step 2: Build the fetch Action

Let’s create an Action to fetch news from an API:

1. Open the Chat Panel
2. Say: “Create an Action called fetch_news that takes a source URL and returns a list of articles”
3. Triton will generate the Action with:
   • Input: source_url (string)
   • Output: articles (list of dicts)
   • Basic HTTP request logic
4. Review the generated Action.py in the Properties Panel
5. Adjust if needed (add error handling, rate limiting, etc.)

​

Step 3: Create the aggregation Flow

Now build a Flow to call the Action for multiple sources:

1. Ask Triton: “Create a Flow that takes a list of news sources and calls fetch_news for each one”
2. Triton will create:
   • Input node with sources parameter
   • Loop or parallel execution of fetch_news
   • Output node with combined articles
3. Double-click the Flow node to inspect the structure
4. Verify the connections are correct

​

Step 4: Add a summarization Agent

Create an Agent to summarize the collected articles:

1. Say: “Create an Agent called news_summarizer that takes articles and creates a concise daily digest”
2. Triton will configure:
   • System prompt for summarization
   • Input/output schema
   • Model selection (GPT-4 or Claude recommended)
3. Review and refine the system prompt:
   You are a news summarization expert. Given a list of news articles,
   create a concise, informative daily digest. Group by topic, highlight
   key trends, and maintain neutral tone. Output as structured markdown.
   

​

Step 5: Connect the components

Wire everything together:

1. Create a main Flow called daily_news_digest
2. Structure it as:
   Input (sources list)
     → fetch_news_flow (aggregation)
     → news_summarizer (Agent)
     → Output (formatted digest)
   
3. You can do this via Triton or manually:
   • Drag components from the Agent Toolbox
   • Connect them with edges (click and drag from output to input ports)
   • Configure each node’s parameters

​

Step 6: Test with sample data

Execute your system:

1. Select the daily_news_digest Flow
2. Open Properties → Execute
3. Enter test payload:
   {
     "sources": [
       "https://newsapi.org/v2/top-headlines?country=us",
       "https://api.example.com/tech-news",
       "https://api.example.com/world-news"
     ]
   }
   
4. Click Execute
5. Monitor execution in real-time
6. Review the output digest

​

Step 7: Debug and iterate

If something goes wrong:

• Check execution logs in Properties → Executions
• Verify each component’s input/output schema
• Test Actions individually before running the full Flow
• Ask Triton: “Why did the execution fail?”

Common issues:

• API authentication missing → Add API keys to Global Variables
• Timeout errors → Adjust Action timeout settings
• Empty results → Verify API endpoints are accessible

​

Step 8: Deploy as API

Make your Project accessible:

1. Click Deploy in the Top Bar
2. Select deployment target (e.g., production)
3. Configure:
   • Endpoint path: /daily-digest
   • HTTP method: POST
   • Authentication: API key required
4. Click Deploy Now
5. Copy the generated endpoint URL
6. Test with curl:
   curl -X POST https://api.triform.ai/v1/your-project/daily-digest \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"sources": ["..."]}'
   

​

Step 9: Schedule daily execution

Set up automatic runs:

1. In the Project Properties, go to Triggers
2. Click Add Trigger
3. Select Schedule
4. Configure:
   • Schedule: Daily at 6:00 AM UTC
   • Payload: Your default sources list
   • Notification: Email on success/failure
5. Save the trigger

​

Next steps

Now that you’ve built a complete Project:

• Enhance it — Add sentiment analysis, language detection, custom formatting
• Monitor it — Set up alerts for failures or anomalies
• Share it — Invite team members to collaborate
• Extend it — Create variations for different news categories

​

Tips for success

Start simple — Build and test each component individually before connecting them

Use Project Variables — Store API keys, base URLs, and configuration centrally

Save test payloads — Keep example inputs for regression testing

Version your work — Use meaningful names and descriptions for components

Iterate with Triton — Don’t hesitate to ask for modifications or explanations