Using Personal Connectors

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude

# Create assistant with connector access
assistant = freddy.assistants.create(
    name="Connected Assistant",
    instructions="""You have access to my personal connectors. Use them to:

    - Search my Notion workspace for relevant information
    - Send emails through Gmail when requested
    - Access my Google Calendar for scheduling
    - Query my personal database for data

    Always ask for clarification if a request is ambiguous.""",
    model="gpt-4",
    tools=[
        # Connector functions are automatically available
        # based on your configurations
    ]
)

# Example conversation
message = freddy.threads.messages.create(
    thread_id=thread.id,
    role="user",
    content="Can you check my Notion workspace for project ideas?"
)

# The assistant will automatically:
# 1. Recognize this requires the Notion connector
# 2. Call the appropriate connector function
# 3. Format and return the results

instructions = """
You can access multiple services:

1. Use Notion to research and gather information
2. Use Gmail to send follow-up emails
3. Use Google Calendar to schedule meetings
4. Use Slack to share updates with the team

When a user requests a complex task, break it down into steps using these tools.
"""

# In your assistant's error handling strategy
"""
If a connector fails:
1. Inform the user about the issue
2. Suggest alternatives if available
3. Offer to retry or use a different approach
4. Escalate to human support if needed

Always be transparent about what went wrong and what you're doing to fix it.
"""

# Research assistant that uses multiple connectors
research_assistant = freddy.assistants.create(
    name="Research Assistant",
    instructions="""You are a research assistant with access to:

    - Notion workspace for note-taking and research storage
    - Web search for current information
    - Gmail for communicating findings
    - Google Drive for document storage

    Research Process:
    1. Search for information using available tools
    2. Organize findings in Notion
    3. Summarize key insights
    4. Share results via email or document""",
    model="gpt-4"
)

# Project management assistant
project_assistant = freddy.assistants.create(
    name="Project Manager",
    instructions="""You help manage projects using:

    - Notion for task and project tracking
    - Google Calendar for scheduling
    - Slack for team communication
    - Linear for issue tracking

    Always keep project information synchronized across all platforms.""",
    model="gpt-4"
)

# Access connector logs
logs = freddy.personal_connectors.get_logs(
    configuration_id="config_123",
    start_date="2024-01-01",
    end_date="2024-01-31"
)

for log in logs:
    print(f"Function: {log.function_name}")
    print(f"Status: {log.status}")
    print(f"Duration: {log.duration_ms}ms")

def comprehensive_research(query: str) -> Dict:
    """Perform comprehensive research using multiple connectors."""

    results = {
        "web_search": web_search_connector.search(query),
        "notion_search": notion_connector.search(query),
        "document_search": drive_connector.search(query)
    }

    # Combine and rank results
    combined_results = combine_search_results(results)

    return {
        "query": query,
        "results": combined_results,
        "sources_used": list(results.keys())
    }

# Example: Email-triggered workflow
"""
When a new email arrives in Gmail:
1. Analyze the email content
2. Search for related information in Notion
3. Create a task in your project management tool
4. Send a notification via Slack
"""