Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Add endpoint to create new Collectives

オープン 初心者向け
  • 何か問題がありますか？
#240 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
2/5
見積もり時間
1〜3時間
初心者へのやさしさ
70/100
issue の種類
機能追加
明瞭さ
明確に書かれている
活発さ
活発
技術スタック
python
領域
api, backend

調査の方向性

既存のツール ex_app/lib/all_tools/collectives.py を参照して、Collectives OCS エンドポイントを呼び出すパターンを確認してください。新しい create_collective ツールは、名前とオプションの絵文字を付けて /ocs/v2.php/apps/collectives/api/v1.0/collectives に POST リクエストを行う必要があります。Collectives アプリの appinfo/routes.php で正確なエンドポイント定義を確認してください。ツールがユーザーの確認を要求するようにしてください。エージェントを実行し、UI に新しいコレクティブが表示されることを確認してテストしてください。

索引モデルが issue の本文から書いたものです。

説明

enhancement
How to use GitHub
  • Please use the 👍 reaction to show that you are interested into the same feature.
  • Please don't comment if you have no relevant information to add. It's just extra noise for everyone subscribed to this issue.
  • Subscribe to receive notifications on status change and new comments.

Feature request

Which Nextcloud Version are you currently using: 34.0.4 (Context Agent 2.8.0, Collectives 4.6.1)

Is your feature request related to a problem? Please describe.

The Context Agent can't create a new collective, it can only work with the existing ones.

#159 added page tools in ex_app/lib/all_tools/collectives.py (list collectives, and create, edit, move and trash pages), but all of them need an existing collective_id. So a request like "create a collective for project X and add a few pages" can't be done from start to finish. A person has to create the collective in the UI first.

Describe the solution you'd like

Add a create_collective tool to collectives.py that wraps the Collectives OCS endpoint POST /ocs/v2.php/apps/collectives/api/v1.0/collectives (collective#create in the Collectives appinfo/routes.php). It should take a name and an optional emoji, and return the new collective's id.

Because creating a collective also creates a team (circle), the tool should probably be marked as needing user confirmation, like other tools that create shared resources.

Optional, maybe as a follow-up:

  • a way to give the collective's team to an existing group or team (e.g. through the existing circles tools), so the result can be shared right away
  • trash_collective, wrapping DELETE /collectives/{id}, with confirmation

Describe alternatives you've considered

  • Creating the collective by hand in the Collectives UI.
  • Having the agent write Markdown files into a normal shared folder. The result isn't a collective, so pages, backlinks and the Collectives UI don't apply.
  • Creating the collective directly on the filesystem. I tested this: create_folder("/.Collectives/Test Colectivo Demo") and upload_file(".../Readme.md") both returned {"status":"success"}. But the folder never showed up in .Collectives/, a PROPFIND on it returned 404 Not Found, and no new collective appeared in search. So the files tools report success for writes that are silently dropped, and the agent can't tell that nothing was created. That's probably worth a separate bug report.

Additional context

主要言語
Python
スター
26
フォーク
18
平均マージ
2日 1時間
マージ済み PR（30日）
5

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

nextcloud/context_agent のほかの issue

nextcloud/context_agent の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。